Класс QMagnetometerReading

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

Заголовок:	#include <QMagnetometerReading>
qmake:	QT += sensors
С момента:	Qt 5.1
Наследует:	QSensorReading

Этот класс был представлен в Qt 5.1.

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

Свойства

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

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

qreal	calibrationLevel() const
void	setCalibrationLevel(qreal calibrationLevel)
void	setX(qreal x)
void	setY(qreal y)
void	setZ(qreal z)
qreal	x() const
qreal	y() const
qreal	z() const

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

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

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

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

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

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

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

Калибровка

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

Документация по свойствам

calibrationLevel : const qreal

Это свойство содержит точность измерения.

Измеряется как значение от 0 до 1, причём большие значения соответствуют лучшей точности.

Обратите внимание, что это значение меняется только при измерении плотности геомагнитного потока. Значения исходного магнитного потока всегда будут иметь значение 1.

Функции доступа:

qreal calibrationLevel() const

См. также Единицы измерения QMagnetometerReading и Калибровка.

x : const qreal

Это свойство содержит плотность исходного магнитного потока по оси X.

Измеряется в теслах.

Функции доступа:

qreal x() const

См. также Единицы измерения QMagnetometerReading.

y : const qreal

Это свойство содержит плотность исходного магнитного потока по оси Y.

Измеряется в теслах.

Функции доступа:

qreal y() const

См. также Единицы измерения QMagnetometerReading.

z : const qreal

Это свойство содержит плотность исходного магнитного потока по оси Z.

Измеряется в теслах.

Функции доступа:

qreal z() const

См. также Единицы измерения QMagnetometerReading.

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

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qmagnetometerreading.html