- Qt 6.8
- Qt Data Visualization
- QML Types
- Camera3D
- Qt Data Visualization | Commercial or GPLv3

# Camera3D QML Type

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

Import Statement: | `import QtDataVisualization 1.8`
Since: | QtDataVisualization 1.0
In C++: | Q3DCamera

- List of all members, including inherited members

## Properties

- cameraPreset : Camera3D.CameraPreset
- maxZoomLevel : real
- minZoomLevel : real
- target : vector3d `(since QtDataVisualization 1.2)`
- wrapXRotation : bool
- wrapYRotation : bool
- xRotation : real
- yRotation : real
- zoomLevel : real

## 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

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

maxZoomLevel : real

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

See also zoomLevel and minZoomLevel.

minZoomLevel : real

Sets the minimum allowed camera zoom level. If the new minimum level is higher than the existing maximum level, the maximum level is adjusted to the new minimum as well. If the 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 `[since QtDataVisualization 1.2]`

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 property was introduced in QtDataVisualization 1.2.

wrapXRotation : bool

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 the minimum and maximum values.

wrapYRotation : bool

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 the minimum and maximum values.

xRotation : real

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

yRotation : real

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

zoomLevel : real

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 by the minZoomLevel and maxZoomLevel properties.

See also minZoomLevel and maxZoomLevel.