Camera QML Type

Define un punto de vista a través del cual se renderizará la escena. Más...

• Lista de todos los miembros, incluidos los heredados
• Miembros obsoletos

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

Mantiene el fondo actual de la cámara.

Esta propiedad sólo es relevante cuando projectionType es CameraLens.OrthographicProjection.

exposure : real

Mantiene la exposición actual de la cámara.

El valor por defecto es 0.0.

El MetalRoughMaterial en Qt 3D Extras es actualmente el único material proporcionado que hace uso de la exposición de la cámara. Valores negativos harán que el material sea más oscuro, y valores positivos harán que sea más claro.

Los materiales personalizados pueden elegir interpretar el valor de forma diferente.

farPlane : real

Mantiene el plano lejano actual de la cámara. Los objetos que estén más lejos de la cámara que el farPlane no se renderizarán.

fieldOfView : real

Indica 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 este sentido, puede considerarse análoga a la elección de un objetivo gran angular (amplio campo de visión horizontal) o teleobjetivo (estrecho campo de visión horizontal), dependiendo de la parte de la escena que desee capturar.

fieldOfView sólo es relevante cuando projectionType es CameraLens.PerspectiveProjection.

left : real

Mantiene la izquierda actual de la cámara.

Esta propiedad sólo 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 estén más cerca de la cámara que el nearPlane no se renderizarán.

position : vector3d

Mantiene la posición actual de la cámara en coordenadas relativas a la entidad padre.

projectionMatrix : matrix4x4

Contiene la matriz de proyección actual de la cámara.

projectionType : enumeration

Indica el tipo de proyección de la cámara. El valor por defecto es CameraLens.PerspectiveProjection.

• CameraLens.OrthographicProjection - Las líneas paralelas aparecen paralelas. Los objetos aparecen del mismo tamaño independientemente de la distancia.
• CameraLens.PerspectiveProjection - Las líneas paralelas parecen encontrarse en la distancia. Los objetos parecen encogerse cuanto más lejos están de la cámara.
• CameraLensProyecciónFrustum
• CameraLensProyección personalizada

Véase también Qt3DRender::QCameraLens::ProjectionType.

right : real

Mantiene el derecho actual de la cámara.

Esta propiedad sólo es relevante cuando projectionType es CameraLens.OrthographicProjection.

top : real

Mantiene el tope actual de la cámara.

Esta propiedad sólo es relevante cuando projectionType es CameraLens.OrthographicProjection.

transform : Transform [read-only]

Contiene el componente Transformación de la cámara.

upVector : vector3d

Mantiene el vector ascendente actual de la cámara en coordenadas relativas a la entidad padre.

El vector superior indica en qué dirección está orientada la parte superior de la cámara. Piensa en hacer una foto: después de posicionarte y apuntar con la cámara a tu objetivo, puedes girar la cámara a la izquierda o a la derecha, obteniendo un retrato o un paisaje (¡o un ángulo!). upVector te permite controlar este tipo de movimiento.

viewCenter : vector3d

Mantiene el centro de vista actual de la cámara en coordenadas relativas a la entidad padre.

Intuitivamente, el viewCenter es la ubicación a la que apunta la cámara.

viewVector : vector3d [read-only]

Contiene el vector de vista de la cámara en coordenadas relativas a la entidad padre.

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 panorámico de la cámara en angle en grados.

void pan(real angle, vector3d axis)

Ajusta la panorámica de la cámara alrededor del centro de la vista en angle en grados en axis.

void panAboutViewCenter(real angle)

Ajusta la panorámica de la cámara alrededor del centro de la vista en angle en grados.

void panAboutViewCenter(real angle, vector3d axis)

Ajusta la panorámica de la cámara alrededor del centro de la vista en angle en grados en axis.

quaternion panRotation(real angle)

Devuelve la rotación panorámica calculada en relación con angle en grados tomados para ajustar la rotación panorámica o izquierda/derecha de la cámara en el eje Y.

void roll(real angle)

Ajusta el rollo de la cámara en angle en grados.

void rollAboutViewCenter(real angle)

Ajusta el giro de la cámara alrededor del centro de la vista en angle en grados.

quaternion rollRotation(real angle)

Devuelve la rotación de balanceo calculada en relación a angle en grados tomados para ajustar la rotación de balanceo o inclinación izquierda/derecha de la cámara en el eje Z.

void rotate(quaternion q)

Rota la cámara con el uso de un Quaternion en q.

void rotateAboutViewCenter(quaternion q)

Rota la cámara alrededor del centro de la vista con el uso de un Quaternion en q.

quaternion rotation(real angle, vector3d axis)

Devuelve la rotación calculada con respecto a la angle en grados y elegida axis tomada en.

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 en grados.

quaternion tiltRotation(real angle)

Devuelve la rotación de inclinación calculada en relación a angle en grados tomados para ajustar la inclinación de la cámara o la rotación arriba/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. option permite cambiar si el centro de vista debe ser trasladado.

• Cámara.TraducirCentroVista
• Camera.DontTranslateCentroVista

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 vista en vWorld en coordenadas globales. option permite cambiar si el centro de vista debe ser trasladado.

• Cámara.TraducirCentroVista
• Camera.DontTranslateCentroVista

Véase también Qt3DRender::QCamera::CameraTranslationOption.

void viewAll()

Rota y mueve la cámara para que su viewCenter sea el centro del volumen de la escena y toda la escena quepa en el puerto de vista.

Ver también Qt3D.Render::Camera::projectionType.

void viewEntity(Entity entity)

Rota y mueve la cámara para que su viewCenter sea el centro del volumen delimitador de la entidad y todo el entity quepa en el puerto de vista.

Véase también Qt3D.Render::Camera::projectionType.

void viewSphere(vector3d center, real radius)

Rota y mueve la cámara para que su viewCenter sea center y una esfera de radius quepa en el puerto de visión.

Ver también Qt3D.Render::Camera::projectionType.