Класс QMagnetometerReading

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

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

Свойства

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

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

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

Реализованные открытые функции

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

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

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

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

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

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

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

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

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

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

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

Калибровка

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

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

QMagnetometerReading::QMagnetometerReading(QObject *parent = DECLARE_READING(QMagnetometerReading))

Инициализирует экземпляр QMagnetometerReading.

[virtual] QMagnetometerReading::~QMagnetometerReading()

Удаляет экземпляр QMagnetometerReading. Деструктор является виртуальным.

[override virtual] void QMagnetometerReading::copyValuesFrom(QSensorReading *other)

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().