Struct SingleTimeline 

pub struct SingleTimeline { /* private fields */ }

Wraps a single resolved TimelineComponent as a one-entry collection.

The tree is resolved ONCE at collection construction (plugin-side — the host only sees Box<dyn TimelineCollection>, audit B1) and the result is stored as a Result: resolving probes media and can fail, but the entry fn cannot return a Result across the dylib boundary and panicking there is UB-adjacent (audit M5). So the error is stored and surfaced per query — frame builds yield None, timelines carries the error string, and arrangement yields None.

Trait Implementations

impl TimelineCollection for SingleTimeline

fn timelines(&self) -> Vec<TimelineInfo>

fn build( &self, id: &str, t: TimelineTime, target: Resolution, residency: RasterResidency, ctx: &mut dyn RenderContext, ) -> Option<RasterImage>

Builds a frame with the representation requested by its consumer.

fn arrangement(&self, id: &str) -> Option<Arrangement>

The resolved arrangement tree for id, for the live UI to introspect.

fn render_audio( &self, id: &str, rate: u32, channels: u16, ) -> Option<AudioBuffer>

The block-rendered audio mix-down for id at rate / channels, for the live preview to mux into its video stream. None means the collection contributes no audio (the preview then muxes a silent track for a consistent A/V stream structure). Defaulted so collections migrate in stages, mirroring arrangement.

fn render_audio_window( &self, id: &str, start: f64, duration: f64, rate: u32, channels: u16, ) -> Option<AudioBuffer>

Block-rendered audio mix-down for [start, start + duration), used by the live preview when it encodes an individual cache segment. Custom collections must implement this explicitly to preview audio; falling back to the whole-track render_audio would reintroduce the per-segment full-timeline work this API avoids.