En esta página

Qt3DExtras::QAbstractCameraController Class

class Qt3DExtras::QAbstractCameraController

La clase QAbstractCameraController proporciona funcionalidades básicas para los controladores de cámara. Más información...

Encabezado: #include <qabstractcameracontroller.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
Heredado de: Qt3DCore::QEntity
Heredado por:

Qt3DExtras::QFirstPersonCameraController y Qt3DExtras::QOrbitCameraController

Estado: Obsoleta

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Propiedades

Funciones públicas

float acceleration() const
Qt3DRender::QCamera *camera() const
float deceleration() const
float linearSpeed() const
float lookSpeed() const
void setAcceleration(float acceleration)
void setCamera(Qt3DRender::QCamera *camera)
void setDeceleration(float deceleration)
void setLinearSpeed(float linearSpeed)
void setLookSpeed(float lookSpeed)

Señales

void accelerationChanged(float acceleration)
void cameraChanged()
void decelerationChanged(float deceleration)
void linearSpeedChanged()
void lookSpeedChanged()

Funciones protegidas

Qt3DInput::QKeyboardDevice *keyboardDevice() const
Qt3DInput::QMouseDevice *mouseDevice() const

Funciones privadas

virtual void moveCamera(const Qt3DExtras::QAbstractCameraController::InputState &state, float dt) = 0

Descripción detallada

QAbstractCameraController configura y gestiona las entradas procedentes del teclado, el ratón y otros dispositivos. QAbstractCameraController es una clase abstracta y no puede instanciarse por sí misma. Proporciona una interfaz estándar para los controladores de cámara.

Documentación de propiedades

acceleration : float

Almacena la aceleración actual del controlador de la cámara.

Funciones de acceso:

float acceleration() const
void setAcceleration(float acceleration)

Señal de notificación:

void accelerationChanged(float acceleration)

camera : Qt3DRender::QCamera*

Muestra la cámara que se está controlando en ese momento.

Funciones de acceso:

Qt3DRender::QCamera *camera() const
void setCamera(Qt3DRender::QCamera *camera)

Señal de notificación:

void cameraChanged()

deceleration : float

Almacena la desaceleración actual del controlador de la cámara.

Funciones de acceso:

float deceleration() const
void setDeceleration(float deceleration)

Señal de notificación:

void decelerationChanged(float deceleration)

linearSpeed : float

Almacena la velocidad lineal actual del controlador de la cámara. La velocidad lineal determina la velocidad de movimiento de la cámara.

El valor por defecto es 10.0.

Funciones de acceso:

float linearSpeed() const
void setLinearSpeed(float linearSpeed)

Señal de notificación:

void linearSpeedChanged()

lookSpeed : float

Almacena la velocidad de giro actual del controlador de la cámara. La velocidad de giro determina la velocidad de giro de los ejes de panorámica e inclinación de la cámara.

El valor por defecto es 180.0.

Funciones de acceso:

float lookSpeed() const
void setLookSpeed(float lookSpeed)

Señal de notificación:

void lookSpeedChanged()

Documentación de la función de miembro

[protected] Qt3DInput::QKeyboardDevice *QAbstractCameraController::keyboardDevice() const

Permite acceder al teclado.

[protected] Qt3DInput::QMouseDevice *QAbstractCameraController::mouseDevice() const

Permite acceder al ratón.

[pure virtual private] void QAbstractCameraController::moveCamera(const Qt3DExtras::QAbstractCameraController::InputState &state, float dt)

Las subclases deben sobrescribir este método para implementar el movimiento de la cámara específico del controlador. ` state ` representa el estado de entrada, y ` dt ` es el paso de tiempo.

Esta función se invoca cada vez que se activa una acción de fotograma.

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