QMagnetometerReading Class

QMagnetometerReading クラスは、磁力計からの 1 つの読み取り値を表します。詳細...

Header: #include <QMagnetometerReading>
CMake: find_package(Qt6 REQUIRED COMPONENTS Sensors)
target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake: QT += sensors
Inherits: QSensorReading

プロパティ

パブリック関数

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の字に回転させるか、装置を3つの軸に沿ってそれぞれ回転させることによって行うことができます。詳細については、磁気センサーの較正方法に関するデバイスのマニュアルを確認してください。

プロパティ ドキュメント

[read-only] calibrationLevel : const qreal

このプロパティは、読み取り精度を保持します。

0から1までの値で測定され、値が大きいほど優れています。

これは地磁気磁束密度を測定する場合にのみ変化することに注意してください。生の磁束の読み取り値は常に 1 です。

アクセス関数:

qreal calibrationLevel() const

QMagnetometerReading Units およびCalibrationも参照のこと

[read-only] x : const qreal

このプロパティは X 軸の生の磁束密度を保持する。

テスラとして測定される。

アクセス関数:

qreal x() const

QMagnetometerReading Unitsも参照

[read-only] y : const qreal

このプロパティは Y 軸の生の磁束密度を保持する。

テスラとして測定される。

アクセス関数:

qreal y() const

QMagnetometerReading Units参照

[read-only] z : const 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() も参照して ください。

本書に含まれる文書の著作権は、各所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。