Struct RenderSession 

pub struct RenderSession { /* private fields */ }

Implementations

impl RenderSession

pub fn new(config: RenderConfig) -> Self

pub fn configure_tiles( &self, cache: &mut TileCache, memory_mb: f64, ) -> Option<Diagnostic>

Sizes the tile cache for this pass: the memory setting less what the pass itself holds (the ring’s frames and the frame-sized planes around them, each fixed region’s saved copy, 8 MB of headroom), then raised to what one frame paints. Returns the MEMORY_BUDGET_RAISED diagnostic (info) when it had to raise the limit: from, to and mb for the message, and a { budgetMB, tiles, raisedBy } detail.

pub fn counters(&self) -> RenderCounters

pub fn meta(&self, canvas: &str) -> Option<CanvasMeta>

The canvas’s metadata as the pass holds it now, if it has been loaded.

pub fn take_events(&mut self) -> Vec<Diagnostic>

Diagnostics raised since the last call, in emission order: NONFINITE_POSE (error; a placement’s resolved pose cannot be placed, it is recorded as skipped at (0, 0)), and the compositor’s INCOMPLETE_TEMPORAL_PATCH and TEMPORAL_OR_ALIGNMENT_CONFLICT (warnings; conflicts the pixels detected before patching, every conflicting rect in detail.regions).

pub fn take_dirty_metas(&mut self) -> Vec<(String, CanvasMeta)>

Canvases whose metadata changed since the last call, in the order they first changed, with their current values.

pub fn wanted_votes( &self, index: u32, has_prev: bool, has_next: bool, ) -> Vec<i64>

The consistency/<frame> records the host should read for frame index (in this order) before RenderSession::begin: the frame’s own, then its previous and next frame’s when those are in hand, leaving out what the window still holds.

pub fn begin( &mut self, input: FrameInput, votes: Vec<(i64, Option<ConsistencyRecord>)>, ) -> Result<(), RenderError>

Starts compositing one frame. votes are the records RenderSession::wanted_votes named, None where no row is stored.

pub fn cancel(&mut self, compositor: &mut Compositor)

Abandons the frame in progress (the host failed or stopped between steps), and the compositor’s placement with it. What the frame already changed (metadata, saved fixed-region pixels, last placements) stays, as it did when the pass failed mid-frame before.

pub fn provide_meta(&mut self, canvas: &str, meta: Option<CanvasMeta>)

Hands over the metadata of the canvas RenderStep::NeedMeta asked for; None when no row is stored (the next step then fails).

pub fn frame_slot(&mut self, index: u32) -> &mut [u8]

The ring slot frame index goes into, for the host to write its RGBA after RenderStep::NeedFrame. The slot filled longest ago is reused, but never one holding the frame in progress or either of its neighbours.

pub fn step(&mut self, io: &mut RenderIo<'_>) -> Result<RenderStep, RenderError>

Runs the frame until it needs something from the host or is done. On an error the frame is abandoned (and the compositor’s placement cancelled); the session stays usable.