Класс QMagnetometerReading

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

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

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

Свойства

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

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

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

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

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

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

1 открытый слот унаследованный от QObject
2 сигналы унаследованные от QObject
11 статических открытых членов унаследованные от QObject
9 защищённых функций унаследованные от QObject

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

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

Единицы измерения 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.9/qmagnetometerreading.html