Skip to main content

CameraSettings

Other

3D camera settings used for reading and applying a full camera state. The distance value must match the Euclidean distance between position and focalPoint when the settings are applied through set_3d_camera_settings(). The viewUp vector must be non-zero and must not be parallel to the viewing direction. The renderer may slightly adjust the final clipping range after the settings are applied.

Import​

import ScriptingApi as api

# Access the class
# CameraSettings is available via api.CameraSettings

Properties​

position​

Camera position [x, y, z] in world coordinates.

Type: list

focal_point​

Camera focal point [x, y, z] in world coordinates.

Type: list

view_up​

Camera up direction [x, y, z]. Must be non-zero and not parallel to (focalPoint - position).

Type: list

distance​

Distance from the camera position to the focal point, in world units. Must be greater than zero and match the Euclidean distance between position and focalPoint.

Type: float

view_angle​

Camera view angle in degrees (used for perspective projection). Must be greater than 0 and less than 180.

Type: float

parallel_scale​

Parallel projection scale (used when the camera is in orthographic/parallel mode). Must be greater than zero.

Type: float

clipping_range​

Near and far clipping distances [near, far], in world units. near must be greater than zero and far must be greater than near.

Type: list

See Also​