이 페이지에서

OrbitCameraController QML Type

OrbitCameraController 클래스를 사용하면 궤도 경로를 따라 씬 카메라를 제어할 수 있습니다. 더 보기...

Import Statement: import Qt3D.Extras 2.12
Inherits:

Entity

Status: Technology preview

이 유형은 기술 미리보기 단계에 있으며 변경될 수 있습니다.

속성

상세 설명

OrbitCameraController 클래스를 사용하면 궤도 경로를 따라 씬 카메라를 제어할 수 있습니다.

제어 기능은 다음과 같습니다:

입력동작
마우스 왼쪽 버튼마우스 왼쪽 버튼을 누른 상태에서 x축 방향으로 마우스를 움직이면 카메라가 좌우로 이동하고, y축 방향으로 움직이면 카메라가 상하로 이동합니다.
마우스 오른쪽 버튼마우스 오른쪽 버튼을 누른 상태에서 x축을 따라 마우스를 움직이면 카메라가 카메라 시야 중심을 중심으로 회전하고, y축을 따라 움직이면 카메라 시야 중심을 중심으로 기울어집니다.
마우스 왼쪽 및 오른쪽 버튼 모두마우스 왼쪽 및 오른쪽 버튼을 모두 누른 상태에서 마우스를 y축 방향으로 움직이면 시점 중심을 변경하지 않고 카메라를 확대하거나 축소합니다.
화살표 키카메라 뷰포트에 대해 카메라를 수직 및 수평 방향으로 이동합니다.
Page Up 및 Page Down 키카메라를 앞뒤로 이동합니다.
Shift 키위쪽 및 아래쪽 화살표 키의 동작을 변경하여, 시야 중심을 변경하지 않고 카메라를 확대 및 축소합니다. 다른 이동 키는 비활성화됩니다.
Alt 키화살표 키의 동작을 변경하여 뷰 중심을 기준으로 카메라를 좌우로 이동 및 상하로 기울이게 합니다. Page Up 및 Page Down 키는 비활성화됩니다.

속성 설명

camera : Camera

현재 제어 중인 카메라를 유지합니다.

linearSpeed : real

카메라 컨트롤러의 현재 선형 속도를 저장합니다. 선형 속도는 카메라의 이동 속도를 결정합니다.

lookSpeed : real

카메라 컨트롤러의 현재 시선 속도를 저장합니다. 시선 속도는 카메라의 팬 및 틸트 회전 속도를 결정합니다.

zoomInLimit : real

현재의 확대 한계를 저장합니다. 확대 한계는 카메라가 뷰 센터에 얼마나 가까이 확대될 수 있는지를 결정합니다.

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