En esta página

Camera QML Type

Define un punto de vista desde el que se renderizará la escena. Más información...

Import Statement: import Qt3D.Render 2.12
In C++: QCamera
Inherits:

Entity

Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Métodos

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.