diff -r 61bc0f252b2b -r bac7acad7cb3 camerauis/cameraxui/cxengine/src/sensor/xqdeviceorientation.cpp --- a/camerauis/cameraxui/cxengine/src/sensor/xqdeviceorientation.cpp Tue Aug 31 15:03:46 2010 +0300 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,182 +0,0 @@ -/* -* 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() -*/