Back to Qt.io
Contact Us Blog Download Qt

QRotationReading Class

QRotationReading 클래스는 회전 센서의 판독값 하나를 나타냅니다. 더 보기...

헤더: #include <QRotationReading>
CMake: find_package(Qt6 REQUIRED COMPONENTS Sensors)
target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake: QT += sensors
상속합니다: QSensorReading

속성

  • x : const qreal
  • y : const qreal
  • z : const qreal

공공 기능

void setFromEuler(qreal x, qreal y, qreal z)
qreal x() const
qreal y() const
qreal z() const

상세 설명

회전 판독 단위

회전 판독값에는 3차원 공간에서 장치의 방향을 정의하는 각도 단위로 측정된 3개의 각도가 포함됩니다. 이 각도는 요, 피치 및 롤과 유사하지만 오른손 직교 좌표계에 의해 정의된 축을 가진 오른손 회전만을 사용하여 정의됩니다.

세 가지 각도는 다음 순서로 장치에 적용됩니다.

  • 오른손 회전 z(-180, 180]. Y축에서 시작하여 시계 반대 방향으로 증가합니다.
  • 오른손잡이 회전 x [-90, 90]. 새 (한 번 회전한) y축에서 시작하여 z축을 향해 증분합니다.
  • 오른손잡이 회전 y (-180, 180]. 새 (두 번 회전한) z축에서 시작하여 x축을 향해 증분합니다.

다음은 각도가 적용되는 순서를 보여주는 시각화입니다.

z 각도의 0점은 고정된 외부 엔티티로 정의되며 디바이스별로 다릅니다. 일반적으로 자북이 이 기준점으로 사용되지만 그렇지 않을 수도 있습니다. 디바이스 간 또는 동일한 디바이스 내에서도 상당한 거리를 이동한 경우 z 각도 값을 비교하려고 시도하지 마세요.

디바이스에서 고정된 외부 엔티티를 감지할 수 없는 경우 z 각도는 항상 0이 되고 QRotationSensor::hasZ 속성은 false로 설정됩니다.

x 및 y 각도의 0점은 디바이스의 x축과 y축이 수평선을 향할 때로 정의됩니다. 다음은 디바이스 이동에 따라 x 값이 어떻게 변하는지에 대한 예시입니다.

다음은 디바이스 이동에 따라 y 값이 어떻게 변하는지에 대한 예시입니다.

x가 90 또는 -90인 경우 z 및 y 값은 연산 순서로 인해 동일한 축을 중심으로 회전합니다. 이 경우 y 회전은 0이 됩니다.

속성 문서

[read-only] x : const qreal

이 프로퍼티는 x축을 중심으로 한 회전을 유지합니다.

도 단위로 측정됩니다.

함수에 액세스합니다:

qreal x() const

QRotationReading Units 를참조하세요 .

[read-only] y : const qreal

이 프로퍼티는 Y축을 중심으로 한 회전을 유지합니다.

도 단위로 측정됩니다.

함수에 액세스합니다:

qreal y() const

QRotationReading Units 를참조하세요 .

[read-only] z : const qreal

이 프로퍼티는 z축을 중심으로 한 회전을 유지합니다.

도 단위로 측정됩니다.

함수에 액세스합니다:

qreal z() const

QRotationReading Units 를참조하세요 .

멤버 함수 문서

void QRotationReading::setFromEuler(qreal x, qreal y, qreal z)

세 개의 오일러 각도에서 회전을 설정합니다.

백엔드에서 호출해야 합니다.

각도는 도 단위로 측정됩니다. 먼저 z 회전이 적용된 다음 x 회전, 마지막으로 y 회전이 적용되므로 회전 순서가 중요합니다.

© 2025 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.