En esta página

PerspectiveCamera QML Type

Define una cámara en perspectiva para ver el contenido de una escena 3D. Más...

Import Statement: import QtQuick3D
Inherits:

Camera

Inherited By:

FrustumCamera

Propiedades

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 poder visualizar su contenido.

Es posible posicionar y rotar el Camera como cualquier otro Node espacial de la escena. La ubicación y orientación de Node determinan dónde se encuentra Camera en la escena y en qué dirección está orientado. La orientación por defecto del Camera tiene su vector hacia delante apuntando a lo largo del eje Z negativo y su vector hacia arriba a lo largo del eje Y positivo.

Diagrama de proyección de cámara en perspectiva

PerspectiveCamera es el tipo estándar de Camera. Proporciona una proyección realista de la escena, en la que los objetos distantes se perciben como más pequeños. El frustum está definido por la propiedad fieldOfView así como por los planos de recorte cercano y lejano.

El siguiente ejemplo crea una PerspectiveCamera en la posición [0, 200, 300] de la escena, un campo de visión de 90 grados y con 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 - View3D Example, OrthographicCamera, FrustumCamera, y CustomCamera.

Documentación de propiedades

clipFar : real

Esta propiedad define el plano de recorte lejano del frustum de PerspectiveCamera. La geometría que esté más lejos de Camera que el plano de recorte lejano no será visible.

El valor por defecto es 10000.0. La unidad depende de las unidades de geometría 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 PerspectiveCamera. La geometría que esté más cerca de Camera que el plano de recorte cercano no será visible.

El valor por defecto es 10.0. La unidad depende de las unidades de geometría 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 ser el 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 mantiene la orientación en la que se da el campo de visión de la cámara.

ConstanteDescripción
PerspectiveCamera.VerticalEl 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 gráfica y la línea desde la cámara hasta el centro inferior de la ventana gráfica. La relación de aspecto horizontal se ajustará para mantener la relación de aspecto.
PerspectiveCamera.HorizontalEl campo de visión proporcionado 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 izquierdo de la ventana y la línea trazada desde la cámara hasta el centro derecho de la ventana. 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.