Camera

class dazpy.DazCamera(client, identifier)

Bases: DazNode

Proxy for a DzCamera node.

Extends DazNode with optical and image-sensor properties.

property focal_length: float | None

Focal length in millimetres (read/write).

property fov: float | None

Field of view in degrees (read-only; derived from focal length).

property depth_of_field: bool | None

Whether depth-of-field simulation is enabled (read/write).

property lens_shift_x: float | None

Horizontal lens shift in millimetres (read/write).

Confirmed against a live instance: backed by DzCamera’s “Lens Shift X (mm)” property (getLensShiftXControl()), the same value the render engine uses – needed to match depth-based effects (fog, DOF-driven line weight) to the actual render.

property lens_shift_y: float | None

Vertical lens shift in millimetres (read/write).

See lens_shift_x.

property f_stop: float | None

Aperture / f-stop – controls depth-of-field blur intensity (read/write).

Confirmed against a live instance: backed by DzCamera’s “F/Stop” property (property name Aperature – note the engine’s own spelling – via getFStopControl()). Only affects the render when depth_of_field is enabled; lower values (wider aperture) produce stronger blur.

property aperture_blades: int | None

Bokeh blade count (read/write).

Confirmed against a live instance: backed by DzCamera’s “Aperture Blades” property (getApertureNumBladesControl()). 0 produces a circular bokeh; 3+ produces a polygonal bokeh with that many sides.

property aperture_blade_rotation: float | None

Bokeh polygon rotation angle in degrees (read/write).

Confirmed against a live instance: backed by DzCamera’s “Aperture Blade Rotation” property (getApertureBladeRotationAngleControl()). Only visible in the render when aperture_blades is 3 or greater.

property frame_width: float | None

Sensor / film-gate width in millimetres (read-only).

property focal_distance: float | None

Distance to the focus plane (read/write).

property aspect_width: float | None

Render aspect ratio width component (read/write).

property aspect_height: float | None

Render aspect ratio height component (read/write).

property pixels_width: int | None

Render image width in pixels (read/write).

property pixels_height: int | None

Render image height in pixels (read/write).

property near_clipping_plane: float | None

Near clipping plane distance (read-only).

property far_clipping_plane: float | None

Far clipping plane distance (read-only).

aim_at(x, y, z)

Point the camera at a world-space coordinate.

Parameters:

• x (float) – Target X coordinate.

• y (float) – Target Y coordinate.

• z (float) – Target Z coordinate.

focal_point()

Return the world-space focal point as {"x", "y", "z"}.

is_view_camera()

Return True if this is the active viewport camera.