Struct VideoConcatenator 

pub struct VideoConcatenator { /* private fields */ }

Concatenates multiple video clips into a single seamless output stream.

Each clip is loaded via a movie= source node. When output_resolution is set, a scale filter is inserted per clip to normalise all clips to a common resolution before concatenation. A single clip skips the concat filter and passes through directly.

The resulting FilterGraph is source-only — call FilterGraph::pull_video in a loop to extract the output frames.

Examples

use ff_filter::VideoConcatenator;

let mut graph = VideoConcatenator::new(vec!["clip_a.mp4", "clip_b.mp4"])
    .output_resolution(1280, 720)
    .build()?;

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

Implementations

impl VideoConcatenator

pub fn new(clips: Vec<impl AsRef<Path>>) -> Self

Creates a new concatenator for the given clip paths.

pub fn output_resolution(self, w: u32, h: u32) -> Self

Sets the output resolution. When provided, a scale=W:H filter is inserted per clip before concatenation.

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

Builds a source-only FilterGraph that concatenates all clips.

Errors

• FilterError::CompositionFailed — no clips were provided, or an underlying FFmpeg graph-construction call failed.