Класс QMagnetometerReading
Класс QMagnetometerReading представляет собой одно измерение магнитометра. Подробнее...
| Заголовок: | #include <QMagnetometerReading> |
| CMake: | find_package(Qt6 COMPONENTS Sensors REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake: | QT += sensors |
| С: | Qt 5.1 |
| Наследует: | QSensorReading |
Свойства
- 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 — наихудшему.
Калибровка
Если устройство сообщает о низкой точности, может потребоваться калибровка перед предоставлением приемлемых измерений. Базовая калибровка обычно выполняется путём вращения устройства по фигуре восьмёрки или вращения его вокруг каждой из трёх осей. Дополнительную информацию см. в документации к устройству по калибровке датчика магнитного поля.
Документация по свойствам
[read-only] calibrationLevel : const qreal
Это свойство содержит точность измерения.
Измеряется как значение от 0 до 1, где более высокие значения означают лучшую точность.
Обратите внимание, что это свойство изменяется только при измерении геомагнитной напряжённости. Исходные значения магнитной индукции всегда будут иметь значение 1.
Функции доступа:
| qreal | calibrationLevel() const |
См. также Единицы измерения QMagnetometerReading и Калибровка.
[read-only] x : const qreal
Это свойство содержит значение исходной напряжённости магнитного поля по оси X.
Измеряется в теслах.
Функции доступа:
| qreal | x() const |
См. также Единицы измерения QMagnetometerReading.
[read-only] y : const qreal
Это свойство содержит значение исходной напряжённости магнитного поля по оси Y.
Измеряется в теслах.
Функции доступа:
| qreal | y() const |
См. также Единицы измерения QMagnetometerReading.
[read-only] 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-6.2/qmagnetometerreading.html
