Struct ActiveIndex 

pub struct ActiveIndex { /* private fields */ }

A precomputed interval index for a validated project snapshot.

Implementations

impl ActiveIndex

pub fn build(project: &Project) -> Result<Self, EvalError>

Builds an immutable interval tree from a structurally valid project.

Errors

Returns EvalError::InvalidProject when the model is invalid.

pub fn project_id(&self) -> &ProjectId

Returns the project identity used to build this index.

pub fn len(&self) -> usize

Returns the number of clips indexed.

pub fn is_empty(&self) -> bool

Returns whether the index has no clips.

pub fn effects(&self) -> impl Iterator<Item = &ClipEffect>

Every effect invocation the project can draw: steps of each compiled composition (once each, in order of first use) and each transition.

pub fn peak_source_reads( &self, range: TimeRange, counted: impl FnMut(&SourceId) -> bool, ) -> usize

Peak number of concurrent host-source reads selected by counted in range, or 0.

Each read (a clip’s own source per crate::ActiveClip::needs_source, or a media step of its compositions) gets its own decoder cursor in crate::frame_needs, so this is the number of decoders active at once.

pub fn source_reads( &self, range: TimeRange, counted: impl FnMut(&SourceId) -> bool, ) -> Vec<SourceRead>

Every host-source read selected by counted over range, in index order, with readers named as in crate::frame_needs. These are the reads Self::peak_source_reads counts.

A reader reads only inside its span, so a host can close its decoder once the span ends. Within the span it may still skip frames (deduplicated needs, unused mattes).

Trait Implementations

impl Clone for ActiveIndex

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActiveIndex

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.