QAccelerometer Class

The QAccelerometer class is a convenience wrapper around QSensor. More...

Header: #include <QAccelerometer>
qmake: QT += sensors
Since: Qt 5.1
Inherits: QSensor

Public Types

enum AccelerationMode { Combined, Gravity, User }

Properties

  • 20 properties inherited from QSensor
  • 1 property inherited from QObject

Public Functions

QAccelerometer(QObject *parent = Q_NULLPTR)
virtual ~QAccelerometer()
AccelerationMode accelerationMode() const
QAccelerometerReading *reading() const
void setAccelerationMode(AccelerationMode accelerationMode)
  • 37 public functions inherited from QSensor
  • 31 public functions inherited from QObject

Signals

void accelerationModeChanged(AccelerationMode accelerationMode)

Additional Inherited Members

  • 2 public slots inherited from QSensor
  • 1 public slot inherited from QObject
  • 1 public variable inherited from QObject
  • 3 static public members inherited from QSensor
  • 10 static public members inherited from QObject
  • 9 protected functions inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QAccelerometer class is a convenience wrapper around QSensor.

The only behavioural difference is that this class sets the type properly.

It also supports changing the acceleration mode, which controls whether the force of gravity is included in the accelerometer values or not.

Furthermore, this class features a reading() function that returns a QAccelerometerReading instead of a QSensorReading.

For details about how the sensor works, see QAccelerometerReading.

See also QAccelerometerReading.

Member Type Documentation

enum QAccelerometer::AccelerationMode

This enum represents the acceleration mode of an acceleration sensor.

The acceleration mode controls how the sensor reports acceleration. QAccelerometer::Combined is the only mode in which the values can be directly physically measured, the others are an approximation.

ConstantValueDescription
QAccelerometer::Combined0Both the acceleration caused by gravity and the acceleration caused by the user moving the device is reported combined.
QAccelerometer::Gravity1Only the acceleration caused by gravity is reported. Movements of the device caused by the user have no effect other than changing the direction when the device is rotated.
QAccelerometer::User2Only the acceleration caused by the user moving the device is reported, the effect of gravity is canceled out. A device at rest therefore should report values of, or close to, zero. In other APIs, this mode might be known as linear acceleration.

This enum was introduced or modified in Qt 5.1.

See also QAccelerometer::accelerationMode.

Property Documentation

accelerationMode : AccelerationMode

This property holds the acceleration mode controls how acceleration values are reported.

The acceleration mode controls how the acceleration sensor reports its values. The default mode is QAccelerometer::Combined, which means the acceleration caused by gravity is included in the reported values.

Acceleration caused by gravity and acceleration caused by the user moving the device are physically impossible to distinguish because of general relativity. Most devices use sensor fusion to figure out which parts of the acceleration is caused by gravity, for example by using a rotation sensor to calculate the gravity direction and assuming a fixed magnitude for gravity. Therefore the result is only an approximation and may be inaccurate. The QAccelerometer::Combined mode is the most accurate one, as it does not involve approximating the gravity.

Not all backends and devices might support setting the acceleration mode. For those cases, the default mode QAccelerometer::Combined is used, changing it has no effect.

This property was introduced in Qt 5.1.

Access functions:

AccelerationMode accelerationMode() const
void setAccelerationMode(AccelerationMode accelerationMode)

Notifier signal:

void accelerationModeChanged(AccelerationMode accelerationMode)

Member Function Documentation

QAccelerometer::QAccelerometer(QObject *parent = Q_NULLPTR)

Construct the sensor as a child of parent.

[virtual] QAccelerometer::~QAccelerometer()

Destroy the sensor. Stops the sensor if it has not already been stopped.

[signal] void QAccelerometer::accelerationModeChanged(AccelerationMode accelerationMode)

Emitted when the acceleration mode was changed.

This function was introduced in Qt 5.1.

Note: Notifier signal for property accelerationMode.

QAccelerometerReading *QAccelerometer::reading() const

Returns the reading class for this sensor.

See also QSensor::reading().

void QAccelerometer::setAccelerationMode(AccelerationMode accelerationMode)

Sets the acceleration mode to accelerationMode.

This function was introduced in Qt 5.1.

Note: Setter function for property accelerationMode.

See also accelerationMode().