Struct SurtrRenderer 

pub struct SurtrRenderer {
    pub ai_material_rx: Option<Receiver<Result<CompiledMaterial, GeneratorError>>>,
    pub headless_context: Option<HeadlessContext>,
    pub telemetry: TelemetryData,
    pub frame_budget: FrameBudget,
    pub last_redraw_start: Instant,
    pub last_frame_start: Instant,
    pub redraw_requested: bool,
    pub bloom_enabled: bool,
    pub volumetric_enabled: bool,
    pub color_blind_mode: ColorBlindMode,
    pub color_blind_intensity: f32,
    pub last_gpu_time_ns: u64,
    /* private fields */
}

P1-1 fix: configurable SurtrRenderer parameters.

The 5220-line SurtrRenderer monolith hardcoded six LRU cache sizes plus the Mega-Heim atlas dimensions. This struct extracts those into a single configuration object so that callers can tune the renderer for different working sets (high-end desktop vs. mid-tier mobile vs. low-VRAM embedded) without modifying the source. P1-1 (phase 6): SurtrConfig has been moved to its own module at crate::subsystems::config::SurtrConfig. The re-export at crate::SurtrConfig (from cvkg_runic_text re-exports in lib.rs) preserves backward compatibility.

SurtrRenderer implements the high-performance GPU backend.

Fields

ai_material_rx: Option<Receiver<Result<CompiledMaterial, GeneratorError>>>

headless_context: Option<HeadlessContext>

telemetry: TelemetryData

frame_budget: FrameBudget

Configuration for render-loop frame timing and degradation strategies.

last_redraw_start: Instant

Instant at the start of the last redraw, used for measuring frame timings.

last_frame_start: Instant

Instant at the start of the last frame, used for frame_time_ms calculation.

redraw_requested: bool

Whether a redraw has been requested for the next frame.

bloom_enabled: bool

Bloom post-processing enabled flag.

volumetric_enabled: bool

Dynamic toggle to enable or disable the volumetric raymarching pass, which handles fog and light shaft simulations.

color_blind_mode: ColorBlindMode

Color blindness simulation mode (Normal = disabled).

color_blind_intensity: f32

Color blindness effect intensity (0.0–1.0).

last_gpu_time_ns: u64

Implementations

impl SurtrRenderer

pub fn clear_event_handlers(&mut self)

Clear all registered event handlers. Call at the start of each frame before re-rendering the component tree.

pub fn clear_text_cache(&mut self)

Phase 2.1: clear the text shaping cache at the start of each frame.

pub fn get_handlers( &self, event_type: &str, ) -> Option<&Vec<Arc<dyn Fn(Event) + Send + Sync>>>

Get all registered event handlers for a specific event type.

pub fn stroke_path(&mut self, path: &Path, color: [f32; 4], stroke_width: f32)

impl SurtrRenderer

pub fn hologram_instances(&self) -> &[HologramInstance]

Access the hologram instances submitted this frame.

pub fn set_quality_level(&mut self, level: QualityLevel)

P1-10: set the rendering quality level. Affects MSAA sample count and (in the future) other adaptive rendering settings like blur mip levels and effect complexity. Must be called before the next frame’s render pass setup; mid-frame changes will only take effect on subsequent frames.

Quality levels:

• High: MSAA 4x (default, matches previous behavior)
• Medium: MSAA 2x (mobile, mid-tier GPUs)
• Low: MSAA 1x (low-end GPUs, Adreno 3xx, etc.)

pub fn set_config(&mut self, config: SurtrConfig)

P1-1: replace the renderer configuration at runtime.

Note: changes to cache sizes only affect FUTURE inserts; the existing LRU caches keep their original capacity. To resize existing caches, you must restart the renderer. This is a pragmatic limitation – resizing LRU caches atomically would require copying the entire cache, which is expensive.

Changes to atlas dimensions and other one-shot values take effect on the next frame.

pub fn config(&self) -> &SurtrConfig

P1-1: read the current configuration.

pub fn quality_level(&self) -> QualityLevel

P1-10: get the current rendering quality level.

pub fn update_mouse(&mut self, mouse: [f32; 2], velocity: [f32; 2])

Update cursor pointer uniforms for tactile hover shader interactions.

Contract

• mouse represents logical window coordinates.
• velocity is the change in logical coordinates per second.

pub fn invalidate_material_cache(&mut self)

P1-9 fix: notify the renderer that the material set has changed (e.g. a material was added, removed, or its WGSL output was recompiled). Increments the material_compilation_hash so the graph plan cache will be invalidated on the next frame.

Without this hook, a material change would silently reuse a stale cached plan with mismatched shader bindings.

pub fn invalidate_all_caches(&mut self) -> usize

P1-19: invalidate all asset caches atomically.

The renderer maintains 5 separate LRU caches and a hash map:

• text: TextSubsystem (engine + glyph_cache + shaped_cache)
• svg: SvgSubsystem (model_cache + tree_cache + filter_batches)
• image_uv_registry
• texture_registry + texture_views
• shared_elements

When the asset set changes (e.g., theme change, hot-reload, memory pressure), callers previously had to coordinate invalidation across all of them. This method provides a single point of coordinated invalidation.

P1-19 caveat: this is a coarse-grained clear. A future improvement would be a unified registry with refcounted entries that can selectively invalidate only the entries affected by a change. The current implementation clears everything, which is correct but over-aggressive.

Returns the number of entries that were cleared across all caches, useful for logging/instrumentation.

pub fn prewarm_text_cache(&mut self, labels: &[(&str, f32)])

Phase 2.3: Pre-shape static text labels to warm the shaped text cache.

Called once at init time with the set of labels that are known to be rendered every frame (menu titles, dock labels, overlay labels, etc.). This avoids the first-frame HarfBuzz shaping cost for these strings, which would otherwise cause a visible stutter on the first rendered frame.

The cache entries persist across frames (cleared only on theme change via invalidate_all_caches), so pre-shaped labels are reused for the lifetime of the renderer.

pub async fn forge(window: Arc<Window>) -> Self

forge – Initializes the Surtr GPU renderer from a winit window.

This method performs the following:

1. Negotiates a wgpu surface and adapter.
2. Forges the Muspelheim multi-pass pipeline layouts.
3. Initializes the Berserker state buffers and texture registries.

pub fn get_telemetry(&self) -> TelemetryData

Get real-time performance telemetry.

pub fn resize( &mut self, window_id: WindowId, width: u32, height: u32, scale_factor: f32, )

resize – Reconfigures a specific surface and its internal textures.

pub fn begin_frame_headless(&mut self) -> CommandEncoder

begin_frame_headless – Strike the flaming sword to begin a new GPU frame for headless rendering.

pub fn begin_frame(&mut self, window_id: WindowId) -> CommandEncoder

begin_frame – Strike the flaming sword to begin a new GPU frame for a specific window.

pub fn begin_frame_reuse(&mut self, window_id: WindowId) -> CommandEncoder

Begin a frame without resetting per-frame state. Used when reusing the previous frame’s draw calls (view unchanged).

pub fn register_window(&mut self, window: Arc<Window>)

register_window – Attaches a new OS window to the shared GPU context.

pub fn reset_time(&mut self)

pub fn reclaim_vram(&mut self)

reclaim_vram – Atomic recycling of the Mega-Heim and all associated caches. This prevents OOM and silent failures by quenching the heim when full.

pub fn fill_rect_with_mode( &mut self, rect: Rect, color: [f32; 4], material_id: u32, texture_id: Option<u32>, )

fill_rect_with_mode – Specialized rectangle drawing with mode-specific shader logic.

pub fn end_frame(&mut self, encoder: CommandEncoder)

Pass 1: Clear scene+depth, draw atmosphere, draw opaque geometry. end_frame – Quench the blade by submitting the full Muspelheim multi-pass effect.

Since the Renderer 3.0 migration, the pass sequence is driven by a Kvasir dependency graph rather than hardcoded ordering. The graph is built each frame (cheap – just node/edge allocation), validated (cycle detection, input satisfiability), then executed. Conditional passes (glass, bloom, accessibility) are automatically eliminated when not needed.

impl SurtrRenderer

pub fn submit_buckets(&mut self, buckets: &CommandBuckets)

Submit pre-routed draw command buckets from the cvkg-compositor.

Accepts CommandBuckets produced by CompositorEngine::flatten_and_route() and submits draw calls in the correct pass order for the Backdrop Capture Architecture:

1. Scene commands (opaque) → Scene Capture pass
2. Glass commands → Material Composite pass (samples blur pyramid)
3. Overlay commands → Top-Level Foreground pass

impl SurtrRenderer

pub fn load_svg(&mut self, name: &str, data: &[u8])

load_svg – Parses an SVG file and tessellates its paths into GPU triangles.

pub fn draw_svg( &mut self, name: &str, rect: Rect, color: Option<[f32; 4]>, material_id: u32, )

draw_svg – Renders a pre-loaded SVG icon at the specified logical rect. animation_time_offset shifts the animation phase for this instance, allowing multiple draws of the same SVG to animate independently.

pub fn draw_svg_with_offset( &mut self, name: &str, rect: Rect, color: Option<[f32; 4]>, material_id: u32, animation_time_offset: f32, )

pub fn draw_svg_with_order( &mut self, name: &str, rect: Rect, color: Option<[f32; 4]>, material_id: u32, animation_time_offset: f32, draw_order: i32, )

pub async fn forge_headless(width: u32, height: u32) -> Self

forge_headless – Initializes Surtr without a window for visual regression testing.

pub async fn capture_frame(&self) -> Result<Vec<u8>, String>

capture_frame – Read back the rendered frame as a byte buffer (RGBA8).

impl SurtrRenderer

pub fn load_image_to_heim(&mut self, name: &str, data: &[u8])

load_image_to_heim – Packs a raw asset into the Mega-Heim. This is used for common icons to enable aggressive batching (1 draw call).

Trait Implementations

impl Drop for SurtrRenderer

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl ElapsedTime for SurtrRenderer

fn delta_time(&self) -> f32

Returns the time elapsed since the last frame in seconds.

fn elapsed_time(&self) -> f32

Returns the cumulative time since the renderer started in seconds.

impl FrameRenderer<CommandEncoder> for SurtrRenderer

fn begin_frame(&mut self) -> CommandEncoder

fn render_frame(&mut self)

fn end_frame(&mut self, encoder: CommandEncoder)

impl Renderer for SurtrRenderer

fn fill_glass_rect(&mut self, rect: Rect, radius: f32, blur_radius: f32)

Fill a rounded rect with glass material for frosted backdrop effect. This is the proper way to render glass cards that need macOS Tahoe-style blur. The blur_radius controls the intensity of the backdrop blur. The glass_intensity controls overall glass effect strength (0.0 = solid, 1.0 = full glass). For Tahoe parity, this registers the rect as a portal region for per-element isolated backdrop blur when z_index != 0.

fn fill_glass_rect_with_intensity( &mut self, rect: Rect, radius: f32, blur_radius: f32, glass_intensity: f32, )

Fill a rounded rect with glass material with explicit intensity control. glass_intensity ranges from 0.0 (solid, no glass effect) to 1.0 (full glass). This allows per-component control over glass strength.

fn fill_glass_rect_with_tint( &mut self, rect: Rect, radius: f32, blur_radius: f32, tint_color: [f32; 4], glass_intensity: f32, )

Fill a rounded rect with glass material with explicit tint color and intensity. tint_color is the glass base color (RGBA). glass_intensity controls effect strength.

fn set_default_background_color(&mut self, color: [f32; 4])

Set the default background color for the canvas. This color is used when the app does not draw its own background. Default: [0.02, 0.02, 0.05, 1.0] (Deep Void).

fn fill_squircle(&mut self, rect: Rect, n: f32, color: [f32; 4])

Fill a squircle (superellipse) for Apple-style icon silhouettes. n controls the squareness: 2.0 = rounded rect, 4.0 = classic squircle, higher = more square.

fn stroke_squircle( &mut self, rect: Rect, n: f32, color: [f32; 4], stroke_width: f32, )

Stroke a squircle (superellipse) outline.

fn draw_focus_ring( &mut self, rect: Rect, radius: f32, offset: f32, width: f32, color: [f32; 4], )

Draw a focus ring around a rect (for keyboard navigation accessibility). offset is the gap between the rect and the ring, width is the ring thickness.

fn gungnir_soft( &mut self, rect: Rect, color: [f32; 4], radius: f32, intensity: f32, )

Soft glow variant – half the intensity of gungnir(). Use for hover highlights, non-critical indicators.

fn mani_glow(&mut self, rect: Rect, color: [f32; 4], radius: f32)

Renders a dynamic glowing hover boundary field around a hit target.

Contract

Expands the bounding box of the visual target by radius to establish a continuous proximity glow. Uses the drop shadow/glow SDF material to rasterize the glow with specialized radius-to-margin uv coordinate mappings.

fn load_image(&mut self, name: &str, data: &[u8])

load_image – Proactively pushes a raw asset into the Mega-Heim. load_image – Proactively pushes a raw asset into the Texture Array.

fn push_mjolnir_slice(&mut self, angle: f32, offset: f32)

push_mjolnir_slice – Pushes a geometric clipping plane onto the stack. All subsequent draw calls will be sliced by this plane until it is popped.

fn pop_mjolnir_slice(&mut self)

pop_mjolnir_slice – Removes the top-most geometric clipping plane from the stack.

fn render_scene_node_3d( &mut self, position: [f32; 3], rotation: [f32; 4], scale: [f32; 3], color: [f32; 4], meshes: &[Mesh], )

Render a 3D scene graph node using the GPU backend.

Contract

PBR lighting and opacity are computed using base color, metallic (0.0), and roughness (0.5) to support standard matte opaque 3D meshes.

fn enter_portal(&mut self, z_index: i32)

Begin rendering into the portal root layer instead of the inline tree. All draw calls between enter_portal and exit_portal are collected into a separate buffer that is composited AFTER the main tree.

WHY separate buffer: The main tree may have clipping, transforms, or opacity that should NOT affect overlays. The portal layer renders on top of everything, ignoring the local coordinate system.

z_index controls the layer ordering for portal content.

fn exit_portal(&mut self)

Exit the portal layer and return to inline rendering. The portal content collected since enter_portal is now sealed – no more draw calls will be appended to it.

fn draw_svg_with_order(&mut self, name: &str, rect: Rect, draw_order: i32)

Draw SVG content with explicit draw_order for z-sorting within the same pass. Use draw_order=200 for SVG content that should render above UI chrome (draw_order=0).

fn measure_text(&mut self, text: &str, size: f32) -> (f32, f32)

Phase 2.1: text shaping cache lookup. Uses text.shaped_cache which stores Arc.

fn draw_text(&mut self, text: &str, x: f32, y: f32, size: f32, color: [f32; 4])

Phase 2.2: Override draw_text to use the shaped text cache. The default trait implementation calls shape_rich_text every frame. This override checks the shaped_cache first, avoiding redundant HarfBuzz shaping. Uses Arc to avoid cloning glyph data on cache hit.

fn is_over_budget(&self) -> bool

Returns true if the current frame is over the time budget. This can be used to skip expensive visual effects.

fn text_scale_factor(&self) -> f32

Scale factor used by text measurement helpers.

fn prewarm_vram(&mut self, assets: Vec<(String, Vec<u8>)>)

Pre-warm the renderer with assets. Implementations can use this to populate texture atlases or warm up shader caches.

fn fill_rect(&mut self, rect: Rect, color: [f32; 4])

fn fill_rounded_rect(&mut self, rect: Rect, radius: f32, color: [f32; 4])

fn fill_glass_rect_with_pressure( &mut self, rect: Rect, radius: f32, blur_radius: f32, pressure: f32, )

Fill a rounded rect with glass material, modulated by touch pressure. pressure ranges from 0.0 (no touch) to 1.0 (full pressure). When pressure > 0, refraction distortion is scaled by pressure amount. Desktop stub: pressure is always 1.0 for mouse clicks, 0.0 otherwise.

fn fill_ellipse(&mut self, rect: Rect, color: [f32; 4])

Fill an ellipse/circle that fits inside rect.

fn draw_3d_cube(&mut self, rect: Rect, color: [f32; 4], rotation: [f32; 3])

Draw a high-fidelity 3D cube inside the given rectangle using specialized shader logic. rotation is [pitch, yaw, roll] in radians.

fn bifrost(&mut self, rect: Rect, blur: f32, _saturation: f32, opacity: f32)

Apply a Bifrost (Frosted Glass) effect to the specified rect.

fn gungnir(&mut self, rect: Rect, color: [f32; 4], radius: f32, intensity: f32)

Apply a Gungnir (Neon Glow) effect to the specified rect.

fn stroke_rect(&mut self, rect: Rect, color: [f32; 4], stroke_width: f32)

fn stroke_rounded_rect( &mut self, rect: Rect, radius: f32, color: [f32; 4], stroke_width: f32, )

fn stroke_ellipse(&mut self, rect: Rect, color: [f32; 4], stroke_width: f32)

Stroke an ellipse/circle that fits inside rect.

fn draw_linear_gradient( &mut self, rect: Rect, start_color: [f32; 4], end_color: [f32; 4], angle: f32, )

Draw a linear gradient between two colors at the specified angle.

fn draw_radial_gradient( &mut self, rect: Rect, inner_color: [f32; 4], outer_color: [f32; 4], )

Draw a radial gradient between two colors.

fn draw_drop_shadow( &mut self, rect: Rect, radius: f32, color: [f32; 4], blur: f32, spread: f32, )

Draw a high-fidelity drop shadow for a rounded rectangle.

fn stroke_dashed_rounded_rect( &mut self, rect: Rect, radius: f32, color: [f32; 4], width: f32, dash: f32, gap: f32, )

Draw a dashed border for a rounded rectangle.

fn draw_9slice( &mut self, image_name: &str, rect: Rect, left: f32, top: f32, right: f32, bottom: f32, )

Draw a 9-slice / patch scaled image.

fn draw_line( &mut self, x1: f32, y1: f32, x2: f32, y2: f32, color: [f32; 4], stroke_width: f32, )

Draw a straight line from (x1,y1) to (x2,y2).

fn draw_image(&mut self, image_name: &str, rect: Rect)

Draw an image asset by name or path.

fn shape_rich_text( &mut self, spans: &[TextSpan], max_width: Option<f32>, align: TextAlign, overflow: TextOverflow, ) -> Option<ShapedText>

fn draw_shaped_text(&mut self, shaped: &ShapedText, x: f32, y: f32)

fn draw_texture(&mut self, texture_id: u32, rect: Rect)

Draw a texture (GPU-side) at the specified rect.

fn push_clip_rect(&mut self, rect: Rect)

Push a clip rectangle. All subsequent drawing is clipped to rect. Implementations that do not support clipping may ignore this call.

fn pop_clip_rect(&mut self)

Pop the most recently pushed clip rectangle.

fn current_clip_rect(&self) -> Rect

Get the current clip rectangle in screen coordinates. Returns a rect covering the entire screen if no clip is active.

fn memoize( &mut self, id: u64, data_hash: u64, render_fn: &dyn Fn(&mut dyn Renderer), )

Execute a render function with memoization. If the renderer supports caching and the id + data_hash match a previous run, it may replay cached commands instead of executing the function.

fn snapshot_render_state(&self) -> RenderStateSnapshot

Capture current renderer stack depths for later panic recovery. The default implementation returns RenderStateSnapshot::default(), which is safe but does nothing useful – backends with stack state must override this to record their actual depths.

fn restore_render_state(&mut self, snap: RenderStateSnapshot)

Restore renderer stack state by popping items pushed beyond the snapshot point. Used by ErrorBoundary to recover from mid-render panics so sibling views don’t inherit leaked clip/opacity/transform state. Idempotent: a no-op if stacks are already at or below the snapshot depths. Default implementation is a no-op for backends that have no stack state.

fn push_opacity(&mut self, opacity: f32)

Set a global opacity multiplier applied to all subsequent draw calls until pop_opacity is called. opacity is in [0.0, 1.0].

fn pop_opacity(&mut self)

Restore the previous opacity level.

fn push_shadow(&mut self, radius: f32, color: [f32; 4], offset: [f32; 2])

Push a shadow state to the stack. All following draw calls will have this shadow.

fn pop_shadow(&mut self)

Pop the last shadow state from the stack.

fn push_transform( &mut self, translation: [f32; 2], scale: [f32; 2], rotation: f32, )

Push a 2D transform (translation, scale, rotation) onto the stack. This transform should be applied to all subsequent draw calls until popped. Transform-only animations use this to avoid re-triggering the layout engine.

fn push_affine(&mut self, transform: [f32; 6])

Push a raw 2D affine transform matrix [a, b, c, d, e, f] corresponding to [m11, m12, m21, m22, tx, ty].

fn pop_transform(&mut self)

Pop the last 2D transform from the stack.

fn set_theme(&mut self, theme: ColorTheme)

fn set_rage(&mut self, rage: f32)

fn set_fireball_pos(&mut self, pos: [f32; 2])

Set the fireball position for dynamic glass specular highlights.

fn trigger_shatter_event(&mut self, origin: [f32; 2], force: f32)

fn set_scene_preset(&mut self, preset: u32)

fn mjolnir_shatter( &mut self, rect: Rect, pieces: u32, force: f32, color: [f32; 4], )

Apply a Mjolnir Shatter effect (fragmentation) to the specified rect.

fn mjolnir_fluid_shatter( &mut self, rect: Rect, pieces: u32, force: f32, color: [f32; 4], )

fn draw_mjolnir_bolt(&mut self, from: [f32; 2], to: [f32; 2], color: [f32; 4])

fn dispatch_particles( &mut self, origin: [f32; 2], count: u32, effect_type: &str, color: [f32; 4], )

Dispatches a burst of GPU particles (e.g. fireworks, data streams).

fn draw_hologram(&mut self, rect: Rect, hologram_id: &str, time: f32)

Draws a volumetric hologram into the specified bounding rectangle.

fn upload_data_texture( &mut self, id: &str, data: &[f32], width: u32, height: u32, )

Upload raw float data as a GPU texture for heatmap rendering.

fn draw_heatmap(&mut self, texture_id: &str, rect: Rect, _palette: &str)

Draw a heatmap using a previously uploaded data texture.

fn draw_mesh(&mut self, mesh: &Mesh, color: [f32; 4], transform: Mat4)

Draw a 3D mesh.

fn draw_mesh_3d( &mut self, mesh: &Mesh, material: &Material3D, transform: &Transform3D, )

Draw a 3D mesh with full material and transform support.

fn set_camera_3d(&mut self, camera: &Camera3D)

Set the 3D camera for perspective/orthographic projection. If not called, rendering defaults to the 2D orthographic projection.

fn push_transform_3d(&mut self, transform: &Transform3D)

Push a 3D transform onto the transform stack. All subsequent drawing is affected until pop_transform_3d.

fn pop_transform_3d(&mut self)

Pop the most recently pushed 3D transform.

fn register_shared_element(&mut self, id: &str, rect: Rect)

Register a shared element for Bifrost Bridge transitions.

fn set_z_index(&mut self, z: f32)

Set the current Z-index for depth sorting. Higher values appear closer to the viewer.

fn set_material(&mut self, material: DrawMaterial)

Set the active material for subsequent draw calls. Controls which pass a draw call is routed to in the multi-pass pipeline.

fn current_material(&self) -> DrawMaterial

Return the currently active material (defaults to Opaque).

fn get_z_index(&self) -> f32

Get the current Z-index.

fn request_redraw(&mut self)

Requests that the renderer redraws as soon as possible. Used for continuous animations.

fn push_vnode(&mut self, rect: Rect, name: &'static str)

Push a Virtual DOM node onto the stack for hierarchy tracking.

fn pop_vnode(&mut self)

Pop the current Virtual DOM node from the stack.

fn register_handler( &mut self, event_type: &str, handler: Arc<dyn Fn(Event) + Send + Sync>, )

Register an event handler for the current VDOM node.

fn load_svg(&mut self, name: &str, svg_data: &[u8])

Load an SVG model from raw bytes.

fn draw_svg(&mut self, name: &str, rect: Rect)

Draw a pre-loaded SVG model.

fn draw_svg_with_offset( &mut self, name: &str, rect: Rect, animation_time_offset: f32, )

Draw a pre-loaded SVG model with a per-instance animation time offset. The offset shifts the animation phase, allowing multiple draws of the same SVG to animate independently. Default delegates to draw_svg (no offset).

fn serialize_svg(&mut self, name: &str) -> Result<String, String>

Serialize a pre-loaded SVG model back to SVG XML markup. Returns the serialized SVG string, or an error if the model is not loaded or serialization is not supported by this renderer.

fn apply_svg_filter( &mut self, name: &str, filter_id: &str, _region: Rect, ) -> Result<String, String>

Apply an SVG filter to a pre-loaded SVG model by filter element ID. The filter is evaluated and the result composited back into the SVG. Returns the filtered SVG as XML, or an error if not supported.

fn draw_background_image(&mut self, image_name: &str, rect: Rect)

Draw a background image that fills the entire rect. This is a convenience wrapper around draw_image for the common case of a full-rect background. The image must have been pre-warmed via prewarm_vram before the first frame.

fn fill_polygon(&mut self, _vertices: &[[f32; 2]], _color: [f32; 4])

Fill a polygon defined by a set of vertices.

fn stroke_polygon( &mut self, _vertices: &[[f32; 2]], _color: [f32; 4], _stroke_width: f32, )

Stroke a polygon defined by a set of vertices.

fn measure_text_baseline(&mut self, text: &str, size: f32) -> f32

Return the baseline offset (ascent) for the given text and size. This is the distance from the text origin (y in draw_text) to the baseline. Default returns 0.0; override in renderers that support text shaping.

fn get_pointer_position(&self) -> [f32; 2]

Get the current pointer (mouse/touch) position.

fn set_berserker_mode(&mut self, _state: BerserkerMode)

fn set_scene(&mut self, _scene: &str)

Set the desktop scene preset (Aurora, Void, Nebula, Glitch, Yggdrasil).

fn set_scene_by_name(&mut self, name: &str)

Set the desktop scene by name. Case-insensitive. Supports: “aurora”, “void”, “nebula”, “glitch”, “yggdrasil”. Aliases: “empty”, “none”, “blank” → Void.

fn capture_png(&mut self) -> Vec<u8>

Capture the current frame as a PNG byte buffer.

fn print(&mut self)

Trigger a native print dialog or spooling operation.

fn set_aria_role(&mut self, _role: &str)

fn set_aria_label(&mut self, _label: &str)

fn set_aria_valuemin(&mut self, _min: f32)

fn set_aria_valuemax(&mut self, _max: f32)

fn set_aria_valuenow(&mut self, _now: f32)

fn set_key(&mut self, _key: &str)

Set a unique key for the current VDOM node to ensure stable identity during diffing.

fn get_telemetry(&self) -> TelemetryData

Get real-time performance telemetry.

fn query_layout(&self, _node_id: KvasirId) -> Option<Rect>

Return the resolved layout bounds for a specific node ID if it exists.

fn set_debug_layout(&mut self, _enabled: bool)

Enable or disable the layout debug overlay (bounds, padding, margin).

fn get_debug_layout(&self) -> bool

Check if the layout debug overlay is currently enabled.

fn mimir_intent(&self) -> [f32; 2]

Compute the user’s velocity/intent vector.

fn magnetic_warp( &self, pointer: [f32; 2], anchor_rect: Rect, strength: f32, ) -> [f32; 2]

Calculate magnetic coordinate warp towards an anchor.

fn mani_glow_intensity( &self, pointer: [f32; 2], bounds: Rect, radius: f32, ) -> f32

Calculate kinematic glow intensity based on proximity.

fn fafnir_evolve(&self, pointer: [f32; 2], bounds: Rect, max_scale: f32) -> f32

Calculate dynamic element attention (scaling/morphing) statelessly per frame.

fn set_sdf_shape(&mut self, _shape: SdfShape)

Sets the precise Vili SDF Shape boundary for hit-testing.

fn viewport_size(&self) -> Rect

Get the current viewport size in logical pixels. Used by portal content to size itself to the full screen.

fn announce(&mut self, _message: &str, _priority: AnnouncementPriority)

Announce a message to screen readers via the platform accessibility API. This call is non-blocking. The message is queued and the screen reader will speak it at its own pace.