Messages to control camera components and camera focus.
makes the receiving camera become the active camera
Post this message to a camera-component to activate it.
Several cameras can be active at the same time, but only the camera that was last activated will be used for rendering.
When the camera is deactivated (see release_camera_focus), the previously activated camera will again be used for rendering automatically.
The reason it is called "camera focus" is the similarity to how acquiring input focus works (see acquire_input_focus).
In the examples, it is assumed that the instance of the script has a camera-component with id "camera".
msg.post("#camera", "acquire_camera_focus")
deactivates the receiving camera
Post this message to a camera-component to deactivate it. The camera is then removed from the active cameras.
See acquire_camera_focus for more information how the active cameras are used in rendering.
In the examples, it is assumed that the instance of the script has a camera-component with id "camera".
msg.post("#camera", "release_camera_focus")
sets camera properties
Post this message to a camera-component to set its properties at run-time.
aspect_ratio -
number aspect ratio of the screen (width divided by height)
fov -
number field of view of the lens, measured as the angle in radians between the right and left edge
near_z -
number position of the near clipping plane (distance from camera along relative z)
far_z -
number position of the far clipping plane (distance from camera along relative z)
In the examples, it is assumed that the instance of the script has a camera-component with id "camera".
msg.post("#camera", "set_camera", {aspect_ratio = 16/9, fov = math.pi * 0.5, near_z = 0.1, far_z = 500})