Tools reference

Cameras & Lights

Add and configure cameras (including depth of field) and lights. Set 3D material options on layers.

Camera and light layers only work in compositions with the 3D renderer enabled (Classic 3D, Advanced 3D, or CINEMA 4D). Use set_comp_renderer to switch renderers.

Cameras

Cameras control the viewpoint in a 3D composition. One-Node cameras move freely; Two-Node cameras always point at a target point of interest.

add_camera_layer

Add a camera layer with specified type (One-Node or Two-Node) and preset (e.g. 50mm, 35mm).

set_camera_options

Set camera properties: zoom, focal length, field of view, film size.

set_camera_dof

Configure depth of field: enable/disable, focus distance, aperture, blur level.

get_layer_info

Get layer info for a camera layer — includes camera type and current options.

Lights

Lights illuminate 3D layers. Ambient lights affect the whole scene. Spot, Point, and Parallel lights can cast shadows and be aimed.

add_light_layer

Add a light layer with specified type: Ambient, Spot, Point, or Parallel.

set_light_options

Configure light properties: intensity, color, cone angle, cone feather, shadow settings.

list_lights_cameras

List all camera and light layers in a composition.

Material options

set_material_options

Set 3D material options on a layer: casts shadows, accepts shadows, accepts lights, ambient, diffuse, specular, shininess.