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 una trayectoria orbital. Más información...

Encabezado: #include <qorbitcameracontroller.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
Heredado de: Qt3DExtras::QAbstractCameraController
Estado: Obsoleta

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

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 se mantiene pulsado el botón izquierdo del ratón, el movimiento del ratón a lo largo del eje x desplaza la cámara hacia la izquierda y hacia la derecha, y el movimiento a lo largo del eje y la desplaza hacia arriba y hacia abajo.
Botón derecho del ratónMientras se mantiene pulsado el botón derecho del ratón, el movimiento del ratón a lo largo del eje x desplaza la cámara alrededor del centro de la vista, y el movimiento a lo largo del eje y la inclina alrededor de dicho centro.
Botones izquierdo y derecho del ratónMientras se mantienen pulsados tanto el botón izquierdo como el derecho del ratón, 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ónAumenta y reduce el zoom de la cámara sin cambiar el centro de la vista.
Teclas de flechaMueven la cámara vertical y horizontalmente con respecto a la ventana de visualización de la cámara.
Teclas «Re Pág» y «Av Pág»Mueven la cámara hacia delante y hacia atrás.
Tecla «Mayús»Cambia 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 quedan desactivadas.
Tecla AltCambia el comportamiento de las teclas de flecha para desplazar y girar la cámara alrededor del centro de la vista. Desactiva las teclas «Página arriba» y «Página abajo».
EscMueve la cámara de manera que toda la escena quede visible en la ventana de visualización de la cámara.

Documentación de propiedades

inversePan : bool

Indica si el desplazamiento horizontal está invertido.

Cuando está activada, los movimientos de panorámica horizontal hacen girar la cámara alrededor del centro de la vista en la dirección opuesta.

Funciones de acceso:

bool inversePan() const
void setInversePan(bool isInverse)

Señal de notificación:

void inversePanChanged(bool isInverse)

inverseTilt : bool

Indica si la inclinación está invertida.

Cuando está activada, los movimientos de inclinación vertical hacen girar la cámara alrededor del centro de la vista en la dirección opuesta.

Funciones de acceso:

bool inverseTilt() const
void setInverseTilt(bool isInverse)

Señal de notificación:

void inverseTiltChanged(bool isInverse)

inverseXTranslate : bool

Indica si la traslación horizontal está invertida.

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

Funciones de acceso:

bool inverseXTranslate() const
void setInverseXTranslate(bool isInverse)

Señal de notificación:

void inverseXTranslateChanged(bool isInverse)

inverseYTranslate : bool

Indica si la traslación vertical está invertida.

Cuando está activada, los movimientos verticales del ratón y las entradas desplazan la cámara en la dirección opuesta.

Funciones de acceso:

bool inverseYTranslate() const
void setInverseYTranslate(bool isInverse)

Señal de notificación:

void inverseYTranslateChanged(bool isInverse)

upVector : QVector3D

Almacena el vector «up» para la rotación orbital de la cámara.

El vector «up» define el eje vertical alrededor del cual gira 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 de notificación:

void upVectorChanged(const QVector3D &upVector)

zoomInLimit : float

Almacena el límite actual de acercamiento. El límite de acercamiento determina hasta qué punto la cámara puede acercarse al centro de la vista.

Funciones de acceso:

float zoomInLimit() const
void setZoomInLimit(float zoomInLimit)

Señal de notificación:

void zoomInLimitChanged()

zoomTranslateViewCenter : bool

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

Cuando está activado, al hacer zoom se desplaza el centro de la vista. Cuando está desactivado, solo cambia la posición de la cámara durante las operaciones de zoom. El valor por defecto es «true».

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.