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 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.