Struct NativeAvEncodeSink 

pub struct NativeAvEncodeSink { /* private fields */ }

Audio/video sink that encodes and interleaves through the linked FFmpeg libraries.

Video frames and audio blocks must arrive in nondecreasing start-time order; ready packets are muxed incrementally.

Implementations

impl NativeAvEncodeSink

pub fn create( path: impl Into<OutputTarget>, config: AvEncodeConfig, ) -> Result<Self, EncodeError>

Creates linked-library video, audio, and container encoders without touching the destination.

Errors

Returns an encoder error for invalid configuration, paths, or stale component outputs.

pub fn create_with_video_encoder( path: impl Into<OutputTarget>, config: AvEncodeConfig, encoder_name: &str, ) -> Result<Self, EncodeError>

Creates the requested concrete video encoder by its FFmpeg short name.

Errors

Returns an encoder error when the name is unavailable, implements a different codec, or the remaining configuration is invalid.

pub fn create_with_video_encoder_threads( path: impl Into<OutputTarget>, config: AvEncodeConfig, encoder_name: Option<&str>, software_threads: &dyn Fn(Option<usize>) -> i64, ) -> Result<Self, EncodeError>

Creates an encoder whose software thread count the caller decides.

software_threads is asked at most once, only when a CPU candidate opens, so a hardware candidate that falls through to software still gets a software share of the CPU.

encoder_name pins one encoder; None tries the codec’s candidates in preference order.

Errors

Returns an encoder error when no candidate opens, or for invalid configuration, paths, codecs, or muxers.

pub fn stage_timings(&self) -> EncodeStageTimings

Where this sink’s time has gone so far, both threads together.

pub fn video_selection(&self) -> &NativeVideoEncoderSelection

The video encoder this sink opened, and the candidates it passed over.

pub fn publish_report(&self) -> Option<PublishReport>

How the finished file was published; None until it is.

pub fn write_prepared_video( &mut self, frame: &mut Yuv420pFrameBuffer, pts: MediaTime, ) -> Result<(), EncodeError>

Encodes a frame the caller already packed, without copying it (see crate::NativeVideoEncodeSink::write_prepared_video).

Errors

Returns an error for a frame sized differently from this encoder, a non-monotonic timestamp, or a codec failure.

Trait Implementations

impl Drop for NativeAvEncodeSink

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl EncodeSink for NativeAvEncodeSink

fn write( &mut self, event: EncodeEvent, cancel: &CancelToken, ) -> Result<(), EncodeError>

Queues one timestamped media item.

fn finish(&mut self, cancel: &CancelToken) -> Result<(), EncodeError>

Drains encoder delay, interleaves remaining packets, and writes the trailer.

fn abort(&mut self) -> Result<(), EncodeError>

Aborts and applies the adapter’s partial-output cleanup policy.