En esta página

Qt3DRender::QCamera Class

class Qt3DRender::QCamera

La clase QCamera define un punto de vista desde el que se representará la escena. Más información...

Encabezado: #include <Qt3DRender/QCamera>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: Camera
Heredado de: Qt3DCore::QEntity
Estado: Obsoleto

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

Tipos públicos

enum CameraTranslationOption { TranslateViewCenter, DontTranslateViewCenter }

Propiedades

Funciones públicas

QCamera(Qt3DCore::QNode *parent = nullptr)
float aspectRatio() const
float bottom() const
float exposure() const
float farPlane() const
float fieldOfView() const
float left() const
Qt3DRender::QCameraLens *lens() const
float nearPlane() const
void pan(float angle)
void pan(float angle, const QVector3D &axis)
void panAboutViewCenter(float angle)
void panAboutViewCenter(float angle, const QVector3D &axis)
QQuaternion panRotation(float angle) const
QVector3D position() const
QMatrix4x4 projectionMatrix() const
Qt3DRender::QCameraLens::ProjectionType projectionType() const
float right() const
void roll(float angle)
void rollAboutViewCenter(float angle)
QQuaternion rollRotation(float angle) const
void rotate(const QQuaternion &q)
void rotateAboutViewCenter(const QQuaternion &q)
QQuaternion rotation(float angle, const QVector3D &axis) const
void tilt(float angle)
void tiltAboutViewCenter(float angle)
QQuaternion tiltRotation(float angle) const
float top() const
Qt3DCore::QTransform *transform() const
void translate(const QVector3D &vLocal, Qt3DRender::QCamera::CameraTranslationOption option = TranslateViewCenter)
void translateWorld(const QVector3D &vWorld, Qt3DRender::QCamera::CameraTranslationOption option = TranslateViewCenter)
QVector3D upVector() const
QVector3D viewCenter() const
QVector3D viewVector() const

Ranuras públicas

void setAspectRatio(float aspectRatio)
void setBottom(float bottom)
void setExposure(float exposure)
void setFarPlane(float farPlane)
void setFieldOfView(float fieldOfView)
void setLeft(float left)
void setNearPlane(float nearPlane)
void setPosition(const QVector3D &position)
void setProjectionMatrix(const QMatrix4x4 &projectionMatrix)
void setProjectionType(Qt3DRender::QCameraLens::ProjectionType type)
void setRight(float right)
void setTop(float top)
void setUpVector(const QVector3D &upVector)
void setViewCenter(const QVector3D &viewCenter)
void viewAll()
void viewEntity(Qt3DCore::QEntity *entity)
void viewSphere(const QVector3D &center, float radius)

Señales

void aspectRatioChanged(float aspectRatio)
void bottomChanged(float bottom)
void exposureChanged(float exposure)
void farPlaneChanged(float farPlane)
void fieldOfViewChanged(float fieldOfView)
void leftChanged(float left)
void nearPlaneChanged(float nearPlane)
void positionChanged(const QVector3D &position)
void projectionMatrixChanged(const QMatrix4x4 &projectionMatrix)
void projectionTypeChanged(Qt3DRender::QCameraLens::ProjectionType projectionType)
void rightChanged(float right)
void topChanged(float top)
void upVectorChanged(const QVector3D &upVector)
void viewCenterChanged(const QVector3D &viewCenter)
void viewVectorChanged(const QVector3D &viewVector)

Descripción detallada

Documentación sobre los tipos de miembros

enum QCamera::CameraTranslationOption

Esta enumeración especifica cómo se desplaza el centro de la vista de la cámara

ConstanteValorDescripción
Qt3DRender::QCamera::TranslateViewCenter0Traslada el centro de la vista de modo que la dirección de la vista permanezca igual
Qt3DRender::QCamera::DontTranslateViewCenter1No desplaza el centro de la vista, con lo que la dirección de la vista cambia

Documentación de la propiedad

aspectRatio : float

Mantiene la relación de aspecto actual.

Funciones de acceso:

float aspectRatio() const
void setAspectRatio(float aspectRatio)

Señal de notificación:

void aspectRatioChanged(float aspectRatio)

bottom : float

Almacena la parte inferior actual de la cámara.

Esta propiedad solo es relevante cuando « projectionType » tiene el valor « QCameraLens::OrthographicProjection ».

Funciones de acceso:

float bottom() const
void setBottom(float bottom)

Señal de notificación:

void bottomChanged(float bottom)

exposure : float

Almacena la exposición actual de la cámara.

El valor por defecto es 0,0.

El material MetalRoughMaterial, incluido en « Qt 3D Extras», es actualmente el único material disponible que utiliza la exposición de la cámara. Los valores negativos harán que el material sea más oscuro, mientras que los valores positivos lo harán más claro.

Los materiales personalizados pueden optar por interpretar el valor de forma diferente.

Funciones de acceso:

float exposure() const
void setExposure(float exposure)

Señal de notificación:

void exposureChanged(float exposure)

farPlane : float

Almacena el plano lejano actual de la cámara. Los objetos que se encuentren más lejos de la cámara que el plano lejano no se renderizarán.

Funciones de acceso:

float farPlane() const
void setFarPlane(float farPlane)

Señal de notificación:

void farPlaneChanged(float farPlane)

fieldOfView : float

Almacena el campo de visión vertical actual en grados.

Junto con « aspectRatio », esta propiedad determina qué parte de la escena es visible para la cámara. En ese sentido, se puede considerar análogo a elegir un objetivo gran angular (campo de visión horizontal amplio) o un teleobjetivo (campo de visión horizontal estrecho), dependiendo de qué parte de la escena se desee capturar.

La propiedad `fieldOfView` solo es relevante cuando ` projectionType ` tiene el valor ` QCameraLens::PerspectiveProjection`.

Funciones de acceso:

float fieldOfView() const
void setFieldOfView(float fieldOfView)

Señal del notificador:

void fieldOfViewChanged(float fieldOfView)

left : float

Contiene la coordenada de izquierda actual de la cámara.

Esta propiedad solo es relevante cuando « projectionType » tiene el valor « QCameraLens::OrthographicProjection ».

Funciones de acceso:

float left() const
void setLeft(float left)

Señal de notificación:

void leftChanged(float left)

[read-only] lens : Qt3DRender::QCameraLens* const

Almacena el componente Qt3DRender::QCameraLens de la cámara.

Funciones de acceso:

Qt3DRender::QCameraLens *lens() const

nearPlane : float

Establece el plano cercano actual de la cámara. Los objetos que se encuentren más cerca de la cámara que el plano cercano no se renderizarán.

Funciones de acceso:

float nearPlane() const
void setNearPlane(float nearPlane)

Señal de notificación:

void nearPlaneChanged(float nearPlane)

position : QVector3D

Mantiene la posición de la cámara en coordenadas relativas a la entidad principal.

Funciones de acceso:

QVector3D position() const
void setPosition(const QVector3D &position)

Señal de notificación:

void positionChanged(const QVector3D &position)

projectionMatrix : QMatrix4x4

Almacena la matriz de proyección actual de la cámara.

Funciones de acceso:

QMatrix4x4 projectionMatrix() const
void setProjectionMatrix(const QMatrix4x4 &projectionMatrix)

Señal de notificación:

void projectionMatrixChanged(const QMatrix4x4 &projectionMatrix)

projectionType : Qt3DRender::QCameraLens::ProjectionType

Almacena el tipo de proyección de la cámara. El valor por defecto es « QCameraLens::PerspectiveProjection ».

Funciones de acceso:

Qt3DRender::QCameraLens::ProjectionType projectionType() const
void setProjectionType(Qt3DRender::QCameraLens::ProjectionType type)

Señal de notificación:

void projectionTypeChanged(Qt3DRender::QCameraLens::ProjectionType projectionType)

Véase también Qt3DRender::QCameraLens::ProjectionType.

right : float

Contiene el derecho actual de la cámara.

Esta propiedad solo es relevante cuando « projectionType » tiene el valor « QCameraLens::OrthographicProjection ».

Funciones de acceso:

float right() const
void setRight(float right)

Señal de notificación:

void rightChanged(float right)

top : float

Almacena la posición actual de la parte superior de la cámara.

Esta propiedad solo es relevante cuando « projectionType » tiene el valor « QCameraLens::OrthographicProjection ».

Funciones de acceso:

float top() const
void setTop(float top)

Señal de notificación:

void topChanged(float top)

[read-only] transform : Qt3DCore::QTransform* const

Almacena el componente Qt3DCore::QTransform de la cámara.

Funciones de acceso:

Qt3DCore::QTransform *transform() const

upVector : QVector3D

Almacena el vector «up» de la cámara en coordenadas relativas a la entidad padre.

El vector «up» indica hacia qué dirección está orientada la parte superior de la cámara. Piensa en cómo se hace una foto: después de colocarte en posición y apuntar con la cámara hacia el objetivo, puedes girar la cámara hacia la izquierda o hacia la derecha para obtener una foto en vertical, en horizontal (¡o en ángulo!). «upVector» te permite controlar este tipo de movimiento.

Funciones de acceso:

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

Señal de notificación:

void upVectorChanged(const QVector3D &upVector)

viewCenter : QVector3D

Mantiene el centro de la vista de la cámara en coordenadas relativas a la entidad principal.

Intuitivamente, el «viewCenter» es la ubicación hacia la que apunta la cámara.

Funciones de acceso:

QVector3D viewCenter() const
void setViewCenter(const QVector3D &viewCenter)

Señal de notificador:

void viewCenterChanged(const QVector3D &viewCenter)

[read-only] viewVector : QVector3D

Almacena el vector de visión de la cámara en coordenadas relativas a la entidad principal.

Este vector describe el desplazamiento desde la cámara (position) hasta su objetivo (viewCenter).

Funciones de acceso:

QVector3D viewVector() const

Señal de notificación:

void viewVectorChanged(const QVector3D &viewVector)

Documentación de las funciones de miembro

[explicit] QCamera::QCamera(Qt3DCore::QNode *parent = nullptr)

Crea una nueva instancia de QCamera con el ` parent` especificado.

Qt3DRender::QCameraLens *QCamera::lens() const

Devuelve la lente actual.

Nota: Funcióngetter para la propiedad «lens».

[invokable] void QCamera::pan(float angle)

Ajusta el ángulo de panorámica de la cámara en angle en grados.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QCamera::pan(float angle, const QVector3D &axis)

Ajusta el ángulo de panorámica de la cámara en angle grados sobre un eje axis elegido.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QCamera::panAboutViewCenter(float angle)

Ajusta el desplazamiento horizontal de la cámara alrededor del centro de la vista en angle grados.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QCamera::panAboutViewCenter(float angle, const QVector3D &axis)

Ajusta el desplazamiento horizontal de la cámara alrededor del centro de la vista en angle grados sobre axis.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QQuaternion QCamera::panRotation(float angle) const

Devuelve la rotación de panorámica calculada en relación con el angle en grados, que se utiliza para ajustar la panorámica de la cámara o su rotación hacia la izquierda o la derecha en el eje Y.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QCamera::roll(float angle)

Ajusta el giro de la cámara en angle grados.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QCamera::rollAboutViewCenter(float angle)

Ajusta el giro de la cámara alrededor del centro de la vista en angle grados.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QQuaternion QCamera::rollRotation(float angle) const

Devuelve la rotación de balanceo calculada en relación con el « angle » (ajuste de balanceo), expresada en grados, que se aplica para ajustar el balanceo de la cámara o su inclinación hacia la izquierda o hacia la derecha alrededor del eje Z.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QCamera::rotate(const QQuaternion &q)

Gira la cámara utilizando un cuaternión en q.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QCamera::rotateAboutViewCenter(const QQuaternion &q)

Gira la cámara alrededor del centro de la vista utilizando un cuaternión en q.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QQuaternion QCamera::rotation(float angle, const QVector3D &axis) const

Devuelve la rotación calculada en relación con el « angle » en grados y el « axis » seleccionado.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[slot] void QCamera::setAspectRatio(float aspectRatio)

Establece la relación de aspecto de la cámara en aspectRatio.

Nota: Funciónde configuración para la propiedad aspectRatio.

Véase también ` aspectRatio()`.

[slot] void QCamera::setBottom(float bottom)

Establece la parte inferior de la cámara en bottom.

Nota: Funciónde asignación para la propiedad bottom.

Véase también bottom().

[slot] void QCamera::setExposure(float exposure)

Establece la exposición de la cámara en exposure.

Nota: Funciónde asignación para la propiedad exposure.

Véase también ` exposure()`.

[slot] void QCamera::setFarPlane(float farPlane)

Establece el plano lejano de la cámara en farPlane

Nota: Funciónde asignación para la propiedad farPlane.

Véase también farPlane().

[slot] void QCamera::setFieldOfView(float fieldOfView)

Establece el campo de visión de la cámara en fieldOfView en grados.

Nota: Funciónde asignación para la propiedad fieldOfView.

Véase también ` fieldOfView()`.

[slot] void QCamera::setLeft(float left)

Establece el lado izquierdo de la cámara en left.

Nota: Funciónde asignación para la propiedad left.

Véase también left().

[slot] void QCamera::setNearPlane(float nearPlane)

Establece el plano cercano de la cámara en nearPlane.

Nota: Funciónde asignación para la propiedad nearPlane.

Véase también ` nearPlane()`.

[slot] void QCamera::setPosition(const QVector3D &position)

Establece la posición de la cámara en el espacio 3D en position.

Nota: Funciónde asignación para la propiedad position.

Véase también position().

[slot] void QCamera::setProjectionMatrix(const QMatrix4x4 &projectionMatrix)

Establece la matriz de proyección de la cámara en projectionMatrix.

Nota: Funciónde asignación para la propiedad projectionMatrix.

Véase también projectionMatrix().

[slot] void QCamera::setProjectionType(Qt3DRender::QCameraLens::ProjectionType type)

Establece el tipo de proyección de la cámara en « type ».

Nota: Funciónde asignación para la propiedad ` projectionType`.

Véase también projectionType().

[slot] void QCamera::setRight(float right)

Establece el valor de la propiedad «right» de la cámara en « right ».

Nota: Funciónde asignación para la propiedad right.

Véase también right().

[slot] void QCamera::setTop(float top)

Establece la parte superior de la cámara en top.

Nota: Funciónde asignación para la propiedad top.

Véase también ` top()`.

[slot] void QCamera::setUpVector(const QVector3D &upVector)

Establece el vector «up» de la cámara en upVector.

Nota: Funciónde asignación para la propiedad upVector.

Véase también ` upVector()`.

[slot] void QCamera::setViewCenter(const QVector3D &viewCenter)

Establece el centro de la vista de la cámara en viewCenter.

Nota: Funciónde asignación para la propiedad viewCenter.

Véase también viewCenter().

[invokable] void QCamera::tilt(float angle)

Ajusta el ángulo de inclinación de la cámara en angle grados.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QCamera::tiltAboutViewCenter(float angle)

Ajusta la inclinación de la cámara alrededor del centro de la vista en angle grados.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QQuaternion QCamera::tiltRotation(float angle) const

Devuelve la rotación de inclinación calculada con respecto al « angle » en grados, que se utiliza para ajustar la inclinación de la cámara o su rotación hacia arriba o hacia abajo en el eje X.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Qt3DCore::QTransform *QCamera::transform() const

Devuelve la posición de la cámara mediante la transformación.

Nota: Funcióngetter para la propiedad «transform».

[invokable] void QCamera::translate(const QVector3D &vLocal, Qt3DRender::QCamera::CameraTranslationOption option = TranslateViewCenter)

Traslada la posición de la cámara y su vector de visión mediante « vLocal » en coordenadas locales. El parámetro « option » permite activar o desactivar el desplazamiento del centro de la vista.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QCamera::translateWorld(const QVector3D &vWorld, Qt3DRender::QCamera::CameraTranslationOption option = TranslateViewCenter)

Traslada la posición de la cámara y su vector de vista mediante vWorld en coordenadas del mundo. El parámetro « option » permite activar o desactivar el desplazamiento del centro de la vista.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[slot] void QCamera::viewAll()

Gira y desplaza la cámara de modo que su punto de e viewCenter e coincida con el centro del volumen delimitador de la escena y toda la escena quepa en la ventana de visualización.

Nota: Solo funciona si la lente está en modo de proyección en perspectiva u ortográfica.

Véase también Qt3D.Render::Camera::projectionType.

[slot] void QCamera::viewEntity(Qt3DCore::QEntity *entity)

Gira y desplaza la cámara de modo que su « viewCenter » coincida con el centro del volumen delimitador de la « entity » y toda la entidad quepa en la ventana de visualización.

Nota: Solo funciona si la lente está en modo de proyección en perspectiva u ortográfica.

Véase también Camera.projectionType.

[slot] void QCamera::viewSphere(const QVector3D &center, float radius)

Gira y desplaza la cámara de modo que su e viewCenter o sea center y que una esfera de radius quepa en la ventana de visualización.

Nota: Solo funciona si la lente está en modo de proyección en perspectiva u ortográfica.

Véase también Qt3D.Render::Camera::projectionType.

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