Struct WgpuRenderer 

pub struct WgpuRenderer<'w> { /* private fields */ }

Retained scene renderer that records Pax vector/image commands and flushes them through wgpu.

Transform and clip identities remain stable until their owning node releases them. GPU uniform pages grow with scene demand; the 480-entry page size is not a scene limit. Moving or fading retained geometry updates transform pages without retessellating or uploading vertex/index buffers.

Implementations

impl WgpuRenderer<'_>

pub fn begin_alpha_source(&mut self, mapping: Transform2D, feather: f32)

Records a detached source in the current mask owner’s surface coordinates. Source clips and opacity are independent of the consuming content; its enclosing mask is applied afterward.

pub fn end_alpha_source(&mut self)

Restores the consumer and installs a reference to the source’s retained alpha texture.

impl<'w> WgpuRenderer<'w>

pub fn new(render_backend: RenderBackend<'w>) -> Self

Create a retained renderer around a low-level RenderBackend.

pub fn share_vector_caches_from(&mut self, other: &Self)

Share vector resource caches with another renderer for the same logical layer.

pub fn set_vector_resource_cache_max_bytes(&mut self, max_bytes: usize)

pub fn shared_gpu_context_id(&self) -> usize

pub fn shared_gpu_context(&self) -> SharedGpuContext

Reuse this logical layer’s GPU context when creating another physical tile. The returned handle keeps the device and pipelines alive, not this tile’s surface or scene.

pub fn take_resource_churn_stats(&mut self) -> ResourceChurnStats

Return and reset accumulated resource churn counters.

pub fn current_transform(&self) -> Transform2D

Current transform at the top of the render-state stack.

pub fn set_surface_transform(&mut self, transform: Transform2D)

Set the base transform for the physical surface tile being rendered.

pub fn reset_retained_scene(&mut self)

Drop retained scene state for a surface that has been rebound to a new tile origin.

pub fn stroke_path(&mut self, path: Path, stroke: Stroke)

Queue a stroked vector path into the current retained node.

pub fn stroke_path_with_opacity( &mut self, path: Path, stroke: Stroke, opacity: f32, )

Queue a stroked vector path with an extra opacity multiplier.

pub fn stroke_path_with_material_and_opacity( &mut self, path: Path, stroke: Stroke, material: Material, opacity: f32, )

Queue a stroked vector path with material response and an extra opacity multiplier.

pub fn stroke_path_with_material_and_opacity_and_smoothing( &mut self, path: Path, stroke: Stroke, material: Material, opacity: f32, smoothing: PathSmoothing, )

Queue a stroked vector path with material response, opacity, and optional smoothing.

pub fn stroke_path_with_draw_range_and_material_and_opacity( &mut self, path: Path, stroke: Stroke, material: Material, opacity: f32, draw_range: DrawRange, )

Queue a draw-ranged stroked vector path with material response and an extra opacity multiplier.

pub fn stroke_path_with_draw_range_and_material_and_opacity_and_smoothing( &mut self, path: Path, stroke: Stroke, material: Material, opacity: f32, draw_range: DrawRange, smoothing: PathSmoothing, )

Queue a draw-ranged stroked vector path with material response, opacity, and optional smoothing.

pub fn fill_path(&mut self, path: Path, fill: Fill)

Queue a filled vector path into the current retained node.

pub fn fill_path_with_opacity(&mut self, path: Path, fill: Fill, opacity: f32)

Queue a filled vector path with an extra opacity multiplier.

pub fn fill_path_with_material_and_opacity( &mut self, path: Path, fill: Fill, material: Material, opacity: f32, )

Queue a filled vector path with material response and an extra opacity multiplier.

pub fn fill_path_with_material_and_opacity_and_smoothing( &mut self, path: Path, fill: Fill, material: Material, opacity: f32, smoothing: PathSmoothing, )

Queue a filled vector path with material response, opacity, and optional smoothing.

pub fn set_scene_lighting(&mut self, lighting: SceneLighting) -> bool

Upload changed surface-local lighting, returning whether retained pixels need redraw. Only lights used by this surface’s lit vector draws invalidate its contents. Repeating the same value does not upload a uniform or dirty the scene. Each new renderer receives its own initial upload, even for default lighting.

pub fn clear(&mut self)

pub fn draw_image( &mut self, image_key: &str, image_version: u64, image: &Image, rect: Box2D, )

Image identity and version must identify the same pixels across renderers sharing a GPU context. Change the version when replacing image content.

pub fn draw_image_with_opacity( &mut self, image_key: &str, image_version: u64, image: &Image, rect: Box2D, opacity: f32, )

Multiplies source pixel alpha by opacity without reuploading the texture. Sibling tiles share resident image pixels, but keep their own draw bindings. Identity/version follows the same contract as Self::draw_image.

pub fn flush(&mut self)

pub fn flush_deferred(&mut self)

pub fn set_node_opacity_scopes(&mut self, node_id: u32, scopes: &[OpacityScope])

Updates group presentation without changing a node’s paint or image resources.

pub fn save(&mut self)

pub fn restore(&mut self)

pub fn transform(&mut self, transform: Transform2D)

pub fn clip(&mut self, path: Path)

pub fn clip_alpha(&mut self, paints: Vec<AlphaMaskPaint>, feather: f32)

Installs a painted alpha mask in the current save/restore scope.

pub fn resize(&mut self, width: f32, height: f32)

pub fn resize_surface(&mut self, width: f32, height: f32)

pub fn set_viewport(&mut self, width: f32, height: f32, dpr: [f32; 2])

pub fn max_surface_dimension(&self) -> u32

pub fn scene_len(&self) -> usize

pub fn visible_node_count(&self) -> usize

pub fn size(&self) -> (f32, f32)

pub fn request_screenshot_capture(&mut self, request_id: u32)

pub fn take_screenshot_capture( &mut self, request_id: u32, ) -> Option<CapturedFrame>

pub fn begin_node( &mut self, node_id: u32, z_index: i32, light_mask: u32, ) -> bool

pub fn end_node(&mut self, node_id: u32) -> bool

pub fn remove_node(&mut self, node_id: u32) -> bool

pub fn take_pending_command_buffers(&mut self) -> Vec<CommandBuffer>

pub fn submit_command_buffers(&self, command_buffers: Vec<CommandBuffer>)

pub fn complete_submitted_work(&mut self)

pub fn has_pending_submission_cleanup(&self) -> bool

pub fn present_deferred_frame(&mut self)