QMagnetometerReading Class
QMagnetometerReading 클래스는 자력계에서 읽은 하나의 측정값을 나타냅니다. 더 보기...
| 헤더: | #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 |
상세 설명
Q자력계 판독 단위
자력계는 3개의 축을 따라 자기 플럭스 밀도 값을 반환합니다. 값의 단위는 테슬라(tesla)입니다. 축의 배열은 다음과 같습니다.
자력계는 원시 자기 플럭스 값이나 지자기 플럭스 값 중 하나를 보고할 수 있습니다. 기본적으로 원시 자기 플럭스 값을 반환합니다. 지자기 플럭스 값을 반환하려면 ` QMagnetometer::returnGeoValues ` 속성을 설정해야 합니다.
원시 값과 지자기 값의 주된 차이점은, 지자기 값에서는 지역적 자기 간섭을 제거하기 위한 추가 처리가 이루어져 오직 지구 자기장의 영향만을 반영한다는 점입니다. 이 과정은 완벽하지 않으며, 각 측정값의 정확도는 달라질 수 있습니다.
아래 이미지는 자기 간섭을 받고 있는 휴대폰의 지자기(왼쪽)와 원시(오른쪽) 측정값 간의 차이를 보여줍니다.
각 측정값의 정확도는 0에서 1 사이의 숫자로 측정됩니다. 1은 기기가 지원할 수 있는 최고 수준이며, 0은 최악의 수준입니다.
보정
기기가 낮은 정확도를 보고하는 경우, 허용 가능한 측정값을 얻기 전에 보정이 필요할 수 있습니다. 기본 보정은 일반적으로 기기를 8자 모양으로 회전시키거나, 세 축을 따라 각각 회전시켜 수행할 수 있습니다. 자세한 내용은 기기 설명서에서 자기 센서 보정 방법을 확인하십시오.
속성 설명서
[read-only] calibrationLevel : qreal
이 속성은 측정값의 정확도를 나타냅니다.
0에서 1 사이의 값으로 측정되며, 값이 높을수록 정확도가 높습니다.
단, 이 값은 지자기 플럭스 밀도를 측정할 때만 변경된다는 점에 유의하십시오. 원시 자기 플럭스 측정값은 항상 1을 나타냅니다.
액세스 기능:
| qreal | calibrationLevel() const |
QMagnetometerReading Units 및 Calibration도 참조하십시오 .
[read-only] x : qreal
이 속성은 X축상의 원시 자기 플럭스 밀도를 나타냅니다.
단위는 테슬라(T)입니다.
액세스 함수:
| qreal | x() const |
QMagnetometerReading Units도 참조하십시오 .
[read-only] y : qreal
이 속성은 Y축에 원시 자기 플럭스 밀도를 나타냅니다.
단위는 테슬라(T)로 측정됩니다.
액세스 함수:
| qreal | y() const |
QMagnetometerReading Units도 참조하십시오 .
[read-only] z : qreal
이 속성은 Z축 방향의 원시 자속 밀도를 나타냅니다.
단위는 테슬라(T)로 측정됩니다.
액세스 함수:
| 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.
