QCamera Class

This enum specifies how camera view center is translated

Holds the current aspect ratio.

Access functions:

• float aspectRatio() const

• void setAspectRatio(float aspectRatio)

Notifier signal:

• void aspectRatioChanged(float aspectRatio)

Holds the current bottom of the camera.

This property is only relevant when projectionType is QCameraLens::OrthographicProjection.

Access functions:

• float bottom() const

• void setBottom(float bottom)

Notifier signal:

• void bottomChanged(float bottom)

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.

Access functions:

• float exposure() const

• void setExposure(float exposure)

Notifier signal:

• void exposureChanged(float exposure)

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

Access functions:

• float farPlane() const

• void setFarPlane(float farPlane)

Notifier signal:

• void farPlaneChanged(float farPlane)

Holds the current vertical field of view 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 QCameraLens::PerspectiveProjection.

Access functions:

• float fieldOfView() const

• void setFieldOfView(float fieldOfView)

Notifier signal:

• void fieldOfViewChanged(float fieldOfView)

Holds the current left of the camera.

This property is only relevant when projectionType is QCameraLens::OrthographicProjection.

Access functions:

• float left() const

• void setLeft(float left)

Notifier signal:

• void leftChanged(float left)

Holds the Qt3DRender::QCameraLens component of the camera.

This property was introduced in Qt 5.14.

Access functions:

• *lens() const

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

Access functions:

• float nearPlane() const

• void setNearPlane(float nearPlane)

Notifier signal:

• void nearPlaneChanged(float nearPlane)

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

Access functions:

• position() const

• void setPosition(const &position)

Notifier signal:

• void positionChanged(const &position)

Holds the current projection matrix of the camera.

Access functions:

• projectionMatrix() const

• void setProjectionMatrix(const &projectionMatrix)

Notifier signal:

• void projectionMatrixChanged(const &projectionMatrix)

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

• QCameraLens::OrthographicProjection - Parallel lines appear parallel. Objects appear the same size regardless of distance.

• QCameraLens::PerspectiveProjection - Parallel lines appear to meet in the distance. Objects appear to shrink the farther they are from the camera.

• QCameraLens::FrustumProjection

• QCameraLens::CustomProjection

Access functions:

• projectionType() const

• void setProjectionType( type)

Notifier signal:

• void projectionTypeChanged( projectionType)

See Also▲

Holds the current right of the camera.

This property is only relevant when projectionType is QCameraLens::OrthographicProjection.

Access functions:

• float right() const

• void setRight(float right)

Notifier signal:

• void rightChanged(float right)

Holds the current top of the camera.

This property is only relevant when projectionType is QCameraLens::OrthographicProjection.

Access functions:

• float top() const

• void setTop(float top)

Notifier signal:

• void topChanged(float top)

Holds the Qt3DCore::QTransform component of the camera.

This property was introduced in Qt 5.14.

Access functions:

• *transform() const

Holds the camera's up vector 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.

Access functions:

• upVector() const

• void setUpVector(const &upVector)

Notifier signal:

• void upVectorChanged(const &upVector)

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

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

Access functions:

• viewCenter() const

• void setViewCenter(const &viewCenter)

Notifier signal:

• void viewCenterChanged(const &viewCenter)

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

Access functions:

• viewVector() const

Notifier signal:

• void viewVectorChanged(const &viewVector)

Creates a new QCamera instance with the specified parent.

Returns the current lens.

Adjusts the pan angle of the camera by angle in degrees.

Adjusts the pan angle of the camera by angle in degrees on a chosen axis.

Adjusts the camera pan about view center by angle in degrees.

Adjusts the camera pan about view center by angle in degrees on axis.

Returns the calculated pan rotation in relation to the angle in degrees taken in to adjust the camera's pan or left/right rotation on the Y axis.

Adjusts the camera roll by angle in degrees.

Adjusts the camera roll about view center by angle in degrees.

Returns the calculated roll rotation in relation to the angle in degrees taken in to adjust the camera's roll or lean left/right rotation on the Z axis.

Rotates the camera with the use of a Quaternion in q.

Rotates the camera about the view center with the use of a Quaternion in q.

Returns the calculated rotation in relation to the angle in degrees and chosen axis taken in.

Sets the camera's aspect ratio to aspectRatio.

See Also▲

Sets the bottom of the camera to bottom.

See Also▲

Sets the camera's exposure to exposure.

See Also▲

Sets the camera's far plane to farPlane

See Also▲

Sets the camera's field of view to fieldOfView in degrees.

See Also▲

Sets the left of the camera to left.

See Also▲

Sets the camera's near plane to nearPlane.

See Also▲

Sets the camera's position in 3D space to position.

See Also▲

Sets the camera's projection matrix to projectionMatrix.

See Also▲

Sets the camera's projection type to type.

See Also▲

Sets the right of the camera to right.

See Also▲

Sets the top of the camera to top.

See Also▲

Sets the camera's up vector to upVector.

See Also▲

Sets the camera's view center to viewCenter.

See Also▲

Adjusts the tilt angle of the camera by angle in degrees.

Adjusts the camera tilt about view center by angle in degrees.

Returns the calculated tilt rotation in relation to the angle in degrees taken in to adjust the camera's tilt or up/down rotation on the X axis.

Returns the camera's position via transform.

Translates the camera's position and its view vector by vLocal in local coordinates. The option allows for toggling whether the view center should be translated.

Translates the camera's position and its view vector by vWorld in world coordinates. The option allows for toggling whether the view center should be translated.

Rotates and moves the camera so that it's viewCenter is the center of the scene's bounding volume and the entire scene fits in the view port.

See Also▲

Rotates and moves the camera so that it's viewCenter is the center of the entity's bounding volume and the entire entity fits in the view port.

See Also▲

Rotates and moves the camera so that it's viewCenter is center and a sphere of radius fits in the view port.

See Also▲

[read-only] viewMatrix : const QMatrix4x4▲