En esta página

Qt3DRender::QCameraLens Class

class Qt3DRender::QCameraLens

Qt3DRender::QCameraLens especifica la matriz de proyección que se utilizará para definir una cámara en una escena 3D. Más información...

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

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

Tipos públicos

enum ProjectionType { OrthographicProjection, PerspectiveProjection, FrustumProjection, CustomProjection }

Propiedades

Funciones públicas

QCameraLens(Qt3DCore::QNode *parent = nullptr)
float aspectRatio() const
float bottom() const
float exposure() const
float farPlane() const
float fieldOfView() const
float left() const
float nearPlane() const
QMatrix4x4 projectionMatrix() const
Qt3DRender::QCameraLens::ProjectionType projectionType() const
float right() const
void setFrustumProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)
void setOrthographicProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)
void setPerspectiveProjection(float fieldOfView, float aspectRatio, float nearPlane, float farPlane)
float top() 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 setProjectionMatrix(const QMatrix4x4 &projectionMatrix)
void setProjectionType(Qt3DRender::QCameraLens::ProjectionType projectionType)
void setRight(float right)
void setTop(float top)

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 projectionMatrixChanged(const QMatrix4x4 &projectionMatrix)
void projectionTypeChanged(Qt3DRender::QCameraLens::ProjectionType projectionType)
void rightChanged(float right)
void topChanged(float top)

Descripción detallada

Documentación sobre los tipos de miembros

enum QCameraLens::ProjectionType

Especifica qué parámetros de ` Qt3DRender::QCameraLens ` se utilizan para calcular la matriz de proyección.

ConstanteValorDescripción
Qt3DRender::QCameraLens::OrthographicProjection0Proyección ortogonal
Qt3DRender::QCameraLens::PerspectiveProjection1Proyección en perspectiva
Qt3DRender::QCameraLens::FrustumProjection2Proyección en forma de tronco
Qt3DRender::QCameraLens::CustomProjection3Proyección personalizada definida por el usuario

Documentación de propiedades

aspectRatio : float

Almacena la relación de aspecto actual del objetivo de la cámara.

Nota: El valor devuelto puede ser indefinido si el tipo de proyección no es « Qt3DRender::QCameraLens::PerspectiveProjection ».

Funciones de acceso:

float aspectRatio() const
void setAspectRatio(float aspectRatio)

Señal de notificación:

void aspectRatioChanged(float aspectRatio)

bottom : float

Contiene el plano inferior actual del objetivo de la cámara.

Nota: El valor de retorno puede ser indefinido si el tipo de proyección es « Qt3DRender::QCameraLens::PerspectiveProjection ».

Funciones de acceso:

float bottom() const
void setBottom(float bottom)

Señal de notificación:

void bottomChanged(float bottom)

exposure : float

Mantenía la exposición actual del objetivo de la cámara.

Funciones de acceso:

float exposure() const
void setExposure(float exposure)

Señal de notificación:

void exposureChanged(float exposure)

farPlane : float

Muestra el plano cercano actual del objetivo de la cámara.

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 actual del objetivo de la cámara.

Nota: El valor de retorno puede ser indefinido si el tipo de proyección no es « Qt3DRender::QCameraLens::PerspectiveProjection ».

Funciones de acceso:

float fieldOfView() const
void setFieldOfView(float fieldOfView)

Señal de notificación:

void fieldOfViewChanged(float fieldOfView)

left : float

Contiene el plano izquierdo actual del objetivo de la cámara.

Nota: El valor de retorno puede ser indefinido si el tipo de proyección es « Qt3DRender::QCameraLens::PerspectiveProjection ».

Funciones de acceso:

float left() const
void setLeft(float left)

Señal de notificación:

void leftChanged(float left)

nearPlane : float

Muestra el plano cercano actual del objetivo de la cámara.

Funciones de acceso:

float nearPlane() const
void setNearPlane(float nearPlane)

Señal de notificación:

void nearPlaneChanged(float nearPlane)

projectionMatrix : QMatrix4x4

Almacena la matriz de proyección actual del objetivo 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 : ProjectionType

Almacena el tipo de proyección de la cámara.

Funciones de acceso:

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

Señal de notificación:

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

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

right : float

Contiene el plano derecho actual del objetivo de la cámara.

Nota: El valor devuelto puede ser indefinido si el tipo de proyección es « Qt3DRender::QCameraLens::PerspectiveProjection ».

Funciones de acceso:

float right() const
void setRight(float right)

Señal de notificación:

void rightChanged(float right)

top : float

Contiene el plano superior actual de la lente de la cámara.

Nota: El valor devuelto puede ser indefinido si el tipo de proyección es « Qt3DRender::QCameraLens::PerspectiveProjection ».

Funciones de acceso:

float top() const
void setTop(float top)

Señal de notificación:

void topChanged(float top)

Documentación de funciones de miembro

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

Crea un objeto `QCameraLens` con los parámetros indicados parent

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

Establece la relación de aspecto de la proyección en aspectRatio. Esto provoca una actualización de la matriz de proyección.

Nota: esto no tiene ningún efecto si el tipo de proyección no es « Qt3DRender::QCameraLens::PerspectiveProjection ».

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

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

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

Establece la coordenada inferior de la ventana de la proyección en bottom. Esto provoca una actualización de la matriz de proyección.

Nota: esto no tiene ningún efecto si el tipo de proyección es « Qt3DRender::QCameraLens::PerspectiveProjection ».

Nota: Funciónde configuración para la propiedad ` bottom`.

Véase también bottom().

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

Establece la lente de la cámara exposure

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

Véase también exposure().

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

Establece el plano lejano de la proyección en farPlane. Esto provoca una actualización de la matriz de proyección.

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

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

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

Establece el campo de visión de la proyección en fieldOfView grados. Esto provoca una actualización de la matriz de proyección.

Nota: esto no tiene ningún efecto si el tipo de proyección no es « Qt3DRender::QCameraLens::PerspectiveProjection ».

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

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

void QCameraLens::setFrustumProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)

Define una proyección ortográfica basada en left, right, bottom, top, nearPlane y farPlane.

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

Establece la coordenada de la esquina inferior izquierda de la ventana de la proyección en left. Esto provoca una actualización de la matriz de proyección.

Nota: esto no tiene ningún efecto si el tipo de proyección es Qt3DRender::QCameraLens::PerspectiveProjection.

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

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

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

Establece el plano cercano de la proyección en nearPlane. Esto provoca una actualización de la matriz de proyección.

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

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

void QCameraLens::setOrthographicProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)

Define una proyección ortográfica basada en left, right, bottom, top, nearPlane y farPlane.

void QCameraLens::setPerspectiveProjection(float fieldOfView, float aspectRatio, float nearPlane, float farPlane)

Define una proyección en perspectiva basada en fieldOfView, aspectRatio, nearPlane y farPlane.

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

Establece la matriz del proyecto en « projectionMatrix ».

Nota: Esto establecerá el tipo de proyección en « Qt3DRender::QCameraLens::CustomProjection » y, por lo tanto, ignorará todos los demás parámetros de la cámara que se hayan podido especificar.

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

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

[slot] void QCameraLens::setProjectionType(Qt3DRender::QCameraLens::ProjectionType projectionType)

Establece el tipo de proyección de la lente: projectionType.

Nota: Qt3DRender ::QCameraLens::Frustum y Qt3DRender::QCameraLens::PerspectiveProjection son dos formas diferentes de especificar la misma proyección.

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

Véase también projectionType().

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

Establece la coordenada superior derecha de la ventana de la proyección en right. Esto provoca una actualización de la matriz de proyección.

Nota: esto no tiene ningún efecto si el tipo de proyección es « Qt3DRender::QCameraLens::PerspectiveProjection ».

Nota: Funciónde configuración para la propiedad ` right`.

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

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

Establece la coordenada superior de la ventana de la proyección en top. Esto provoca una actualización de la matriz de proyección.

Nota: esto no tiene ningún efecto si el tipo de proyección es « Qt3DRender::QCameraLens::PerspectiveProjection ».

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

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

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