Класс 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

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

Магнитометр может сообщать как о значениях исходного магнитного потока, так и о геомагнитных значениях. По умолчанию он возвращает значения исходного магнитного потока. Для возвращения геомагнитных значений необходимо установить свойство 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.15/qmagnetometerreading.html