OrbitCameraController QML Type
원점을 중심으로 회전하는 카메라 컨트롤러입니다. 더 보기...
Import Statement: | import QtQuick3D.Helpers |
Inherits: |
속성
- camera : QtQuick3D::Camera
- mouseEnabled : bool
- origin : QtQuick3D::Node
- panEnabled : bool
- xInvert : bool
- xSpeed : real
- yInvert : bool
- ySpeed : real
자세한 설명
이 헬퍼는 원점을 중심으로 카메라를 회전하는 방법을 제공합니다. OrbitCameraController가 작동하려면 노드를 원점으로 받아들이고, 제어할 카메라 오브젝트는 오리진 노드의 자식이어야 합니다. 부모 원점을 기준으로 자식 카메라의 z 위치만 조정하면 카메라를 대상 원점에서 더 가깝게 또는 더 멀리 이동시키는 효과를 얻을 수 있습니다. 원점 노드에 회전을 적용하면 자식 카메라가 원점 노드를 중심으로 궤도를 돌게 됩니다.
OrbitCameraController 항목 자체는 입력 이벤트를 받아들이는 2D 항목이므로 크기와 위치에 상관없이 입력 이벤트가 받아들여지는 곳에 위치합니다. 확대하려면 마우스 스크롤 휠을 사용하거나 핀치 제스처를 수행합니다. 회전하려면 해당 영역을 클릭하거나 터치한 후 드래그합니다. 이동하려면 컨트롤을 누른 채로 영역을 드래그합니다. 이동하면 원점 노드의 위치가 변경됩니다. 두 손가락으로 드래그하여 패닝 제스처를 수행할 수도 있습니다.
View3D { camera: cameraNode Node { id: originNode PerspectiveCamera { id: cameraNode z: 100 } } OrbitCameraController { anchors.fill: parent origin: originNode camera: cameraNode } ... }
속성 문서
camera : QtQuick3D::Camera |
제어할 카메라 노드를 지정합니다. 이 속성은 필수 속성이며 origin 노드의 자식이어야 합니다.
mouseEnabled : bool |
마우스 컨트롤을 활성화합니다. 기본값은 true입니다.
origin : QtQuick3D::Node |
제어할 원점 노드를 지정합니다. 이 속성은 필수 속성이며 다음과 같은 노드의 부모여야 합니다. camera
panEnabled : bool |
패닝 컨트롤을 활성화합니다. 기본값은 true입니다.
xInvert : bool |
X축 컨트롤을 반전합니다. 기본값은 false입니다.
xSpeed : real |
마우스를 X축을 따라 이동할 때 탐색 속도를 지정합니다.
yInvert : bool |
Y축 컨트롤을 반전합니다. 기본값은 참입니다.
ySpeed : real |
마우스를 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.