En esta página

Camera QML Type

Define una clase base abstracta para las cámaras. Más...

Import Statement: import QtQuick3D
Inherits:

Node

Inherited By:

CustomCamera, FrustumCamera, OrthographicCamera, and PerspectiveCamera

Propiedades

Métodos

Descripción detallada

Una cámara define cómo se proyecta el contenido de la escena 3D sobre una superficie 2D, como una « View3D ». Una escena necesita al menos una cámara para poder visualizar su contenido.

Es posible colocar y girar la cámara como cualquier otro objeto espacial ( Node ) de la escena. La ubicación y la orientación del frustum ( Node) determinan dónde se encuentra la cámara en la escena y en qué dirección está orientada. La orientación predeterminada de la cámara 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.

Junto con la posición y la orientación, el frustum define qué partes de una escena son visibles para la cámara y cómo se proyectan sobre la superficie 2D. Los diferentes subtipos de cámara ofrecen múltiples opciones para determinar la forma del frustum de la cámara.

  • PerspectiveCamera proporciona una cámara con un frustum piramidal, en el que los objetos se proyectan de tal forma que los más alejados de la cámara parecen más pequeños. Este es el tipo de cámara más utilizado y se corresponde con el funcionamiento de la mayoría de las cámaras del mundo real.
  • OrthographicCamera proporciona una cámara en la que las líneas del frustum son paralelas, lo que hace que la escala percibida de un objeto no se vea afectada por su distancia a la cámara. Los casos de uso típicos de este tipo de cámara son las aplicaciones de CAD (diseño asistido por ordenador) y la cartografía.
  • FrustumCamera es un tipo de cámara en perspectiva en la que el tronco de pirámide se puede personalizar libremente mediante las coordenadas de su intersección con el plano cercano. Puede resultar útil si se necesita un tronco de pirámide asimétrico.
  • CustomCamera es un tipo de cámara en la que la matriz de proyección se puede personalizar libremente, y puede resultar útil para usuarios avanzados que deseen calcular su propia matriz de proyección.

Para ilustrar la diferencia, estas capturas de pantalla muestran la misma escena proyectada por una cámara « PerspectiveCamera » y una « OrthographicCamera ». Fíjate en cómo el recuadro rojo es más pequeño que el verde en la imagen renderizada con la proyección en perspectiva.

Cámara en perspectivaCámara ortográfica

Vista en perspectiva de la placa desde la cámara

Vista ortográfica de la placa tomada con una cámara

Véase también Qt Quick 3D - Ejemplo View3D.

Documentación de propiedades

frustumCullingEnabled : bool

Cuando esta propiedad se establece en « true », los objetos que se encuentren fuera del frustum de la cámara se descartarán, lo que significa que no se pasarán al renderizador. Por defecto, esta propiedad está configurada en « false ». En escenas en las que todos o la mayoría de los objetos se encuentran dentro del frustum de la cámara, el descartado por frustum supone una sobrecarga innecesaria para el rendimiento. Sin embargo, en escenas complejas en las que gran parte de los objetos se encuentran fuera del campo de visión de la cámara, activar el culling del frustum puede mejorar el rendimiento.

levelOfDetailBias : real [since 6.5]

Esta propiedad modifica el tamaño que debe tener un modelo al renderizarse antes de que se utilicen las mallas de nivel de detalle automáticas. Cada malla de nivel de detalle generada contiene un valor de tamaño ideal con el que debe mostrarse cada nivel, que representa la proporción de la escena renderizada que ocupará dicha malla. Un modelo que solo representa unos pocos píxeles en pantalla no requerirá toda la geometría para verse correctamente, por lo que, en este caso, se utilizará en su lugar una malla de menor nivel de detalle. Este valor es un sesgo respecto al valor ideal, de modo que un valor inferior a 1.0 requerirá un tamaño renderizado aún menor antes de pasar a un nivel de detalle inferior. Los valores superiores a 1.0 harán que se utilicen niveles de detalle más bajos antes de lo previsto. Un valor de 0.0 desactivará por completo el uso de los niveles de detalle.

El valor por defecto es 1.0

Nota: Esta propiedad solo tendrá efecto en los modelos cuya geometría contenga niveles de detalle.

Esta propiedad se introdujo en Qt 6.5.

Véase también Model::levelOfDetailBias.

lookAtNode : Node

Si esta propiedad se establece en el valor « non-null », la rotación de esta cámara se actualiza automáticamente para que la cámara siga apuntando al nodo especificado cada vez que cambie la posición de la escena de esta cámara o la del nodo especificado. Por defecto, esta propiedad está establecida en « null ».

Véase también lookAt.

Documentación de métodos

vector3d lookAt(QtQuick3D::Node node)

Establece el valor de rotación de la cámara para que apunte hacia node.

vector3d lookAt(vector3d scenePos)

Establece el valor de rotación de la cámara para que apunte hacia scenePos.

vector3d mapFromViewport(vector3d viewportPos)

Transforma ` viewportPos ` del espacio de la ventana gráfica (2D) al espacio global de la escena (3D).

Los valores x e y de ` viewportPos ` deben estar normalizados, de modo que la esquina superior izquierda de la ventana de visualización se sitúe en [0, 0] y la esquina inferior derecha en [1, 1]. El valor z se interpreta como la distancia desde el plano de recorte cercano del frustum (clipNear).

Si no es posible asignar correctamente ` viewportPos ` a una posición en la escena, se devuelve la posición [0, 0, 0].

Véanse también mapToViewport y View3D.mapTo3DScene().

vector3d mapToViewport(vector3d scenePos)

Transforma « scenePos » del espacio global de la escena (3D) al espacio de la ventana gráfica (2D).

La posición devuelta está normalizada, con la esquina superior izquierda de la ventana de visualización en [0, 0] y la esquina inferior derecha en [1, 1]. El valor z devuelto contendrá la distancia desde el plano de recorte cercano del frustum (clipNear) hasta scenePos en coordenadas de escena. Si la distancia es negativa, el punto se encuentra detrás de la cámara.

Si no es posible asignar correctamente « scenePos » a una posición en la ventana de visualización, se devuelve la posición [0, 0, 0].

Véanse también mapFromViewport() y View3D.mapFrom3DScene().

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