En esta página

Qt3DExtras::QOrbitCameraController Class

class Qt3DExtras::QOrbitCameraController

La clase QOrbitCameraController permite controlar la cámara de la escena a lo largo de la trayectoria orbital. Más...

Cabecera: #include <QOrbitCameraController>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
Hereda: Qt3DExtras::QAbstractCameraController
Status: Obsoleto

Propiedades

Funciones públicas

bool inversePan() const
bool inverseTilt() const
bool inverseXTranslate() const
bool inverseYTranslate() const
QVector3D upVector() const
float zoomInLimit() const
bool zoomTranslateViewCenter() const

Ranuras públicas

void setInversePan(bool isInverse)
void setInverseTilt(bool isInverse)
void setInverseXTranslate(bool isInverse)
void setInverseYTranslate(bool isInverse)
void setUpVector(const QVector3D &upVector)
void setZoomInLimit(float zoomInLimit)
void setZoomTranslateViewCenter(bool isTranslate)

Señales

void inversePanChanged(bool isInverse)
void inverseTiltChanged(bool isInverse)
void inverseXTranslateChanged(bool isInverse)
void inverseYTranslateChanged(bool isInverse)
void upVectorChanged(const QVector3D &upVector)
void zoomInLimitChanged()
void zoomTranslateViewCenterChanged(bool isTranslate)

Descripción detallada

Los controles son

EntradaAcción
Botón izquierdo del ratónMientras el botón izquierdo del ratón está pulsado, el movimiento del ratón a lo largo del eje x mueve la cámara a izquierda y derecha y el movimiento a lo largo del eje y la mueve arriba y abajo.
Botón derecho del ratónMientras el botón derecho del ratón está pulsado, el movimiento del ratón a lo largo del eje x mueve la cámara alrededor del centro de la vista de la cámara y el movimiento a lo largo del eje y la inclina alrededor del centro de la vista de la cámara.
Botón izquierdo y derecho del ratónCon los botones izquierdo y derecho del ratón pulsados, el movimiento del ratón a lo largo del eje y acerca o aleja la cámara sin cambiar el centro de la vista.
Rueda de desplazamiento del ratónAcerca y aleja la cámara sin cambiar el centro de la vista.
Teclas de flechaMueven la cámara vertical y horizontalmente en relación con la vista de la cámara.
Teclas de avance y retroceso de páginaMueve la cámara hacia delante y hacia atrás.
Tecla MayúsCambia el comportamiento de las teclas de flecha arriba y abajo para acercar y alejar la cámara sin cambiar el centro de la vista. Las demás teclas de movimiento están desactivadas.
Tecla AltCambia el comportamiento de las teclas de flecha para mover la cámara alrededor del centro de visión. Desactiva las teclas de avance y retroceso.
EscapeMueve la cámara para que toda la escena sea visible en el visor de la cámara.

Documentación de propiedades

inversePan : bool

Indica si la panorámica se invierte.

Cuando se activa, los movimientos horizontales giran la cámara alrededor del centro de visión en la dirección opuesta.

Funciones de acceso:

bool inversePan() const
void setInversePan(bool isInverse)

Señal de aviso:

void inversePanChanged(bool isInverse)

inverseTilt : bool

Mantiene si la inclinación es invertida.

Cuando está activado, los movimientos verticales de inclinación giran la cámara alrededor del centro de visión en la dirección opuesta.

Funciones de acceso:

bool inverseTilt() const
void setInverseTilt(bool isInverse)

Señal de aviso:

void inverseTiltChanged(bool isInverse)

inverseXTranslate : bool

Establece si la traslación horizontal se invierte.

Cuando está activado, los movimientos horizontales del ratón y las entradas trasladan la cámara en dirección opuesta.

Funciones de acceso:

bool inverseXTranslate() const
void setInverseXTranslate(bool isInverse)

Señal notificadora:

void inverseXTranslateChanged(bool isInverse)

inverseYTranslate : bool

Indica si se invierte la traslación vertical.

Cuando se activa, los movimientos verticales del ratón y la entrada traducen la cámara en la dirección opuesta.

Funciones de acceso:

bool inverseYTranslate() const
void setInverseYTranslate(bool isInverse)

Señal notificadora:

void inverseYTranslateChanged(bool isInverse)

upVector : QVector3D

Contiene el vector ascendente para la rotación orbital de la cámara.

El vector superior define el eje vertical alrededor del cual orbita la cámara. El valor por defecto es (0.0, 1.0, 0.0).

Funciones de acceso:

QVector3D upVector() const
void setUpVector(const QVector3D &upVector)

Señal notificadora:

void upVectorChanged(const QVector3D &upVector)

zoomInLimit : float

Mantiene el límite de zoom actual. El límite de zoom determina lo cerca del centro de visión que se puede acercar la cámara.

Funciones de acceso:

float zoomInLimit() const
void setZoomInLimit(float zoomInLimit)

Señal de aviso:

void zoomInLimitChanged()

zoomTranslateViewCenter : bool

Indica si el centro de la vista se traslada durante las operaciones de zoom.

Cuando está activado, el zoom traslada el centro de la vista. Cuando está desactivado, sólo cambia la posición de la cámara durante las operaciones de zoom. El valor por defecto es verdadero.

Funciones de acceso:

bool zoomTranslateViewCenter() const
void setZoomTranslateViewCenter(bool isTranslate)

Señal de notificación:

void zoomTranslateViewCenterChanged(bool isTranslate)

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