Camera QML Type
Define un punto de vista desde el que se renderizará la escena. Más información...
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- aspectRatio : real
- bottom : real
- exposure : real
- farPlane : real
- fieldOfView : real
- left : real
- lens : CameraLens
- nearPlane : real
- position : vector3d
- projectionMatrix : matrix4x4
- projectionType : enumeration
- right : real
- top : real
- transform : Transform
- upVector : vector3d
- viewCenter : vector3d
- viewVector : vector3d
Métodos
- void pan(real angle)
- void pan(real angle, vector3d axis)
- void panAboutViewCenter(real angle)
- void panAboutViewCenter(real angle, vector3d axis)
- quaternion panRotation(real angle)
- void roll(real angle)
- void rollAboutViewCenter(real angle)
- quaternion rollRotation(real angle)
- void rotate(quaternion q)
- void rotateAboutViewCenter(quaternion q)
- quaternion rotation(real angle, vector3d axis)
- void tilt(real angle)
- void tiltAboutViewCenter(real angle)
- quaternion tiltRotation(real angle)
- void translate(vector3d vLocal, enumeration option)
- void translateWorld(vector3d vWorld, enumeration option)
- void viewAll()
- void viewEntity(Entity entity)
- void viewSphere(vector3d center, real radius)
Descripción detallada
Documentación de la propiedad
aspectRatio : real
Mantiene la relación de aspecto actual de la cámara.
bottom : real
Almacena la parte inferior actual de la cámara.
Esta propiedad solo es relevante cuando ` projectionType ` es `CameraLens.OrthographicProjection`.
exposure : real
Almacena la exposición actual de la cámara.
El valor por defecto es 0,0.
El MetalRoughMaterial, que se encuentra 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.
farPlane : real
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.
fieldOfView : real
Almacena el campo de visión vertical actual de la cámara 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 la elección de un objetivo gran angular (campo de visión horizontal amplio) o teleobjetivo (campo de visión horizontal estrecho), dependiendo de qué parte de la escena se desee capturar.
«fieldOfView» solo es relevante cuando « projectionType » es «CameraLens.PerspectiveProjection».
left : real
Almacena la coordenada «left» actual de la cámara.
Esta propiedad solo es relevante cuando « projectionType » es «CameraLens.OrthographicProjection».
lens : CameraLens [read-only]
Contiene el componente «CameraLens» de la cámara.
nearPlane : real
Mantiene 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.
position : vector3d
Almacena la posición actual de la cámara en coordenadas relativas a la entidad principal.
projectionMatrix : matrix4x4
Almacena la matriz de proyección actual de la cámara.
projectionType : enumeration
Almacena el tipo de proyección de la cámara. El valor por defecto es CameraLens.PerspectiveProjection.
- CameraLens.OrthographicProjection: las líneas paralelas se ven paralelas. Los objetos parecen tener el mismo tamaño independientemente de la distancia.
- CameraLens.PerspectiveProjection: las líneas paralelas parecen converger en la distancia. Los objetos parecen reducirse cuanto más se alejan de la cámara.
- CameraLens.FrustumProjection
- CameraLens.CustomProjection
Véase también Qt3DRender::QCameraLens::ProjectionType.
right : real
Contiene la proyección actual de la cámara.
Esta propiedad solo es relevante cuando ` projectionType ` es `CameraLens.OrthographicProjection`.
top : real
Almacena la posición actual de la parte superior de la cámara.
Esta propiedad solo es relevante cuando ` projectionType ` es `CameraLens.OrthographicProjection`.
transform : Transform [read-only]
Alberga el componente «Transform» de la cámara.
upVector : vector3d
Almacena el vector «up» actual de la cámara en coordenadas relativas a la entidad padre.
El vector «up» indica hacia qué dirección mira la parte superior de la cámara. Piensa en cuando haces 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, lo que te permite obtener una foto en vertical, en horizontal (¡o en ángulo!). «upVector» te permite controlar este tipo de movimiento.
viewCenter : vector3d
Almacena el centro de la vista actual 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.
viewVector : vector3d [read-only]
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).
Documentación del método
void pan(real angle)
Ajusta el ángulo de panorámica de la cámara en un angle e en grados.
void pan(real angle, vector3d axis)
Ajusta el desplazamiento horizontal de la cámara en torno al centro de la vista en angle grados en axis.
void panAboutViewCenter(real angle)
Ajusta el movimiento panorámico de la cámara alrededor del centro de la vista en angle grados.
void panAboutViewCenter(real angle, vector3d axis)
Ajusta el desplazamiento horizontal de la cámara en torno al centro de la vista en un valor de angle grados en axis.
quaternion panRotation(real angle)
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 a la izquierda o a la derecha sobre el eje Y.
void roll(real angle)
Ajusta la inclinación de la cámara en angle en grados.
void rollAboutViewCenter(real angle)
Ajusta el giro de la cámara en torno al centro de la vista en angle grados.
quaternion rollRotation(real angle)
Devuelve la rotación de balanceo calculada en relación con la « angle » (rotación de balanceo de la cámara), expresada en grados, que se tiene en cuenta para ajustar la rotación de balanceo o la inclinación hacia la izquierda o hacia la derecha de la cámara sobre el eje Z.
void rotate(quaternion q)
Gira la cámara utilizando un cuaternión en q.
void rotateAboutViewCenter(quaternion q)
Gira la cámara alrededor del centro de la vista utilizando un cuaternión en q.
quaternion rotation(real angle, vector3d axis)
Devuelve la rotación calculada en relación con el « angle » en grados y el « axis » seleccionado.
void tilt(real angle)
Ajusta el ángulo de inclinación de la cámara en angle en grados.
void tiltAboutViewCenter(real angle)
Ajusta la inclinación de la cámara respecto al centro de la vista en angle grados.
quaternion tiltRotation(real angle)
Devuelve la rotación de inclinación calculada en relación con el « angle » (ángulo de inclinación) 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.
void translate(vector3d vLocal, enumeration option)
Traslada la posición de la cámara y su vector de vista en vLocal en coordenadas locales. La propiedad ` option ` permite activar o desactivar el desplazamiento del centro de la vista.
- Camera.TranslateViewCenter
- Camera.DontTranslateViewCenter
Véase también ` Qt3DRender::QCamera::CameraTranslationOption`.
void translateWorld(vector3d vWorld, enumeration option)
Traslada la posición de la cámara y su vector de visión en vWorld en coordenadas del mundo. El parámetro « option » permite activar o desactivar si se debe trasladar el centro de la vista.
- Camera.TranslateViewCenter
- Camera.DontTranslateViewCenter
Véase también « Qt3DRender::QCamera::CameraTranslationOption ».
void viewAll()
Gira y desplaza la cámara de modo que su e viewCenter e quede en 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 ».
void viewEntity(Entity entity)
Gira y desplaza la cámara de modo que su « viewCenter » coincida con el centro del volumen delimitador de la entidad y que todo el « entity » 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 ».
void viewSphere(vector3d center, real radius)
Gira y desplaza la cámara de modo que su e viewCenter e 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.