QMagnetometerReading Class
QMagnetometerReading クラスは、磁力計からの1回の読み取り値を表します。詳細...
| ヘッダー: | #include <QMagnetometerReading> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Sensors) target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake: | QT += sensors |
| 継承元: | QSensorReading |
プロパティ
- calibrationLevel : qreal
- x : qreal
- y : qreal
- z : 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 Units
磁力計は、3つの軸に沿った磁束密度の値を返します。値の単位はテスラです。軸の配置は以下の通りです。
磁力計は、生の磁束値または地磁気束値のいずれかを報告できます。デフォルトでは、生の磁束値が返されます。地磁気束値を返すには、QMagnetometer::returnGeoValues プロパティを設定する必要があります。
生データと地磁気データの主な違いは、地磁気データには、局所的な磁気干渉を除去するための追加処理が施されており、地球の磁場の影響のみを表しているという点です。この処理は完全ではなく、各測定値の精度は変動する可能性があります。
下の画像は、磁気干渉を受けているスマートフォンにおける、地磁気値（左）と生データ値（右）の測定値の違いを示しています。
各測定値の精度は、0 から 1 までの数値で表されます。1 はデバイスがサポートできる最高レベル、0 は最低レベルを表します。
校正
デバイスの精度が低いと報告されている場合は、許容可能な測定値が得られるようになる前に、キャリブレーションが必要になる可能性があります。基本的なキャリブレーションは、通常、デバイスを「8の字」を描くように回転させるか、3つの軸それぞれに沿って回転させることで行うことができます。詳細については、磁気センサーのキャリブレーション方法に関するデバイスの取扱説明書をご確認ください。
プロパティのドキュメント
[read-only] calibrationLevel : qreal
このプロパティは、測定値の精度を表します。
0から1までの値で表され、値が大きいほど精度が高いことを示します。
なお、これは地磁気磁束密度を測定する場合にのみ変化することに注意してください。生の磁束測定値は常に1となります。
アクセス関数：
| qreal | calibrationLevel() const |
関連項目: QMagnetometerReading Units およびCalibration 。
[read-only] x : qreal
このプロパティには、X軸上の生磁束密度が格納されています。
単位はテスラです。
アクセス関数：
| qreal | x() const |
QMagnetometerReading Unitsも参照してください 。
[read-only] y : qreal
このプロパティには、Y軸上の未処理の磁束密度が格納されています。
単位はテスラです。
アクセス関数：
| qreal | y() const |
QMagnetometerReading Unitsも参照してください 。
[read-only] z : qreal
このプロパティには、Z軸方向の未処理の磁束密度が格納されます。
単位はテスラです。
アクセス関数：
| qreal | z() const |
「QMagnetometerReading Units」も参照してください 。
メンバ関数のドキュメント
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()も参照してください 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
