PerspectiveCamera QML Type
Define una cámara en perspectiva para visualizar el contenido de una escena 3D. Más...
| Import Statement: | import QtQuick3D |
| Inherits: | |
| Inherited By: |
Propiedades
- clipFar : real
- clipNear : real
- fieldOfView : real
- fieldOfViewOrientation : enumeration
Descripción detallada
Un « Camera » define cómo se proyecta el contenido de la escena 3D sobre una superficie 2D, como un « View3D ». Una escena necesita al menos un « Camera » para visualizar su contenido.
Es posible colocar y girar la « Camera » como cualquier otro objeto espacial Node de la escena. La ubicación y la orientación de la « Node » determinan dónde se encuentra la « Camera » en la escena y en qué dirección está orientada. La orientación predeterminada de la « Camera » tiene su vector de avance apuntando a lo largo del eje Z negativo y su vector de arriba a lo largo del eje Y positivo.

PerspectiveCamera es el tipo estándar de « Camera ». Ofrece una proyección realista de la escena, en la que los objetos lejanos se perciben como más pequeños. El frustum se define mediante la propiedad « fieldOfView », así como mediante los planos de recorte cercano y lejano.
El siguiente ejemplo crea una PerspectiveCamera en la posición [0, 200, 300] de la escena, con un campo de visión de 90 grados y una inclinación hacia abajo de 30 grados.
PerspectiveCamera {
position: Qt.vector3d(0, 200, 300)
eulerRotation.x: -30
fieldOfView: 90
}Véase también Qt Quick 3D - Ejemplo View3D, OrthographicCamera, FrustumCamera y CustomCamera.
Documentación de propiedades
clipFar : real
Esta propiedad define el plano de recorte lejano del frustum de la cámara « PerspectiveCamera ». La geometría que se encuentre más lejos de la cámara « Camera » que el plano de recorte lejano no será visible.
El valor por defecto es 10000,0. La unidad depende de las unidades geométricas del usuario, y el valor es relativo a la posición global de la cámara.
clipNear : real
Esta propiedad define el plano de recorte cercano del frustum de la cámara « PerspectiveCamera ». La geometría que se encuentre más cerca de la « Camera » que el plano de recorte cercano no será visible.
El valor por defecto es 10,0. La unidad depende de las unidades geométricas del usuario, y el valor es relativo a la posición global de la cámara.
fieldOfView : real
Esta propiedad contiene el campo de visión de la cámara en grados. Puede tratarse del campo de visión vertical u horizontal, dependiendo de si la propiedad « fieldOfViewOrientation » está establecida en « PerspectiveCamera.Vertical » o « PerspectiveCamera.Horizontal ».
El valor por defecto es 60,0.
fieldOfViewOrientation : enumeration
Esta propiedad define la orientación en la que se muestra el campo de visión de la cámara.
| Constante | Descripción |
|---|---|
PerspectiveCamera.Vertical | El campo de visión proporcionado es vertical, lo que significa que el campo de visión es el ángulo entre la línea trazada desde la cámara hasta el centro superior de la ventana de visualización y la línea trazada desde la cámara hasta el centro inferior de la ventana de visualización. La relación de aspecto horizontal se ajustará para mantener la relación de aspecto. |
PerspectiveCamera.Horizontal | El campo de visión especificado es horizontal, lo que significa que el campo de visión es el ángulo entre la línea trazada desde la cámara hasta el centro del lado izquierdo de la ventana de visualización y la línea trazada desde la cámara hasta el centro del lado derecho de la ventana de visualización. La relación de aspecto vertical se ajustará para mantener la relación de aspecto. |
El valor por defecto es PerspectiveCamera.Vertical.
© 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.