Класс QMagnetometerReading

Класс QMagnetometerReading представляет одно измерение магнитометром. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• calibrationLevel : const qreal
• x : const qreal
• y : const qreal
• z : const qreal

• 1 свойство унаследовано от QSensorReading
• 1 свойство унаследовано от QObject

Открытые функции

• 4 открытых функции унаследованы от QSensorReading
• 31 открытых функция унаследованы от QObject

Дополнительные унаследованные члены

• 1 открытый слот унаследован от QObject
• 2 сигналы унаследованы от QObject
• 11 статические открытые члены унаследованы от QObject
• 9 защищенные функции унаследованы от QObject

Подробное описание

Класс QMagnetometerReading представляет одно измерение магнитометром.

Единицы измерения QMagnetometerReading

Магнитометр возвращает значения магнитной индукции по 3 осям. Масштаб значений — тесла. Оси расположены следующим образом.

Магнитометр может сообщать либо о значениях сырой магнитной индукции, либо о значениях геомагнитной индукции. По умолчанию возвращаются значения сырой магнитной индукции. Для возвращения значений геомагнитной индукции необходимо установить свойство QMagnetometer::returnGeoValues.

Основное различие между сырыми и геомагнитными значениями заключается в том, что для геомагнитных значений выполняется дополнительная обработка для устранения локальных магнитных помех, поэтому они представляют только влияние магнитного поля Земли. Этот процесс не идеален, и точность каждого измерения может меняться.

На рисунке ниже показано различие между геомагнитными (слева) и сырыми (справа) измерениями для телефона, подвергающегося магнитным помехам.

Точность каждого измерения измеряется числом от 0 до 1. Значение 1 соответствует наивысшему уровню, который может поддерживать устройство, а 0 — наихудшему.

Калибровка

Если устройство сообщает о низкой точности, то для получения приемлемых измерений может потребоваться калибровка. Обычно базовая калибровка выполняется путем вращения устройства восьмеркой или путем вращения устройства вокруг каждой из трех осей. Дополнительную информацию можно найти в документации вашего устройства о калибровке датчика магнитного поля.

Документация по функциям-членам

void QMagnetometerReading::setCalibrationLevel(qreal calibrationLevel)

Устанавливает точность измерения в calibrationLevel.

См. также calibrationLevel().

void QMagnetometerReading::setX(qreal x)

Устанавливает сырое значение магнитной индукции по оси X в x.

См. также x().

void QMagnetometerReading::setY(qreal y)

Устанавливает сырое значение магнитной индукции по оси Y в y.

См. также y().

void QMagnetometerReading::setZ(qreal z)

Устанавливает сырое значение магнитной индукции по оси Z в z.

См. также z().