QMagnetometerReading 类
QMagnetometerReading 类表示磁力计的一次读取。 更多...
| 头文件 | #include <QMagnetometerReading> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Sensors) target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake | QT += sensors |
| 继承自 | 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 单位
磁力计返回沿 3 个轴的磁通量密度值。值的比例尺是特斯拉。轴的排列如下。
磁力计可以报告原始磁通量值或地磁通量值。默认情况下，它返回原始磁通量值。必须将 QMagnetometer::returnGeoValues 属性设置为返回地磁通量值。
原始值和地磁值之间的主要区别是，在地质值上进行了额外的处理，以消除来自当地磁干扰，因此它们仅表示地球磁场的效果。此过程并不完美，每次读取的准确性可能会变化。
下面的图像显示了手机受到磁性干扰时地磁（左侧）和原始（右侧）读取的差别。
每次读取的准确性用 0 到 1 的数字来衡量。值为 1 是设备能够支持的最高级别，值为 0 是最差。
校准
如果设备报告的低准确性，那么在可以提供可接受的测量之前可能需要校准。基本的校准通常可以通过将设备旋转成“8”字形，或者沿设备每个三个轴旋转完成。有关更多信息，请查看您的设备文档，了解如何校准磁传感器。
属性文档
[只读] calibrationLevel : const qreal
该属性持有读数的精度。
以0到1的值表示，数值越高越好。
注意，这只有在测量地磁感应强度时才会改变。原始磁场读数始终为1。
访问函数
| qreal | calibrationLevel() const |
另请参阅QMagnetometerReading 单位和校准。
[只读] x : const qreal
该属性持有X轴上的原始磁通密度。
以特斯拉表示。
访问函数
| qreal | x() const |
[只读] y : const qreal
该属性持有Y轴上的原始磁通密度。
以特斯拉表示。
访问函数
| qreal | y() const |
[只读] z : const qreal
该属性持有Z轴上的原始磁通密度。
以特斯拉表示。
访问函数
| qreal | z() const |
成员函数文档
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。
© 2024 The Qt Company Ltd. 本文档中包含的贡献的文档版权属于其各自的所有者。本文档根据自由软件基金会发布的GNU自由文档许可证的第1.3版进行许可。Qt及其相关标志是芬兰的Qt公司及其在世界其他国家的商标。所有其他商标均为其各自所有者的财产。
