Struct IncrementalRenderer 

pub struct IncrementalRenderer {
    pub config: RenderConfig,
    pub frame_rate: Rational,
    /* private fields */
}

Tracks dirty frame ranges and drives incremental re-renders.

Overlapping or adjacent dirty regions are automatically coalesced on every mark_dirty call to keep the list compact.

Fields

config: RenderConfig

Render configuration used when rendering is triggered.

frame_rate: Rational

Frame rate of the associated timeline.

Implementations

impl IncrementalRenderer

pub fn new(config: RenderConfig, frame_rate: Rational) -> Self

Create a new incremental renderer.

pub fn mark_dirty(&mut self, start_frame: u64, end_frame: u64)

Mark the range [start_frame, end_frame) as dirty.

The new region is inserted and then the list is coalesced so that it always consists of non-overlapping, sorted regions.

pub fn mark_all_dirty(&mut self, total_frames: u64)

Mark every frame in [0, total_frames) as dirty.

pub fn is_dirty(&self, frame: u64) -> bool

Returns true if frame falls inside any dirty region.

pub fn get_dirty_regions(&self) -> &[DirtyRegion]

Returns a slice of the current dirty regions (sorted, non-overlapping).

pub fn dirty_frame_count(&self) -> u64

Total number of dirty frames across all regions.

pub fn clear_dirty(&mut self)

Clear all dirty regions.

pub fn render_incremental( &mut self, _timeline: &Arc<Timeline>, ) -> EditResult<usize>

Returns the number of dirty frames that need rendering, then clears the dirty list (signalling that rendering has been requested).

The caller is expected to iterate get_dirty_regions before calling this method in order to render the correct frames.

The _timeline parameter is accepted for API consistency and future use.