Struct RenderedSource 

pub struct RenderedSource<R: SceneRenderer> { /* private fields */ }

Default SceneSource implementation wrapping a scene + a renderer. Advances one frame per pull at the scene’s declared framerate; emits None when a finite scene’s last frame has been yielded.

Implementations

impl<R: SceneRenderer> RenderedSource<R>

pub fn new(scene: Scene, renderer: R) -> Self

Take ownership of scene + renderer. Does not call prepare on the renderer — that happens lazily on the first pull.

pub fn scene(&self) -> &Scene

Access the underlying scene (read-only). Useful for tests + compositors that want to inspect state between pulls.

pub fn scene_mut(&mut self) -> &mut Scene

Mutate the scene between pulls. The streaming-compositor use case uses this to apply Operations pulled from a control channel. Mid-stream mutations MUST NOT shift earlier timestamps — append-only operations (new keyframes after next_timestamp(), new objects, removed-in-future) are safe; rewriting existing keyframes is not.

pub fn next_timestamp(&self) -> TimeStamp

Timestamp of the next frame to be pulled.

Trait Implementations

impl<R: SceneRenderer> SceneSource for RenderedSource<R>

fn format(&self) -> SourceFormat

Declared format. Constant across a session.

fn pull(&mut self) -> Result<Option<RenderedFrame>>

Produce the next rendered tick. Returns Ok(None) when the source is exhausted (finite scene reached its end). For indefinite sources, this never returns None.