Struct PipelineBridgeHandle 

pub struct PipelineBridgeHandle { /* private fields */ }

A cheaply-cloneable way to connect a pipeline to a PipelineBridge, and to end it.

Holds only a Weak reference, for the same reason crate::elements::MixerHandle does: keeping one after the bridge’s own pipeline has finished must not keep its buffers alive forever, and every operation becomes a harmless None once it is gone.

Implementations

impl PipelineBridgeHandle

pub fn connect(&self) -> Option<Box<dyn Sink>>

A Sink for the feeding pipeline to terminate at, replacing whatever was connected before.

None once the bridge’s own pipeline has finished.

pub fn input_ended(&self) -> bool

Whether the connected input has reached its own end.

false before anything has connected: nothing has ended, it simply has not begun. What this is for is noticing that a source finished so another can take its place — see PipelineBridgeHandle::connect.

pub fn finish(&self)

Ends the bridge: Eos goes downstream and its run returns.

This is the ordered ending, and the difference from stopping the downstream pipeline is what a muxer down there does about it — writes its trailer, rather than abandoning the file.

Trait Implementations

impl Clone for PipelineBridgeHandle

fn clone(&self) -> PipelineBridgeHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.