Struct MultiTrackComposer 

pub struct MultiTrackComposer { /* private fields */ }

Composes multiple video layers onto a solid-colour canvas.

Layers are sorted by VideoLayer::z_order before compositing. The resulting FilterGraph is source-only — call FilterGraph::pull_video in a loop to extract the output frames. The graph terminates when the last (highest z_order) layer finishes.

Examples

use ff_filter::{AnimatedValue, MultiTrackComposer, VideoLayer};
use std::time::Duration;

let mut graph = MultiTrackComposer::new(1920, 1080)
    .add_layer(VideoLayer {
        source: "clip.mp4".into(),
        x: AnimatedValue::Static(0.0),
        y: AnimatedValue::Static(0.0),
        scale_x: AnimatedValue::Static(1.0),
        scale_y: AnimatedValue::Static(1.0),
        rotation: AnimatedValue::Static(0.0),
        opacity: AnimatedValue::Static(1.0),
        z_order: 0,
        time_offset: Duration::ZERO,
        in_point: None,
        out_point: None,
    })
    .build()?;

while let Some(frame) = graph.pull_video()? {
    // encode or display `frame`
}

Implementations

impl MultiTrackComposer

pub fn new(canvas_width: u32, canvas_height: u32) -> Self

Creates a new composer with a black canvas and no layers.

pub fn background(self, rgb: Rgb) -> Self

Sets the canvas background colour and returns the updated composer.

pub fn add_layer(self, layer: VideoLayer) -> Self

Appends a video layer and returns the updated composer.

pub fn build(self) -> Result<FilterGraph, FilterError>

Builds a source-only FilterGraph that composites all layers.

Errors

• FilterError::CompositionFailed — canvas width or height is zero, no layers were added, or an underlying FFmpeg graph-construction call failed.