OrbitCameraController QML Type

원점을 중심으로 회전하는 카메라 컨트롤러. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• acceptedButtons : Qt::MouseButtons (since 6.9)
• automaticClipping : bool (since 6.9)
• camera : QtQuick3D::Camera
• mouseEnabled : bool
• origin : QtQuick3D::Node
• panEnabled : bool
• xInvert : bool
• xSpeed : real
• yInvert : bool
• ySpeed : real

상세 설명

이 헬퍼는 원점을 중심으로 카메라를 회전시키는 기능을 제공합니다. OrbitCameraController는 원점으로 사용할 노드(Node)와 제어할 대상인 원점 노드의 자식 노드여야 하는 카메라 객체를 매개변수로 받아 작동합니다. 자식 카메라의 z 좌표를 부모 원점에 상대적으로 조정함으로써, 카메라를 대상 원점에 더 가까이 또는 더 멀리 이동시키는 효과를 얻을 수 있습니다. 원점 노드에 회전을 적용하면 자식 카메라는 원점 노드를 중심으로 궤도를 그리며 회전하게 됩니다.

OrbitCameraController 항목 자체는 입력 이벤트를 수신하는 2D 항목이므로, 크기와 위치에 관계없이 입력 이벤트가 수신되는 위치가 됩니다. 확대/축소하려면 마우스의 스크롤 휠을 사용하거나 핀치 제스처를 수행하십시오. 회전하려면 해당 영역을 클릭하거나 터치한 후 드래그하십시오. 팬(이동)하려면 Control 키를 누른 상태에서 영역을 드래그하세요. 팬 동작을 수행하면 원점 노드의 위치가 변경됩니다. 두 손가락으로 드래그하여 팬 제스처를 수행할 수도 있습니다.

View3D {
    camera: cameraNode
    Node {
        id: originNode
        PerspectiveCamera {
            id: cameraNode
            z: 100
        }
    }
    OrbitCameraController {
        anchors.fill: parent
        origin: originNode
        camera: cameraNode
    }
    ...
}

속성 설명서

acceptedButtons : Qt::MouseButtons [default: Qt.LeftButton, since 6.9]

카메라를 제어하는 마우스 버튼을 지정합니다.

이 속성은 Qt 6.9에서 도입되었습니다.

automaticClipping : bool [default: true, since 6.9]

camera 의 clipNear 및 l{PerspectiveCamera::}{clipFar} 속성을 카메라의 z 좌표에 따라 자동으로 업데이트하도록 합니다.

이 속성은 Qt 6.9에서 도입되었습니다.

camera : QtQuick3D::Camera

제어할 카메라 노드를 지정합니다. 이 속성은 필수 속성이며, ‘ origin ’ 노드의 자식 노드여야 합니다.

mouseEnabled : bool [default: true]

마우스 조작을 활성화합니다.

origin : QtQuick3D::Node

제어할 원점 노드를 지정합니다. 이 속성은 필수 속성이며, camera

panEnabled : bool [default: true]

패닝 컨트롤을 활성화합니다.

xInvert : bool [default: false]

x축 제어 방향을 반전시킵니다.

xSpeed : real [default: 0.1]

마우스를 X축 방향으로 이동할 때의 이동 속도를 지정합니다.

yInvert : bool [default: true]

Y축 제어 방식을 반전시킵니다.

ySpeed : real [default: 0.1]

마우스를 Y축 방향으로 움직일 때의 이동 속도를 지정합니다.