Struct SurtrRenderer 

pub struct SurtrRenderer {
    pub telemetry: TelemetryData,
    pub frame_budget: FrameBudget,
    pub last_redraw_start: Instant,
    pub last_frame_start: Instant,
    pub redraw_requested: bool,
    /* private fields */
}

SurtrRenderer implements the high-performance GPU backend.

Fields

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.

Implementations

impl SurtrRenderer

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(&mut self, window_id: WindowId) -> CommandEncoder

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

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)

Reset the internal clock (for interactive effects)

pub fn fill_rect_with_mode( &mut self, rect: Rect, color: [f32; 4], mode: 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)

end_frame — Quench the blade by submitting the full Muspelheim multi-pass effect.

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]>, mode: u32, )

draw_svg — Renders a pre-loaded SVG icon at the specified logical rect.

pub async fn forge_headless(_width: u32, _height: u32) -> Self

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

Trait Implementations

impl Drop for SurtrRenderer

fn drop(&mut self)

Executes the destructor for this type.

impl FrameRenderer<CommandEncoder> for SurtrRenderer

fn begin_frame(&mut self) -> CommandEncoder

fn end_frame(&mut self, encoder: CommandEncoder)

impl Renderer for SurtrRenderer

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

fill_rect — Standard rectangle drawing method.

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

measure_text — Calculates the dimensions of a text string without rendering.

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

load_image — Proactively pushes a raw asset into the Mega-Atlas.

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 fill_rounded_rect(&mut self, rect: Rect, radius: f32, color: [f32; 4])

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

Fill an ellipse/circle that fits inside rect.

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

Apply a Bifrost (Frosted Glass) 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 draw_text(&mut self, text: &str, x: f32, y: f32, size: f32, color: [f32; 4])

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 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 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 trigger_shatter_event(&mut self, origin: [f32; 2], force: f32)

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])

Draw a Mjolnir Bolt (lightning strike) between two points.

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 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 get_z_index(&self) -> f32

Get the current Z-index.

fn delta_time(&self) -> f32

Returns the time elapsed since the last frame in seconds.

fn request_redraw(&mut self)

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

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

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

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 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) + Sync + Send>, )

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 query_layout(&self, _node_id: NodeId) -> Option<Rect>

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

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.