The ChartSurface3D Camera 3D API
In SciChart, the Camera 3D is defined by the ICameraController instance. It's accessible through camera property. This interface is implemented in Camera3D class which instance is used by SciChartSurface3D by default.
Note
The Above is the representation of a Camera in 3D Space. The camera is attached to the camera property and is defined by a position, target and other properties which defines the properties of the viewport.
Camera3D Position, Target
The camera is defined by the position and target properties, which are XYZ vectors in World Coordinates, as well as projectionMode which is defined by CameraProjectionMode enumeration.
Camera3D properties which define the viewport as seen by the camera are listed below:
| Property | Description |
|---|---|
| position | Defines the position of the camera as an XYZ Vector in the World Coordinates. |
| target | Defines the target of the camera as an XYZ Vector in the World Coordinates. |
| orbitalPitch | Defines the Pitch angle of the camera position relative to the target. Expects degrees. |
| orbitalYaw | Defines the Yaw angle of the camera position relative to the target. Expects degrees. |
| radius | The distance of the Camera Position to the Camera Target. |
| aspectRatio | Defines the viewport aspect ratio. |
| projectionMode | Defines whether the camera is Perspective or Orthogonal which is CameraProjectionMode enum. |
| orthoWidth | Defines the width of the projected viewport when projectionMode is Orthogonal. |
| orthoHeight | Defines the height of the projected viewport when projectionMode is Orthogonal. |
| fieldOfView | Defines the Field of View Angle of the Camera in Degrees. |
| nearClip | Defines the Near Clipping distance of the camera. |
| farClip | Defines the Far Clipping distance of the camera. |
The Modify Camera3D Properties example shows how to manipulate the camera, and how to switch between perspective and orthogonal modes.
Note
The Modify Camera3D Properties example can be found in the SciChart Android Examples Suite as well as on GitHub: