Qt 5.7 | Qt Data Visualization | QML Types | Camera3D QML Type

Qt 5.7.1 Reference Documentation

# Camera3D QML Type

Representation of a camera in 3D space. More...

Import Statement: | import QtDataVisualization 1.2
Since: | QtDataVisualization 1.0
Instantiates: | Q3DCamera

- List of all members, including inherited members

## Properties

- cameraPreset : Camera3D.CameraPreset
- maxZoomLevel : float
- minZoomLevel : float
- target : vector3d
- wrapXRotation : bool
- wrapYRotation : bool
- xRotation : float
- yRotation : float
- zoomLevel : float

## Detailed Description

Camera3D represents a basic orbit around centerpoint 3D camera that is used when rendering the data visualization. The type offers simple methods for rotating the camera around the origin and setting zoom level.

For Camera3D enums, see Q3DCamera::CameraPreset.

## Property Documentation

cameraPreset : Camera3D.CameraPreset

This property contains the currently active camera preset, which is one of Camera3D.CameraPreset. If no preset is active the value is Camera3D.CameraPresetNone.

maxZoomLevel : float

This property contains the the maximum allowed camera zoom level. If the new maximum level is less than the existing minimum level, the minimum level is adjusted to the new maximum as well. If current zoomLevel is outside the new bounds, it is adjusted as well. Defaults to `500.0f`.

See also zoomLevel and minZoomLevel.

minZoomLevel : float

This property contains the the minimum allowed camera zoom level. If the new minimum level is more than the existing maximum level, the maximum level is adjusted to the new minimum as well. If current zoomLevel is outside the new bounds, it is adjusted as well. The minZoomLevel cannot be set below `1.0`. Defaults to `10.0`.

See also zoomLevel and maxZoomLevel.

target : vector3d

Holds the camera target as a vector3d. Defaults to `vector3d(0.0, 0.0, 0.0)`.

Valid coordinate values are between `-1.0...1.0`, where the edge values indicate the edges of the corresponding axis range. Any values outside this range are clamped to the edge.

Note: For bar graphs, the Y-coordinate is ignored and camera always targets a point on the horizontal background.

This QML property was introduced in QtDataVisualization 1.2.

wrapXRotation : bool

This property determines the behavior of the minimum and maximum limits in the X-rotation. By default the X-rotation wraps from minimum value to maximum and from maximum to minimum.

If set to `true` the X-rotation of the camera is wrapped from minimum to maximum and from maximum to minimum. If set to `false` the X-rotation of the camera is limited to the sector determined by minimum and maximum values.

wrapYRotation : bool

This property determines the behavior of the minimum and maximum limits in the Y-rotation. By default the Y-rotation is limited between the minimum and maximum values without any wrapping.

If `true` the Y-rotation of the camera is wrapped from minimum to maximum and from maximum to minimum. If `false` the Y-rotation of the camera is limited to the sector determined by minimum and maximum values.

xRotation : float

This property contains the X-rotation angle of the camera around the target point in degrees starting from the current base position.

yRotation : float

This property contains the Y-rotation angle of the camera around the target point in degrees starting from the current base position.

zoomLevel : float

This property contains the the camera zoom level in percentage. The default value of `100.0` means there is no zoom in or out set in the camera. The value is limited within the bounds defined by minZoomLevel and maxZoomLevel properties.

See also minZoomLevel and maxZoomLevel.