Struct CpuRenderer 

pub struct CpuRenderer { /* private fields */ }

A renderer that draws RenderGraphs on the CPU with no GPU or driver.

It draws every built-in of the GPU crate::Renderer to the same contract: same graph, same stages, same half-float storage. Runtime WGSL effects have no CPU implementation and fail with RenderError::UnknownEffect. Output is identical for any thread count and target.

Implementations

impl CpuRenderer

pub fn execute_graph( &self, graph: &RenderGraph<'_>, ) -> Result<Arc<CpuImage>, GraphError>

Draws the reachable part of graph and returns its output.

Errors

A structural error or the first pass failure: RenderError::UnknownEffect for an effect without a CPU kernel, RenderError::InvalidSource for a GPU source.

pub fn render_graph_into_yuv420p( &self, graph: &RenderGraph<'_>, encoding: YuvEncoding, targets: &mut Yuv420pTargets<'_>, ) -> Result<(), RenderError>

Draws graph and packs it as YUV420 with encoding directly into the caller’s planes; the CPU counterpart of crate::Renderer::render_graph_yuv420p.

Errors

Self::execute_graph’s errors, and RenderError::TextureReadback for an odd size or a target too small.

impl CpuRenderer

pub fn new(threads: usize) -> Self

A CPU renderer on threads threads (one means the calling thread), with every built-in registered.

pub const fn with_blend_space(self, blend_space: BlendSpace) -> Self

Blends composites in blend_space unless a graph sets its own.

pub const fn threads(&self) -> usize

Threads the renderer draws on.

pub fn quality_controls(&self) -> RenderQualityControls

The quality controls passes use now.

pub fn unsupported_builtins() -> Vec<(String, u32)>

Built-ins the GPU registers that this renderer cannot draw, as (id, version); currently empty.

pub fn set_result_cache_budget(&self, budget_bytes: u64)

Keeps up to budget_bytes of node results for reuse, like crate::Renderer::set_result_cache_budget.

pub fn result_cache_stats(&self) -> ResultCacheStats

The result cache’s counters.

pub fn clear_result_cache(&self)

Drops every cached result.

pub fn stats(&self) -> CpuRenderStats

What the renderer has drawn so far.

pub fn frame_outcomes(&self) -> (u64, u64)

Frames presented and frames that repeated the previous one, as recorded via RenderControls::record_frame_outcome.

pub fn register_lut3d( &mut self, id: impl Into<String>, data: &Lut3dData, ) -> Result<(), RenderError>

Registers or replaces 3D LUT id, like crate::Renderer::register_lut3d.

Errors

RenderError::InvalidEffectResource for an empty id or an invalid cube.

pub fn clear_effect_resources(&mut self)

Removes every resource and clears the cached results.

pub fn release_idle_memory(&self) -> u64

Drops the cached results and returns the bytes they held.

pub fn unregister_effect_resource(&mut self, id: &str) -> bool

Removes the resource id and returns whether it existed.

impl CpuRenderer

pub fn present_yuv( &self, planes: Arc<dyn YuvPlanes>, presentation: SourcePresentation, policy: ColorPolicy, ) -> Result<(CpuSource, Vec<ColorDiagnostic>), RenderError>

A source showing decoded YCbCr planes placed by presentation, converted on first draw; the CPU counterpart of crate::Renderer::prepare_yuv_presented.

Errors

RenderError::InvalidImageData for an unsupported format or short planes, and RenderError::UnsupportedHdr when ColorPolicy::RejectHdr meets an HDR source.

pub fn present_rgba8( &self, pixels: Arc<dyn RgbaPixels>, size: RenderSize, stride: u32, presentation: SourcePresentation, alpha: SourceAlpha, ) -> Result<CpuSource, RenderError>

A source showing RGBA8 pixels placed by presentation; the CPU counterpart of crate::Renderer::prepare_rgba_presented. A zero stride means packed rows.

Errors

RenderError::InvalidImageData for short pixels or an invalid presentation.

pub fn present_linear_rgba16f( &self, pixels: Arc<dyn RgbaPixels>, size: RenderSize, stride: u32, presentation: SourcePresentation, ) -> Result<CpuSource, RenderError>

A source showing premultiplied linear BT.709 RGBA half-float bits (1.0 = SDR white); the CPU counterpart of crate::Renderer::prepare_linear_presented. A zero stride means packed rows.

Errors

RenderError::InvalidImageData for short pixels or an invalid presentation.

Trait Implementations

impl Debug for CpuRenderer

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

Formats the value using the given formatter.

impl EffectCatalog for CpuRenderer

fn effect_definition(&self, id: &EffectId) -> Option<&EffectDef>

The definition registered as id.

fn effect_reads_time(&self, id: &EffectId) -> bool

Whether id’s output can change with frame time alone; true for unknown effects.

fn project_effect_id(&self, id: &str, version: u32) -> Option<&EffectId>

The identity a project’s effect id@version draws under; None if this renderer cannot draw it or it is internal.

impl RenderControls for CpuRenderer

fn set_quality_controls( &self, max_filter_samples: u32, motion_blur_subframes: u32, )

Sets the filter sample budget (possibly capped lower) and motion blur subframe count.

fn set_texture_budget_bytes(&self, _budget_bytes: u64)

Sets the byte budget of pooled pictures kept for reuse.

fn content_epoch(&self) -> u64

Changes whenever earlier results may differ from what the same graph draws now.

fn record_frame_outcome(&self, presented: bool, repeated: bool)

Records whether a frame was presented and whether it repeated the previous one.

fn graph_cache_key( &self, graph: &RenderGraph<'_>, ) -> Result<RenderCacheKey, GraphError>

A deterministic key for what graph draws on this renderer.