En esta página

Q3DCamera Class

Representación de una cámara en el espacio 3D. Más...

Encabezado: #include <Q3DCamera>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Desde: QtDataVisualization 1.0
En QML: Camera3D
Heredado de: Q3DObject
Estado: Obsoleta

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

Tipos públicos

enum CameraPreset { CameraPresetNone, CameraPresetFrontLow, CameraPresetFront, CameraPresetFrontHigh, CameraPresetLeftLow, …, CameraPresetDirectlyBelow }

Propiedades

Funciones públicas

Q3DCamera(QObject *parent = nullptr)
virtual ~Q3DCamera()
Q3DCamera::CameraPreset cameraPreset() const
float maxZoomLevel() const
float minZoomLevel() const
void setCameraPosition(float horizontal, float vertical, float zoom = 100.0f)
void setCameraPreset(Q3DCamera::CameraPreset preset)
void setMaxZoomLevel(float zoomLevel)
void setMinZoomLevel(float zoomLevel)
void setTarget(const QVector3D &target)
void setWrapXRotation(bool isEnabled)
void setWrapYRotation(bool isEnabled)
void setXRotation(float rotation)
void setYRotation(float rotation)
void setZoomLevel(float zoomLevel)
QVector3D target() const
bool wrapXRotation() const
bool wrapYRotation() const
float xRotation() const
float yRotation() const
float zoomLevel() const

Funciones públicas reimplementadas

virtual void copyValuesFrom(const Q3DObject &source) override

Señales

void cameraPresetChanged(Q3DCamera::CameraPreset preset)
void maxZoomLevelChanged(float zoomLevel)
void minZoomLevelChanged(float zoomLevel)
void targetChanged(const QVector3D &target)
void wrapXRotationChanged(bool isEnabled)
void wrapYRotationChanged(bool isEnabled)
void xRotationChanged(float rotation)
void yRotationChanged(float rotation)
void zoomLevelChanged(float zoomLevel)

Descripción detallada

Q3DCamera representa una cámara 3D básica que gira en órbita alrededor de un punto central y que se utiliza al renderizar la visualización de datos. La clase ofrece métodos sencillos para girar la cámara alrededor del origen y ajustar el nivel de zoom.

Documentación de los tipos de miembros

enum Q3DCamera::CameraPreset

Posiciones predefinidas para la cámara.

ConstanteValorDescripción
Q3DCamera::CameraPresetNone-1Se utiliza para indicar que no se ha establecido ningún preajuste o que la escena se ha girado libremente.
Q3DCamera::CameraPresetFrontLow0 
Q3DCamera::CameraPresetFront1 
Q3DCamera::CameraPresetFrontHigh2 
Q3DCamera::CameraPresetLeftLow3 
Q3DCamera::CameraPresetLeft4 
Q3DCamera::CameraPresetLeftHigh5 
Q3DCamera::CameraPresetRightLow6 
Q3DCamera::CameraPresetRight7 
Q3DCamera::CameraPresetRightHigh8 
Q3DCamera::CameraPresetBehindLow9 
Q3DCamera::CameraPresetBehind10 
Q3DCamera::CameraPresetBehindHigh11 
Q3DCamera::CameraPresetIsometricLeft12 
Q3DCamera::CameraPresetIsometricLeftHigh13 
Q3DCamera::CameraPresetIsometricRight14 
Q3DCamera::CameraPresetIsometricRightHigh15 
Q3DCamera::CameraPresetDirectlyAbove16 
Q3DCamera::CameraPresetDirectlyAboveCW4517 
Q3DCamera::CameraPresetDirectlyAboveCCW4518 
Q3DCamera::CameraPresetFrontBelow19En Q3DBars, a partir de «CameraPresetFrontBelow», solo funcionan para gráficos que incluyan valores negativos. Para valores únicamente positivos, actúan como «Preset...Low».
Q3DCamera::CameraPresetLeftBelow20 
Q3DCamera::CameraPresetRightBelow21 
Q3DCamera::CameraPresetBehindBelow22 
Q3DCamera::CameraPresetDirectlyBelow23Funciona como CameraPresetFrontLow para barras que solo contienen valores positivos.

Documentación de la propiedad

cameraPreset : CameraPreset

Esta propiedad contiene el preajuste de cámara activo en ese momento.

Si no se ha establecido ningún valor para « CameraPreset », se utiliza por defecto « CameraPresetNone ».

Funciones de acceso:

Q3DCamera::CameraPreset cameraPreset() const
void setCameraPreset(Q3DCamera::CameraPreset preset)

Señal de notificación:

void cameraPresetChanged(Q3DCamera::CameraPreset preset)

maxZoomLevel : float

Esta propiedad establece el nivel máximo permitido de zoom de la cámara.

Si el nivel máximo se establece en un nuevo valor inferior al nivel mínimo existente, el nivel mínimo se ajusta también al nuevo máximo. Si el valor actual de « zoomLevel » se encuentra fuera de los nuevos límites, también se ajusta. El valor por defecto es « 500.0f ».

Funciones de acceso:

float maxZoomLevel() const
void setMaxZoomLevel(float zoomLevel)

Señal de notificación:

void maxZoomLevelChanged(float zoomLevel)

Véase también zoomLevel y minZoomLevel.

minZoomLevel : float

Esta propiedad establece el nivel mínimo permitido de zoom de la cámara.

Si el nivel mínimo se establece en un nuevo valor superior al nivel máximo existente, el nivel máximo también se ajusta al nuevo mínimo. Si el nivel de zoom máximo actual ( zoomLevel ) se encuentra fuera de los nuevos límites, también se ajusta. El nivel de zoom mínimo (minZoomLevel) no puede establecerse por debajo de 1.0f. El valor por defecto es 10.0f.

Funciones de acceso:

float minZoomLevel() const
void setMinZoomLevel(float zoomLevel)

Señal de notificación:

void minZoomLevelChanged(float zoomLevel)

Véase también zoomLevel y maxZoomLevel.

[since QtDataVisualization 1.2] target : QVector3D

Esta propiedad contiene el objetivo de la cámara como un vector o vértice en el espacio 3D.

El valor por defecto es QVector3D(0.0, 0.0, 0.0).

Los valores de coordenadas válidos se encuentran entre -1.0...1.0, donde los valores extremos indican los límites del rango del eje correspondiente. Cualquier valor fuera de este rango se ajusta al límite.

Nota: En el caso de los gráficos de barras, se ignora la coordenada Y y la cámara siempre apunta a un punto del fondo horizontal.

Esta enumeración se introdujo en QtDataVisualization 1.2.

Funciones de acceso:

QVector3D target() const
void setTarget(const QVector3D &target)

Señal de notificación:

void targetChanged(const QVector3D &target)

wrapXRotation : bool

Esta propiedad determina el comportamiento de los límites mínimo y máximo en la rotación X.

Si se establece en « true », la rotación X de la cámara se repite de mínimo a máximo y de máximo a mínimo. Si se establece en « false », la rotación X de la cámara se limita al sector determinado por los valores mínimo y máximo. Por defecto, está establecida en « true ».

Funciones de acceso:

bool wrapXRotation() const
void setWrapXRotation(bool isEnabled)

Señal de notificación:

void wrapXRotationChanged(bool isEnabled)

wrapYRotation : bool

Esta propiedad determina el comportamiento de los límites mínimo y máximo en la rotación Y.

Si se establece en « true », la rotación Y de la cámara se repite cíclicamente desde el mínimo hasta el máximo y desde el máximo hasta el mínimo. Si se establece en « false », la rotación Y de la cámara queda limitada al sector determinado por los valores mínimo y máximo. El valor predeterminado es « true ».

Funciones de acceso:

bool wrapYRotation() const
void setWrapYRotation(bool isEnabled)

Señal de notificación:

void wrapYRotationChanged(bool isEnabled)

xRotation : float

Esta propiedad contiene el ángulo de rotación en el eje X de la cámara alrededor del punto de destino, expresado en grados.

Funciones de acceso:

float xRotation() const
void setXRotation(float rotation)

Señal de notificación:

void xRotationChanged(float rotation)

yRotation : float

Esta propiedad contiene el ángulo de rotación en el eje Y de la cámara alrededor del punto de destino, expresado en grados.

Funciones de acceso:

float yRotation() const
void setYRotation(float rotation)

Señal de notificación:

void yRotationChanged(float rotation)

zoomLevel : float

Esta propiedad indica el nivel de zoom de la cámara en porcentaje.

El valor por defecto de « 100.0f » significa que no hay ningún ajuste de zoom (ni de acercamiento ni de alejamiento) configurado en la cámara. El valor está limitado por las propiedades « minZoomLevel » y « maxZoomLevel ».

Funciones de acceso:

float zoomLevel() const
void setZoomLevel(float zoomLevel)

Señal del notificador:

void zoomLevelChanged(float zoomLevel)

Véase también minZoomLevel y maxZoomLevel.

Documentación de las funciones de miembro

[explicit] Q3DCamera::Q3DCamera(QObject *parent = nullptr)

Crea una nueva cámara 3D con la posición establecida en el origen, la dirección «arriba» orientada hacia el eje Y y, por defecto, mirando hacia el origen. Se puede especificar un parámetro opcional « parent », que se pasa al constructor de « QObject ».

[virtual noexcept] Q3DCamera::~Q3DCamera()

Elimina el objeto «cámara».

[override virtual] void Q3DCamera::copyValuesFrom(const Q3DObject &source)

Reimplementa: ` Q3DObject::copyValuesFrom(const Q3DObject &source)`.

Copia las propiedades de la cámara 3D desde la cámara de origen indicada. Los valores se copian desde source a este objeto.

void Q3DCamera::setCameraPosition(float horizontal, float vertical, float zoom = 100.0f)

Función de utilidad que establece las rotaciones y la distancia de la cámara. Las propiedades «horizontal » y « vertical » definen las rotaciones de la cámara que se van a utilizar. Se puede especificar el parámetro opcional « zoom » para establecer el porcentaje de zoom de la cámara dentro de los límites definidos por las propiedades « minZoomLevel » y « maxZoomLevel ».

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