--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/camerauis/cameraxui/cxengine/src/sensor/xqaccsensor.cpp Fri Apr 16 14:51:30 2010 +0300
@@ -0,0 +1,158 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+#include "xqaccsensor.h"
+#include "xqaccsensor_p.h"
+
+/*!
+ \class XQAccelerationSensor
+
+ \brief The XQAccelerationSensor class is used to determine current
+ acceleration of the device.
+
+ Note that the orientation of the device affects on the acceleration sensors
+ due to acceleration caused by Earth's gravity. Therefore it is wrong to
+ assume that the axis values are zero when the device stands still.
+
+ XQAccelerationSensor axis data shouldn't be directly used to determine the
+ device orientation, though. It may sound good to use XQAccelerationSensor
+ in a game that is controlled by leaning the device but the data ranges and
+ even axis orientation may differ highly in different devices. Instead, use
+ the XQDeviceOrientation class for that purpose.
+
+ Example:
+ \code
+ #include "XQAccSensor.h"
+ class MyAccelerationFilter : public QObject,
+ public XQAbstractAccelerationSensorFilter
+ {
+ Q_OBJECT
+ protected: //from XQAbstractAccelerationSensorFilter
+ bool filter(int& xAcceleration, int& yAcceleration, int& zAcceleration);
+ private:
+ int m_xAcceleration;
+ };
+
+ bool MyAccelerationFilter::filter(int& xAcceleration,
+ int& yAcceleration, int& zAcceleration)
+ {
+ zAcceleration = 0; //Suppress z axis acceleration
+ m_xAcceleration = xAcceleration; //Save for further use
+ return false; //Allow next filter to be called
+ }
+
+ XQAccelerationSensor* sensor = new XQAccelerationSensor(this);
+ sensor->open();
+
+ MyAccelerationFilter* filter = new MyAccelerationFilter(this);
+ sensor->addFilter(*filter);
+
+ sensor->startReceiving();
+ \endcode
+*/
+
+/*!
+ Constructs a XQAccelerationSensor object with parent \a parent.
+ \sa open(), startReceiving()
+*/
+XQAccelerationSensor::XQAccelerationSensor(QObject* parent):
+ XQSensor(*new XQAccelerationSensorPrivate(*this), parent)
+{
+}
+
+/*!
+ Destroys the XQAccelerationSensor, deleting all its children.
+*/
+XQAccelerationSensor::~XQAccelerationSensor()
+{
+}
+
+/*!
+ Adds the given filter to the top of filter stack.
+*/
+void XQAccelerationSensor::addFilter(XQAbstractAccelerationSensorFilter& filter)
+{
+ static_cast<XQAccelerationSensorPrivate*>(d)->addFilter(filter);
+}
+
+
+/*!
+ \return The list of filters that are on the stack
+*/
+QList<XQAbstractAccelerationSensorFilter*>& XQAccelerationSensor::filters()
+{
+ return static_cast<XQAccelerationSensorPrivate*>(d)->filters();
+}
+
+/*!
+ \return Raw x-axis acceleration data
+*/
+int XQAccelerationSensor::xAcceleration() const
+{
+ return static_cast<XQAccelerationSensorPrivate*>(d)->xAcceleration();
+}
+
+/*!
+ \return Raw y-axis acceleration data
+*/
+int XQAccelerationSensor::yAcceleration() const
+{
+ return static_cast<XQAccelerationSensorPrivate*>(d)->yAcceleration();
+}
+
+/*!
+ \return Raw z-axis acceleration data
+*/
+int XQAccelerationSensor::zAcceleration() const
+{
+ return static_cast<XQAccelerationSensorPrivate*>(d)->zAcceleration();
+}
+
+/*!
+ \class XQAbstractAccelerationSensorFilter
+
+ \brief The XQAbstractAccelerationSensorFilter is an interface that can be
+ used to filter and/or manipulate data received from the acceleration sensor.
+
+ The client which is interested in sensor events implements this interface.
+
+ There may potentially be several filters in stack. They are called in
+ reverse order (i.e. the last filter added to the stack is always called first).
+ Each filter may manipulate the acceleration data and also allow or deny the next filter in
+ stack to be called.
+*/
+
+/*!
+ \fn virtual bool XQAbstractAccelerationSensorFilter::filter(int& xAcceleration, int& yAcceleration, int& zAcceleration) = 0;
+
+ This function is called when the acceleration of the device changes.
+
+ \param xAcceleration Reference to x-axis acceleration value
+ \param yAcceleration Reference to y-axis acceleration value
+ \param zAcceleration Reference to z-axis acceleration value
+ \return True if this filter has "filtered out" the event, i.e. the event
+ is not to be sent to the next filter in the stack. Returning false allows the next
+ filter in the stack to be called.
+ \sa XQSensor::startReceiving()
+*/
+
+/*!
+ \class XQAccelerationDataPostFilter
+
+ \brief The XQAccelerationDataPostFilter is a special acceleration sensor
+ filter. It modifies the acceleration sensor data so that the orientation of each
+ acceleration axis is the same for all devices.
+*/