Qt3DRender::QCamera Class
class Qt3DRender::QCameraLa 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 ¢er, 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) |
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
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QCamera::TranslateViewCenter | 0 | Traslada el centro de la vista de modo que la dirección de la vista permanezca igual |
Qt3DRender::QCamera::DontTranslateViewCenter | 1 | No 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 ».
- QCameraLens::OrthographicProjection - Las líneas paralelas se ven paralelas. Los objetos parecen tener el mismo tamaño independientemente de la distancia.
- QCameraLens::PerspectiveProjection - Las líneas paralelas parecen converger en la distancia. Los objetos parecen reducirse cuanto más se alejan de la cámara.
- QCameraLens::FrustumProjection
- QCameraLens::CustomProjection
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 ¢er, 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.