Struct Output 

pub struct Output<M, D> { /* private fields */ }

Active output driver. Any send failure or unwind makes further sends fail. finish consumes the driver; dropping it never retries effects.

Implementations

impl<M: Muxer, D: Destination> Output<M, D>

pub fn with_container_timing( mux: M, destination: D, tracks: &[TrackInfo], pulse: Option<&dyn Pulse>, ) -> Result<Self, Failure>

Explicitly allow the muxer’s ordinary timing behavior, then publish. This does not guarantee exact packet durations. Prefer Output::new.

pub fn new( mux: M, destination: D, tracks: &[TrackInfo], pulse: Option<&dyn Pulse>, ) -> Result<Self, Failure>

Require exact packet timing from the actual muxer, or fail before writing.

pub fn facts(&self) -> DestinationFacts

Facts of the retained container/writer, unchanged by publication. Progress and partial effects are reported separately through stats/errors.

pub const fn stats(&self) -> &Stats

Confirmed progress so far, including before a terminal failure.

pub fn is_failed(&self) -> bool

Whether a prior failure or unwind made this driver terminal.

pub fn send( &mut self, packet: Packet, pulse: Option<&dyn Pulse>, ) -> Result<(), Failure>

Validate and write one packet. Failure is terminal and preserves its cause.

pub fn finish(self, pulse: Option<&dyn Pulse>) -> Result<Stats, Failure>

Preflight final patches, append the tail, apply patches and flush. A patch I/O failure can leave partial overwrites; it is not a transaction.