Struct Camera 

pub struct Camera {
    pub x: f32,
    pub y: f32,
    pub zoom: f32,
    pub rotation: f32,
    pub origin: Option<CameraOrigin>,
    pub focus: f32,
    pub aperture: f32,
    pub rotate_x: f32,
    pub rotate_y: f32,
    pub perspective: f32,
    pub keyframes: Vec<CameraKeyframe>,
    pub motion_blur: Option<CameraMotionBlurConfig>,
}

Virtual camera for pan/zoom/rotation effects at the scene level.

Fields

x: f32

Camera center X offset from scene center (pixels). Default: 0.

y: f32

Camera center Y offset from scene center (pixels). Default: 0.

zoom: f32

Zoom factor. 1.0 = no zoom, 2.0 = 2x zoom in, 0.5 = zoom out.

rotation: f32

Rotation in degrees around the camera origin. Default: 0.

origin: Option<CameraOrigin>

Focal point for zoom/rotation, in frame pixels. Absent = frame centre (the historical behaviour). When the object is present, x/y default to 0 (top-left corner) — set both explicitly.

focus: f32

Depth the camera is focused on, on the same scale as style.depth. Default 1.0 — the plane an element sits on when it declares no depth, so a scenario that never mentions focus is focused on everything it has.

aperture: f32

How fast sharpness falls off away from focus, in blur pixels per unit of depth difference. Default 0.0 — no depth of field at all, which is what every scenario written before this rendered. 4.0 is a visible but readable separation; past 20.0 an out-of-focus plane reads as a colour wash.

Animate focus through keyframes for a rack focus; animating aperture instead opens and closes the effect without moving the focal plane.

rotate_x: f32

Tilt of the whole shot about the horizontal axis, in degrees, applied to each direct child of the scene scaled by its style.depth — the same rule parallax and focus already follow. Default 0.

rotate_y: f32

Tilt about the vertical axis, same convention. Default 0.

perspective: f32

Viewing distance for rotate_x/rotate_y, in pixels. One vanishing point for the whole shot — which is the difference from copying the same rotation onto every group, where each group gets its own. 0 means no perspective, an orthographic tilt. Default 0.

keyframes: Vec<CameraKeyframe>

Keyframe animations for camera properties.

motion_blur: Option<CameraMotionBlurConfig>

Blurs the frame across a shutter window when the camera itself is moving (pan, zoom, rotation or shake) — opt-in, since it renders samples sub-frame exposures and averages them instead of one. Absent (the default) renders exactly as before. Skipped on any frame where the resolved camera pose does not change across the window, so a static shot never pays the extra cost.

Implementations

impl Camera

pub fn resolve_property(&self, property: &str, time: f64) -> f32

Trait Implementations

impl Clone for Camera

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Camera

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Camera

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Camera

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl Serialize for Camera

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.