OrbitCameraController QML Type
Controlador de cámara que gira alrededor de un origen. Más...
| Import Statement: | import QtQuick3D.Helpers |
| Inherits: |
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 ayudante permite girar una cámara alrededor de un origen. Para funcionar, OrbitCameraController acepta un nodo como origen y un objeto Cámara, que debe ser un elemento secundario del nodo de origen que se desea controlar. Al ajustar únicamente la posición z de la cámara hija con respecto al nodo padre de origen, se consigue acercar o alejar la cámara del origen de destino. Al aplicar una rotación al nodo de origen, la cámara hija girará en torno a dicho nodo.
El propio elemento OrbitCameraController es un elemento 2D que acepta eventos de entrada, por lo que, independientemente de su tamaño y posición, será allí donde se acepten dichos eventos. Para hacer zoom, utiliza la rueda de desplazamiento del ratón o realiza un gesto de pellizco. Para girar, haz clic o toca y arrastra el área. Para desplazar la imagen, mantén pulsada la tecla Control y arrastra el área. El desplazamiento cambiará la posición del nodo de origen. También es posible realizar un gesto de desplazamiento arrastrando 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]
Permite la actualización automática de las propiedades clipNear y l{PerspectiveCamera::}{clipFar} de la clase « 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 que se va a controlar. Se trata de una propiedad obligatoria y debe ser un nodo secundario del nodo « origin ».
mouseEnabled : bool [default: true]
Activa los controles del ratón.
origin : QtQuick3D::Node
Especifica el nodo de origen que se va a controlar. Se trata de una propiedad obligatoria y debe ser el nodo padre del camera
panEnabled : bool [default: true]
Activa los controles de desplazamiento.
xInvert : bool [default: false]
Invierte los controles del eje x.
xSpeed : real [default: 0.1]
Especifica la velocidad de desplazamiento cuando se mueve el ratón 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 desplazamiento cuando se mueve el ratón a lo largo del eje Y.
© 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.