QAccelerometer#
The QAccelerometer
class is a convenience wrapper around QSensor
. More…
Synopsis#
Properties#
accelerationMode
- Acceleration mode controls how acceleration values are reported
Functions#
def
accelerationMode
()def
setAccelerationMode
(accelerationMode)
Signals#
def
accelerationModeChanged
(accelerationMode)
Note
This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE
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
- class PySide6.QtSensors.QAccelerometer([parent=None])#
- Parameters:
parent –
PySide6.QtCore.QObject
Construct the sensor as a child of parent
.
Note
Properties can be used directly when from __feature__ import true_property
is used or via accessor functions otherwise.
- property PᅟySide6.QtSensors.QAccelerometer.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 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 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 Combined
is used, changing it has no effect.
- Access functions:
setAccelerationMode
(accelerationMode)Signal
accelerationModeChanged
(accelerationMode)
- PySide6.QtSensors.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
Description
QAccelerometer.Combined
Both the acceleration caused by gravity and the acceleration caused by the user moving the device is reported combined.
QAccelerometer.Gravity
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
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.
See also
- PySide6.QtSensors.QAccelerometer.sensorType#
- PySide6.QtSensors.QAccelerometer.accelerationMode()#
- Return type:
See also
Getter of property accelerationMode
.
- PySide6.QtSensors.QAccelerometer.accelerationModeChanged(accelerationMode)#
- Parameters:
accelerationMode –
AccelerationMode
Emitted when the accelerationMode
was changed.
Notification signal of property accelerationMode
.
- PySide6.QtSensors.QAccelerometer.setAccelerationMode(accelerationMode)#
- Parameters:
accelerationMode –
AccelerationMode
Sets the acceleration mode to accelerationMode
.
See also
Setter of property accelerationMode
.