En esta página

Qt3DExtras::QAbstractCameraController Class

class Qt3DExtras::QAbstractCameraController

La clase QAbstractCameraController proporciona una funcionalidad básica para los controladores de cámara. Más...

Cabecera: #include <QAbstractCameraController>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
Hereda: Qt3DCore::QEntity
Heredado por:

Qt3DExtras::QFirstPersonCameraController y Qt3DExtras::QOrbitCameraController

Estado: Deprecated

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 maneja la entrada del teclado, mouse y otros dispositivos. QAbstractCameraController es una clase abstracta y no puede ser instanciada. Proporciona una interfaz estándar para los controladores de cámara.

Documentación de propiedades

acceleration : float

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

Funciones de acceso:

float acceleration() const
void setAcceleration(float acceleration)

Señal del notificador:

void accelerationChanged(float acceleration)

camera : Qt3DRender::QCamera*

Mantiene la cámara controlada actualmente.

Funciones de acceso:

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

Señal de aviso:

void cameraChanged()

deceleration : float

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

Funciones de acceso:

float deceleration() const
void setDeceleration(float deceleration)

Señal de aviso:

void decelerationChanged(float deceleration)

linearSpeed : float

Mantiene 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 del notificador:

void linearSpeedChanged()

lookSpeed : float

Mantiene la velocidad de mirada actual del controlador de la cámara. La velocidad de visualización determina la velocidad de giro del movimiento horizontal y vertical de la cámara.

El valor predeterminado es 180.0.

Funciones de acceso:

float lookSpeed() const
void setLookSpeed(float lookSpeed)

Señal notificadora:

void lookSpeedChanged()

Miembro Función Documentación

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

Proporciona acceso al dispositivo de teclado.

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

Proporciona acceso al dispositivo de 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 cámara específico del controlador. state representa el estado de entrada, y dt es el paso de tiempo.

Esta función es llamada cada vez que se dispara 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.