Expand description
Webizen N-Dimensional Renderer
A zero-heap, N-dimensional semantic renderer that projects QualiaDB’s multi-modal logic graph onto 2D/3D surfaces using Projective Geometric Algebra (PGA).
§Features
- PGA-based transformations (Motors unify rotation and translation)
- Zero-heap render loop (512-byte stack buffer discipline)
- Cross-platform support (WASM/Windows/Apple Silicon)
- Semantic culling (Deontic/Temporal passes)
- Epistemic Level of Detail (DoXastic LoD)
Re-exports§
pub use pipeline::WebizenFramePlan;pub use pipeline::WebizenFrameScheduleError;pub use pipeline::WebizenFrameScheduler;pub use volumetric::HmcTextureAdmissionReport;pub use volumetric::HmcTextureStreamRequest;pub use volumetric::VolumetricRenderer;pub use volumetric::render_scene_png as render_volumetric_scene_png;pub use volumetric::render_scene_rgba8_into;pub use wgpu_renderer::render_preview_data_uri;pub use wgpu_renderer::render_preview_png;pub use wgpu_renderer::render_scene_data_uri;pub use wgpu_renderer::render_scene_png;pub use wgpu_renderer::render_scene_png_with_time;pub use wgpu_renderer::probe_webgpu_capabilities;pub use wgpu_renderer::WgpuRenderer;pub use etalon_render;
Modules§
- audio_
contract - Dual-Mode Audio Data Contract for Webizen 10D Architecture.
- geo_
viewport - Round 10 (
GEO-S10)webizen-renderPlanetary-to-Millimeter Geospatial Viewport: Capped-Angle Polyline & Earcut Tessellation, CDLOD Quadtree & Terrain Skirts, MVT Style & Curved River/Road Labels, Screen-Space Collision Solver, Rayleigh/Mie Spherical Atmosphere Limb, Gerstner Water Waves, Hypsometric Contours, GPU Picking, and Ambient Vegetation/Particle Effects. - math
- Math module for PGA Motor encoding and buffer alignment
- pipeline
- poet_
preview - Native
webizen-renderprovider for the POET loopback service boundary. - scene_
contract - Neutral GPU-facing scene contract.
- shaders
- WGSL shaders for Webizen Renderer.
- telemetry
- System Telemetry Data Contract.
- ui
- Vector Holo UI & Desktop Studio Widget System (
ui.rs) - ui_
layout - Zero-Heap Flexbox & CSS-Grid-Lite UI Layout Constraint Solver (
ui_layout.rs) - ui_
msdf_ text - GPU Multi-Channel Signed Distance Field (MSDF) Font Atlas & Zero-Heap UTF-8 Text Shaper (
ui_msdf_text.rs) - volumetric
- SDK facade over QualiaDB’s canonical wgpu 29 volumetric renderer.
- volumetric_
hmc - HMC asset and texture streaming admission for the volumetric renderer.
- wgpu_
renderer - WGPU Renderer Module
- zero_
copy_ views - Zero-copy WASM buffer views and std140-aligned uniform layouts.
Structs§
- Aligned
Buffer F32 - 64-byte aligned buffer for GPU transfer (specific type only)
- Bind
Group Manager - Bind group manager for render resources
- Camera
- Camera for world-to-screen projection.
- Camera
Uniform - Camera uniform block: view + projection matrices (std140 layout).
- Computed
UiRect - Resolved screen-space rectangle and scissor clip rectangle for a layout node.
- Edges
- EmfField
Cell - Per-cell field data uploaded to the GPU storage buffer.
- EmfPipeline
- Complete, decoupled GPU state for EMF wave slice visualization.
- EmfPipeline
Desc - High-level descriptor for constructing the EMF visualization pipeline.
- EmfSlice
Uniform - Slice parameter uniform (64 bytes, std140-aligned).
- Etalon
Holographic Node Gpu - 96-byte std140/std430 aligned GPU representation of a semantic holographic entity.
- Etalon
Observer Standpoint Uniform - Observer standpoint uniform (128 bytes, std140-aligned).
- Etalon
Volumetric Pipeline - Complete GPU volumetric ray-marching pipeline.
- Frame
Camera Pod - Frame
Extent - Validated dimensions for one frame resource set.
- Linear
Depth View - A real adapter-owned texture view for one temporal resource role.
- Manifold
Projection Pod - Model
Uniform - Model uniform block: model matrix + time scalar (std140 layout).
- Motion
Vectors View - A real adapter-owned texture view for one temporal resource role.
- Motor
- GPU-compatible Motor representation (64 bytes with explicit padding)
- Motor
Encoder - Motor encoder for batch GPU transfer
- Msdf
Glyph Metrics - Normalized glyph metrics for a single codepoint in the MSDF font atlas (normalized to 1.0 em).
- Msdf
Text Quad - GPU-ready MSDF glyph quad instance (
#[repr(C)], 48 bytes,Pod, Zeroable). - Native
Shot - Node
Wire - Cubic bezier connection wire between two node graph pins.
- Pixel
Readback - Readback result with inspectable refusal/recovery evidence.
- Pixel
Receipt - Bounded evidence for a pixel readback. Pixel bytes are deliberately omitted.
- Reactive
Mask View - A real adapter-owned texture view for one temporal resource role.
- Rect2D
- 2D bounding rectangle.
- Render
Bind Groups - Pre-configured bind groups for rendering
- Render
Quin - RenderQuin: 64-byte aligned struct for GPU transfer of PGA Motors and semantic data
- Render
Scene - Neutral scene contract for GPU rendering
- Review
Geometry - Review
View - Scene
Camera - Projection viewpoint configuration for examining the 10D epistemic manifold
- Scene
Edge - A renderable edge (line) with semantic styling
- Scene
Face - A filled polygon (face) with semantic styling
- Scene
Node - A renderable node (vertex) with semantic styling
- Scene
Point - A 3D point in screen space (normalized to viewport dimensions)
- Screen
Point - Screen-space point (2D coordinates in physical pixels).
- Shaped
Text RunMetrics - Summary statistics returned by zero-heap text shaping.
- Shot
Probe - Std140
Field - A field in a std140 layout calculation.
- System
Telemetry - System telemetry metrics for ambient visualization.
- Temporal
Admission - Validated temporal flags passed to Qualia’s existing frame scheduler.
- Temporal
Frame Contract - All information needed to admit one temporal frame, kept beside the compiled Qualia plan.
- Temporal
History Contract - Explicit request for the history lifecycle of one frame.
- Temporal
Producer Capabilities - Allocation-free capability summary derived from a typed producer contract.
- Temporal
Producer Contract - The three genuine producer views required for temporal accumulation.
- Time
Uniform - Time uniform block: sim time + resolution (std140 layout).
- UiLayout
Node - Single node in the zero-heap intrusive UI layout tree.
- UiLayout
Style - Layout style properties for a
UiLayoutNode(supports Flexbox + 2D CSS-Grid-lite + scissor clipping). - UiWidget
- A single UI widget element.
- Vec3
- 3D vector for world-space coordinates.
- WebGpu
Adapter Report - Adapter identity and the small capability subset relevant to this renderer.
- WebGpu
Capability Report - Capability evidence that does not contain GPU handles or unbounded data.
- WebGpu
Feature Report - Stable, bounded feature facts exposed to native and browser callers.
- WebGpu
Limit Report - Stable device limits needed to reason about the offscreen acceptance slice.
- WebGpu
Runtime Receipt - Runtime evidence returned by a renderer after a pixel acceptance attempt.
- Zero
Heap UiCanvas - Fixed-capacity declarative UI canvas (upgraded to 512 Flexbox/Grid widgets + MSDF text runs).
- Zero
Heap UiLayout Tree - Zero-heap two-pass (
measure+arrange) Flexbox & 2D Grid layout solver.
Enums§
- Align
Items - Flex
Direction - History
Publication - Explicit publication decision for one frame’s resolved history.
- Justify
Content - Pixel
Format - The only pixel format owned by this acceptance slice.
- Pixel
Receipt Status - A fixed-size, deterministic record of one pixel acceptance attempt.
- Size
Rule - Std140
Type - std140 field type descriptor (used by the layout calculator).
- Temporal
Capability Refusal - Reasons the scheduler refuses to connect a producer contract to Qualia’s temporal graph.
- Temporal
Contract Error - Errors found while assembling a typed producer contract.
- Temporal
Resource - Producer role named in a refusal or capability report.
- WebGpu
Status - Stable status for a renderer capability probe or pixel receipt.
- Widget
Kind - Interactive widget types.
Constants§
- EMF_
VOLUMETRIC_ WGSL - Raw WGSL shader source for the EMF volumetric visualizer.
- EPISTEMIC_
WGSL - HOLOGRAPHIC_
WGSL - Raw WGSL shader source for the procedural holographic volumetric engine.
- MAX_
MSDF_ TEXT_ QUADS - Maximum shaped glyph quads emitted in a single UI canvas frame.
- MAX_
OFFSCREEN_ DIMENSION - Maximum dimension admitted by the bounded offscreen acceptance path.
- MAX_
PIXEL_ READBACK_ BYTES - Maximum staging allocation admitted for one synchronous pixel readback.
- MAX_
UI_ LAYOUT_ NODES - Maximum layout nodes supported in a single zero-heap UI layout tree.
- MAX_
UI_ TEXT_ QUADS - Maximum shaped MSDF text quads stored directly in a
ZeroHeapUiCanvas. - MAX_
UI_ WIDGETS - Maximum interactive widgets in a single local viewport frame (upgraded to 512 for Flexbox/Grid layout).
- MAX_
UI_ WIRES - Maximum connection wires in a node graph.
- MSDF_
ATLAS_ COLS - Columns in the procedural MSDF atlas grid.
- MSDF_
ATLAS_ GLYPH_ COUNT - Number of glyph slots in the embedded procedural MSDF font atlas (16 columns × 8 rows = 128).
- MSDF_
ATLAS_ HEIGHT - Full texture height in pixels (
8 * 16 = 128). - MSDF_
ATLAS_ ROWS - Rows in the procedural MSDF atlas grid.
- MSDF_
ATLAS_ WIDTH - Full texture width in pixels (
16 * 16 = 256). - MSDF_
CELL_ PX - Pixel width/height of a single glyph cell in the procedural MSDF atlas.
- MSDF_
PIXEL_ RANGE - Distance field pixel range used by the MSDF shader.
- MSDF_
TEXT_ WGSL - Embedded WGSL shader snippet for MSDF median-of-three text rendering with screen-space
derivative (
fwidth) anti-aliasing. - NO_
UI_ NODE - PROJECTOR_
WGSL - REVIEW_
VIEWS
Functions§
- admit_
capabilities - Pure temporal admission policy shared by adapters and deterministic tests.
- generate_
procedural_ msdf_ atlas_ into - Generates a procedural Multi-Channel Signed Distance Field (MSDF) RGBA8 atlas texture
(
MSDF_ATLAS_WIDTH×MSDF_ATLAS_HEIGHT× 4 = 131,072 bytes) intoout_rgba8with zero heap. - glyph_
metrics_ for_ char - Returns the
MsdfGlyphMetricsfor any UnicodecharinO(1)with zero heap allocation. - glyph_
slot_ for_ char - Maps a Unicode
charto its slot index[0..128)in the embedded MSDF atlas. Slots0..95cover printable ASCII0x20..=0x7E; slots95..128cover Latin-1 and QualiaDB 10D technical symbols (α,μ,σ,Δ,Ω,π,±,°,→,↔,≤,≥). - kerning_
advance_ em - Returns the horizontal kerning adjustment in em units for an adjacent
(left, right)glyph pair. - msdf_
median_ of_ three - Evaluates the CPU reference median-of-three MSDF reconstruction
max(min(r, g), min(max(r, g), b)). - pixel_
receipt_ from_ rgba8 - Build deterministic pixel evidence without requiring a GPU.
- shape_
text_ zero_ heap - Shapes a UTF-8 string into GPU-ready
MsdfTextQuadinstances in zero heap, performing pair kerning and greedy word-wrapping atmax_width_px(whenmax_width_px > 0.0).