Struct FilePlaybackOutput

pub struct FilePlaybackOutput { /* private fields */ }

Expand description

Output-only processor owning a complete, already converted file clip. Configuration must match the prepared target rate/channel order and fit the clip’s render bound. Prepare allocates scratch; process only copies samples. File reads, conversion, device opening and clip destruction belong off audio.

Configure play/pause/seek/loop through playback_mut on the exclusive owner before transferring into PreparedOutput or open_output. This adapter does not add a cross-thread command queue. Cursors and loops are prepared output frames, including the explicit filter delay/tail. Device clocks and physical output remain separately validated. Reset stops at zero/configured loop start.

Implementations§

§

impl FilePlaybackOutput

pub fn new(prepared: PreparedFilePlayback) -> Self

pub fn info(&self) -> FilePlaybackInfo

pub fn playback(&self) -> &MemoryPlayback

pub fn playback_mut(&mut self) -> &mut MemoryPlayback

pub fn into_prepared(self) -> PreparedFilePlayback

Recover the clip after stopping callbacks; no conversion or seek occurs.

Trait Implementations§

§

fn start_audio(&mut self) -> Result<(), ProcessError>

Optional explicit audio-owner session start, after prepare and before rendering. Default is a no-op. Consumers using these hooks call once on the audio owner and stop there before transfer/deactivation. Failure must leave this processor stopped; earlier successful nodes may be stopped. Hooks follow prepared callback allocation/locking/I/O obligations. Existing adapters do not implicitly opt in; explicit graph sessions supply them.

§

fn stop_audio(&mut self)

End an explicitly started session on its audio owner, without deactivation or storage destruction. Default no-op; preparation/history may be retained.

§

fn try_reset(&mut self) -> Result<(), ProcessError>

Attempt history reset without allocating or changing configuration. Existing processors delegate to their successful legacy reset by default. A refusal may follow earlier reset work; consumers must remain faulted.

§