OrbitCameraController QML Type

Controlador de cámara que gira alrededor de un origen. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• 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

Descripción detallada

Este helper proporciona una forma de rotar una cámara alrededor de un origen. Para funcionar OrbitCameraController acepta un Nodo como origen, y un objeto Cámara que debe ser hijo del Nodo origen a controlar. Ajustando únicamente la posición z de la cámara hija respecto al origen padre, tiene el efecto de mover la cámara más cerca o más lejos del origen objetivo. Aplicando una rotación al nodo origen, la cámara hija orbitará alrededor del nodo origen.

El elemento OrbitCameraController es en sí mismo un elemento 2D que acepta eventos de entrada, por lo que cualquiera que sea su tamaño y posición será donde se acepten los eventos de entrada. Para hacer zoom utiliza la rueda de desplazamiento del ratón o realiza un gesto de pellizco. Para rotar haz clic o toca y arrastra el área. Para desplazarse, mantenga pulsado Control y arrastre el área. El desplazamiento cambiará la posición del nodo de origen. También es posible realizar un gesto de paneo realizando un arrastre con dos dedos.

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

Documentación de propiedades

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

Especifica el botón del ratón que controla la cámara.

Esta propiedad se introdujo en Qt 6.9.

automaticClipping : bool [default: true, since 6.9]

Activa la actualización automática de las propiedades clipNear y l{PerspectiveCamera::}{clipFar} de camera en función de la posición z de la cámara.

Esta propiedad se introdujo en Qt 6.9.

camera : QtQuick3D::Camera

Especifica el nodo de cámara a controlar. Esta propiedad es obligatoria y debe ser hija del nodo origin.

mouseEnabled : bool [default: true]

Activa los controles del ratón.

origin : QtQuick3D::Node

Especifica el nodo origen a controlar. Se trata de una propiedad obligatoria y debe ser el padre del nodo camera

panEnabled : bool [default: true]

Activa los controles de panorámica.

xInvert : bool [default: false]

Invierte los controles del eje x.

xSpeed : real [default: 0.1]

Especifica la velocidad de navegación cuando el ratón se mueve a lo largo del eje X.

yInvert : bool [default: true]

Invierte los controles del eje y.

ySpeed : real [default: 0.1]

Especifica la velocidad de navegación cuando el ratón se mueve a lo largo del eje Y.