Класс 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.13/qmagnetometerreading.html