Класс QMagnetometerReading

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

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

Свойства

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

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

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

Переопределенные открытые функции

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

Статические открытые члены

• 9 статических открытых членов унаследованы от QObject

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

• 1 открытый слот унаследован от QObject
• 2 сигнала унаследованы от QObject
• 9 защищенных функций унаследованы от 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().