Camera3D QML Type
Representation of a camera in 3D space. More...
Import Statement: | import QtDataVisualization 1.2 |
Since: | QtDataVisualization 1.0 |
Instantiates: | Q3DCamera |
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.
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.
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.
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.
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.
This property contains the X-rotation angle of the camera around the target point in degrees starting from the current base position.
This property contains the Y-rotation angle of the camera around the target point in degrees starting from the current base position.
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.