Struct FilterGraph 

pub struct FilterGraph { /* private fields */ }

An FFmpeg libavfilter filter graph.

Constructed via FilterGraph::builder(). The underlying AVFilterGraph is initialised lazily on the first push call, deriving format information from the first frame.

Examples

use ff_filter::FilterGraph;

let mut graph = FilterGraph::builder()
    .scale(1280, 720)
    .build()?;

// Push decoded frames in …
graph.push_video(0, &video_frame)?;

// … and pull filtered frames out.
while let Some(frame) = graph.pull_video()? {
    // use frame
}

Implementations

impl FilterGraph

pub fn builder() -> FilterGraphBuilder

Create a new builder.

pub fn output_resolution(&self) -> Option<(u32, u32)>

Returns the output resolution produced by this graph’s scale filter step, if one was configured.

When multiple scale steps are chained, the last one’s dimensions are returned. Returns None when no scale step was added.

pub fn push_video( &mut self, slot: usize, frame: &VideoFrame, ) -> Result<(), FilterError>

Push a video frame into input slot slot.

On the first call the filter graph is initialised using this frame’s format, resolution, and time base.

Errors

• FilterError::InvalidInput if slot is out of range.
• FilterError::BuildFailed if the graph cannot be initialised.
• FilterError::ProcessFailed if the FFmpeg push fails.

pub fn pull_video(&mut self) -> Result<Option<VideoFrame>, FilterError>

Pull the next filtered video frame, if one is available.

Returns None when the internal FFmpeg buffer is empty (EAGAIN) or at end-of-stream.

Errors

Returns FilterError::ProcessFailed on an unexpected FFmpeg error.

pub fn push_audio( &mut self, slot: usize, frame: &AudioFrame, ) -> Result<(), FilterError>

Push an audio frame into input slot slot.

On the first call the audio filter graph is initialised using this frame’s format, sample rate, and channel count.

Errors

• FilterError::InvalidInput if slot is out of range.
• FilterError::BuildFailed if the graph cannot be initialised.
• FilterError::ProcessFailed if the FFmpeg push fails.

pub fn pull_audio(&mut self) -> Result<Option<AudioFrame>, FilterError>

Pull the next filtered audio frame, if one is available.

Returns None when the internal FFmpeg buffer is empty (EAGAIN) or at end-of-stream.

Errors

Returns FilterError::ProcessFailed on an unexpected FFmpeg error.

Trait Implementations

impl Debug for FilterGraph

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

Formats the value using the given formatter.