Obsolete Members for Camera | Qt 3D 5.12.8

- Qt 5.12
- Qt 3D
- QML Types
- Obsolete Members for Camera
- Qt 5.12.8 Reference Documentation

# Obsolete Members for Camera

The following members of QML type Camera are obsolete. They are provided to keep old source code working. We strongly advise against using them in new code.

## Properties

- aspectRatio : real
- bottom : real
- exposure : real
- farPlane : real
- fieldOfView : real
- left : real
- nearPlane : real
- position : vector3d
- projectionMatrix : matrix4x4
- projectionType : enumeration
- right : real
- top : real
- upVector : vector3d
- viewCenter : vector3d
- viewVector : vector3d

## Property Documentation

aspectRatio : real

Holds the current aspect ratio of the camera.

bottom : real

Holds the current bottom of the camera.

This property is only relevant when projectionType is CameraLens.OrthographicProjection.

exposure : real

Holds the current exposure of the camera.

The default value is 0.0.

The MetalRoughMaterial in Qt 3D Extras is currently the only provided material that makes use of camera exposure. Negative values will cause the material to be darker, and positive values will cause it to be lighter.

Custom materials may choose to interpret the value differently.

farPlane : real

Holds the current camera far plane of the camera. Objects that are farther from the camera than the farPlane will not be rendered.

fieldOfView : real

Holds the current vertical field of view of the camera in degrees.

Along with aspectRatio, this property determines how much of the scene is visible to the camera. In that respect you might think of it as analogous to choosing a wide angle (wide horizontal field of view) or telephoto (narrow horizontal field of view) lens, depending on how much of a scene you want to capture.

fieldOfView is only relevant when projectionType is CameraLens.PerspectiveProjection.

left : real

Holds the current left of the camera.

This property is only relevant when projectionType is CameraLens.OrthographicProjection.

nearPlane : real

Holds the current camera near plane of the camera. Objects that are closer to the camera than the nearPlane will not be rendered.

position : vector3d

Holds the current position of the camera in coordinates relative to the parent entity.

projectionMatrix : matrix4x4

Holds the current projection matrix of the camera.

projectionType : enumeration

Holds the type of the camera projection. The default value is CameraLens.PerspectiveProjection.

- CameraLens.OrthographicProjection - Parallel lines appear parallel. Objects appear the same size regardless of distance.
- CameraLens.PerspectiveProjection - Parallel lines appear to meet in the distance. Objects appear to shrink the farther they are from the camera.
- CameraLens.FrustumProjection
- CameraLens.CustomProjection

See also Qt3DRender::QCameraLens::ProjectionType.

right : real

Holds the current right of the camera.

This property is only relevant when projectionType is CameraLens.OrthographicProjection.

top : real

Holds the current top of the camera.

This property is only relevant when projectionType is CameraLens.OrthographicProjection.

upVector : vector3d

Holds the current up vector of the camera in coordinates relative to the parent entity.

The up vector indicates which direction the top of the camera is facing. Think of taking a picture: after positioning yourself and pointing the camera at your target, you might rotate the camera left or right, giving you a portrait or landscape (or angled!) shot. upVector allows you to control this type of movement.

viewCenter : vector3d

Holds the current view center of the camera in coordinates relative to the parent entity.

Intuitively, the viewCenter is the location the camera is pointing at.

[read-only] viewVector : vector3d

Holds the camera's view vector in coordinates relative to the parent entity.

This vector decribes the displacement from the camera (position) to its target (viewCenter).