QAccelerometer Class

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

Header:	#include <QAccelerometer>
CMake:	find_package(Qt6 COMPONENTS Sensors REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake:	QT += sensors
Since:	Qt 5.1
Inherits:	QSensor

• List of all members, including inherited members

Public Types

enum	AccelerationMode { Combined, Gravity, User }

Properties

• accelerationMode : AccelerationMode

Public Functions

	QAccelerometer(QObject *parent = nullptr)
virtual	~QAccelerometer()
QAccelerometer::AccelerationMode	accelerationMode() const
QAccelerometerReading *	reading() const
void	setAccelerationMode(QAccelerometer::AccelerationMode accelerationMode)

Signals

void	accelerationModeChanged(QAccelerometer::AccelerationMode accelerationMode)

Detailed Description

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

[since 5.1] 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.

Constant	Value	Description
QAccelerometer::Combined	0	Both the acceleration caused by gravity and the acceleration caused by the user moving the device is reported combined.
QAccelerometer::Gravity	1	Only 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::User	2	Only 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.

Member Function Documentation

QAccelerometer::QAccelerometer(QObject *parent = nullptr)

Construct the sensor as a child of parent.

[signal, since 5.1] void QAccelerometer::accelerationModeChanged(QAccelerometer::AccelerationMode accelerationMode)

Emitted when the accelerationMode was changed.

Note: Notifier signal for property accelerationMode.

This function was introduced in Qt 5.1.

[virtual] QAccelerometer::~QAccelerometer()

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

QAccelerometerReading *QAccelerometer::reading() const

Returns the reading class for this sensor.

See also QSensor::reading().

[since 5.1] void QAccelerometer::setAccelerationMode(QAccelerometer::AccelerationMode accelerationMode)

Sets the acceleration mode to accelerationMode.

Note: Setter function for property accelerationMode.

This function was introduced in Qt 5.1.

See also accelerationMode().