Qt3DExtras::QOrbitCameraController Class
class Qt3DExtras::QOrbitCameraControllerQOrbitCameraController 클래스를 사용하면 궤도 경로를 따라 씬 카메라를 제어할 수 있습니다. 더 보기...
| Header: | #include <QOrbitCameraController> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dextras)target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake: | QT += 3dextras |
| 상속합니다: | Qt3DExtras::QAbstractCameraController |
| 상태: | Deprecated |
속성
|
|
공용 기능
| bool | inversePan() const |
| bool | inverseTilt() const |
| bool | inverseXTranslate() const |
| bool | inverseYTranslate() const |
| QVector3D | upVector() const |
| float | zoomInLimit() const |
| bool | zoomTranslateViewCenter() const |
공용 슬롯
| void | setInversePan(bool isInverse) |
| void | setInverseTilt(bool isInverse) |
| void | setInverseXTranslate(bool isInverse) |
| void | setInverseYTranslate(bool isInverse) |
| void | setUpVector(const QVector3D &upVector) |
| void | setZoomInLimit(float zoomInLimit) |
| void | setZoomTranslateViewCenter(bool isTranslate) |
신호
| void | inversePanChanged(bool isInverse) |
| void | inverseTiltChanged(bool isInverse) |
| void | inverseXTranslateChanged(bool isInverse) |
| void | inverseYTranslateChanged(bool isInverse) |
| void | upVectorChanged(const QVector3D &upVector) |
| void | zoomInLimitChanged() |
| void | zoomTranslateViewCenterChanged(bool isTranslate) |
상세 설명
컨트롤은 다음과 같습니다:
| 입력 | 동작 |
|---|---|
| 마우스 왼쪽 버튼 | 마우스 왼쪽 버튼을 누른 상태에서 마우스를 X축으로 움직이면 카메라가 좌우로 이동하고 Y축으로 움직이면 카메라가 위아래로 이동합니다. |
| 마우스 오른쪽 버튼 | 마우스 오른쪽 버튼을 누른 상태에서 마우스를 x축을 따라 움직이면 카메라 뷰 중심을 중심으로 카메라를 패닝하고 y축을 따라 움직이면 카메라 뷰 중심을 중심으로 카메라를 기울입니다. |
| 마우스 왼쪽 및 오른쪽 버튼 모두 | 마우스 왼쪽 버튼과 오른쪽 버튼을 모두 누른 상태에서 y축을 따라 마우스를 움직이면 보기 중심을 변경하지 않고 카메라를 확대/축소할 수 있습니다. |
| 마우스 스크롤 휠 | 보기 중심을 변경하지 않고 카메라를 확대 및 축소합니다. |
| 화살표 키 | 카메라 뷰포트를 기준으로 카메라를 수직 및 수평으로 이동합니다. |
| 페이지 업 및 페이지 다운 키 | 카메라를 앞뒤로 이동합니다. |
| Shift 키 | 위쪽 및 아래쪽 화살표 키의 동작을 변경하여 뷰 중심을 변경하지 않고 카메라를 확대 및 축소합니다. 다른 이동 키는 비활성화됩니다. |
| Alt 키 | 화살표 키의 동작을 변경하여 보기 중심을 중심으로 카메라를 이동 및 기울입니다. 페이지 위로 및 페이지 아래로 키를 비활성화합니다. |
| Escape | 카메라 뷰포트에서 전체 장면을 볼 수 있도록 카메라를 이동합니다. |
속성 문서
inversePan : bool
패닝의 반전 여부를 유지합니다.
활성화하면 수평 이동 시 카메라가 뷰 중심을 중심으로 반대 방향으로 회전합니다.
액세스 기능:
| bool | inversePan() const |
| void | setInversePan(bool isInverse) |
알림 신호:
| void | inversePanChanged(bool isInverse) |
inverseTilt : bool
틸트 반전 여부를 유지합니다.
활성화하면 수직 기울기 이동 시 카메라가 뷰 중심을 중심으로 반대 방향으로 회전합니다.
기능 액세스:
| bool | inverseTilt() const |
| void | setInverseTilt(bool isInverse) |
알림 신호:
| void | inverseTiltChanged(bool isInverse) |
inverseXTranslate : bool
수평 이동이 반전될지 여부를 유지합니다.
활성화하면 마우스를 수평으로 움직이고 입력하면 카메라가 반대 방향으로 이동합니다.
기능에 액세스합니다:
| bool | inverseXTranslate() const |
| void | setInverseXTranslate(bool isInverse) |
알림 신호:
| void | inverseXTranslateChanged(bool isInverse) |
inverseYTranslate : bool
수직 이동이 반전될지 여부를 유지합니다.
활성화하면 마우스를 수직으로 움직이거나 입력하면 카메라가 반대 방향으로 이동합니다.
기능에 액세스합니다:
| bool | inverseYTranslate() const |
| void | setInverseYTranslate(bool isInverse) |
알림 신호:
| void | inverseYTranslateChanged(bool isInverse) |
upVector : QVector3D
카메라의 궤도 회전을 위한 위쪽 벡터를 보유합니다.
위쪽 벡터는 카메라가 궤도를 도는 수직 축을 정의합니다. 기본값은 (0.0, 1.0, 0.0)입니다.
기능에 액세스합니다:
| QVector3D | upVector() const |
| void | setUpVector(const QVector3D &upVector) |
알림 신호:
| void | upVectorChanged(const QVector3D &upVector) |
zoomInLimit : float
현재 줌인 제한을 유지합니다. 줌인 제한은 카메라를 뷰 중앙에 얼마나 가까이 확대할 수 있는지를 결정합니다.
기능에 액세스합니다:
| float | zoomInLimit() const |
| void | setZoomInLimit(float zoomInLimit) |
알림 신호:
| void | zoomInLimitChanged() |
zoomTranslateViewCenter : bool
확대/축소 작업 중에 보기 중심이 변환되는지 여부를 유지합니다.
활성화하면 확대/축소 시 뷰 중심이 이동합니다. 비활성화하면 줌 작업 중에 카메라 위치만 변경됩니다. 기본값은 true입니다.
기능 액세스:
| bool | zoomTranslateViewCenter() const |
| void | setZoomTranslateViewCenter(bool isTranslate) |
알림 신호:
| void | zoomTranslateViewCenterChanged(bool isTranslate) |
© 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.
