QCompassReading Class

The QCompassReading class represents one reading from a compass. More...

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

• List of all members, including inherited members

Properties

• azimuth : const qreal
• calibrationLevel : const qreal

Public Functions

qreal	azimuth() const
qreal	calibrationLevel() const
void	setAzimuth(qreal azimuth)
void	setCalibrationLevel(qreal calibrationLevel)

Detailed Description

QCompassReading Units

The compass returns the azimuth of the device as degrees from magnetic north in a clockwise direction based on the top of the device, as defined by QScreen::nativeOrientation. There is also a value to indicate the calibration status of the device. If the device is not calibrated the azimuth may not be accurate.

Digital compasses are susceptible to magnetic interference and may need calibration after being placed near anything that emits a magnetic force. Accuracy of the compass can be affected by any ferrous materials that are nearby.

The calibration status of the device is measured as a number from 0 to 1. A value of 1 is the highest level that the device can support and 0 is the worst.

Member Function Documentation

void QCompassReading::setAzimuth(qreal azimuth)

Sets the azimuth of the device.

See also azimuth() and QCompassReading Units.

void QCompassReading::setCalibrationLevel(qreal calibrationLevel)

Sets the calibration level of the reading to calibrationLevel.

See also calibrationLevel().