--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/camerauis/cameraxui/cxengine/src/sensor/xqdeviceorientation.cpp	Tue Aug 31 15:03:46 2010 +0300
@@ -0,0 +1,182 @@
+/*
+* 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 "xqdeviceorientation.h"
+#include "xqdeviceorientation_p.h"
+
+/*!
+    \class XQDeviceOrientation
+
+    \brief The XQDeviceOrientation class is used to determine the orientation
+    of the device.
+
+    Note that the orientation is calculated from the values received from
+    acceleration sensor so the orientation is reliable only when the speed of
+    the device is constant.
+    
+    Example:
+    \code
+    XQDeviceOrientation* orientation = new XQDeviceOrientation(this);
+    orientation->setResolution(5);  //degrees
+    QObject::connect(
+        orientation, SIGNAL(orientationChanged(XQDeviceOrientation::DisplayOrientation)),
+        this, SLOT(updateOrientation(XQDeviceOrientation::DisplayOrientation)));
+    int xRotation = orientation->xRotation();
+    \endcode
+*/
+
+/*!
+    \enum XQDeviceOrientation::DisplayOrientation
+
+    This enum defines the possible orientations of the device.
+*/
+
+/*! \var XQDeviceOrientation::DisplayOrientation XQDeviceOrientation::OrientationUndefined
+    The orientation can't be determined.
+*/
+
+/*! \var XQDeviceOrientation::DisplayOrientation XQDeviceOrientation::OrientationDisplayUp
+    The orientation of the device is up, i.e. standing.
+*/
+
+/*! \var XQDeviceOrientation::DisplayOrientation XQDeviceOrientation::OrientationDisplayDown
+    The device is upside down, i.e. bottom up.
+*/
+
+/*! \var XQDeviceOrientation::DisplayOrientation XQDeviceOrientation::OrientationDisplayLeftUp
+    The left side of the device is up.
+*/
+
+/*! \var XQDeviceOrientation::DisplayOrientation XQDeviceOrientation::OrientationDisplayRightUp
+    The right side of the device is up.
+*/
+
+/*! \var XQDeviceOrientation::DisplayOrientation XQDeviceOrientation::OrientationDisplayUpwards
+    The device is laying on its back.
+*/
+
+/*! \var XQDeviceOrientation::DisplayOrientation XQDeviceOrientation::OrientationDisplayDownwards
+    The device is laying on its face.
+*/
+
+
+/*!
+    Constructs a XQDeviceOrientation object with the given parent
+*/
+XQDeviceOrientation::XQDeviceOrientation(QObject* parent):
+    QObject(parent),
+    d(new XQDeviceOrientationPrivate(*this))
+{
+}
+
+/*!
+    Destroys the XQDeviceOrientation, deleting all its children.
+*/
+XQDeviceOrientation::~XQDeviceOrientation()
+{
+}
+
+/*!
+    Opens sensor connection
+*/
+void XQDeviceOrientation::open()
+{
+    d->open();
+}
+
+/*!
+    Closes sensor connection
+*/
+void XQDeviceOrientation::close()
+{
+    d->close();
+}
+
+/*!
+    Sets the rounding resolution of the rotation angles. For example, say
+    the resolution is set to 10 degrees; if the raw angle is 109 degrees, then
+    110 degrees will be reported, if the raw angle is 93 degrees, then 90 degrees
+    will be reported.
+    
+    Note: If this function is not called, the
+    default rounding resolution of 15 degrees is used.
+    
+    
+    \param resolution Resolution in degrees.
+*/
+void XQDeviceOrientation::setResolution(int resolution)
+{
+    d->setResolution(resolution);
+}
+
+/*!
+    \return Current rotation esolution in degrees
+*/
+int XQDeviceOrientation::resolution() const
+{
+    return d->resolution();
+}
+
+/*!
+    \return X-axis rotation in degrees (0-359).
+*/
+int XQDeviceOrientation::xRotation() const
+{
+    return d->xRotation();
+}
+
+/*!
+    \return Y-axis rotation in degrees (0-359).
+*/
+int XQDeviceOrientation::yRotation() const
+{
+    return d->yRotation();
+}
+
+/*!
+    \return Z-axis rotation in degrees (0-359).
+*/
+int XQDeviceOrientation::zRotation() const
+{
+    return d->zRotation();
+}
+
+/*!
+    \return Current device orientation
+*/
+XQDeviceOrientation::DisplayOrientation XQDeviceOrientation::orientation() const
+{
+    return d->orientation();
+}
+
+/*!
+    \fn void XQDeviceOrientation::rotationChanged(int xRotation, int yRotation, int zRotation);
+    
+    This signal is emitted when the angle of rotation of the device has changed.
+
+    \param xRotation Rotation of x axis in degrees (0-359).
+    \param yRotation Rotation of y axis in degrees (0-359).
+    \param zRotation Rotation of z axis in degrees (0-359).
+*/
+
+/*!
+    \fn void XQDeviceOrientation::orientationChanged(XQDeviceOrientation::DisplayOrientation orientation);
+    
+    This signal is emitted when the orientation of the device has changed.
+
+    \param orientation Current orientation
+    \sa setResolution()
+*/