Skip to main content

Crate webizen_render

Crate webizen_render 

Source
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-render Planetary-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-render provider 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§

AlignedBufferF32
64-byte aligned buffer for GPU transfer (specific type only)
BindGroupManager
Bind group manager for render resources
Camera
Camera for world-to-screen projection.
CameraUniform
Camera uniform block: view + projection matrices (std140 layout).
ComputedUiRect
Resolved screen-space rectangle and scissor clip rectangle for a layout node.
Edges
EmfFieldCell
Per-cell field data uploaded to the GPU storage buffer.
EmfPipeline
Complete, decoupled GPU state for EMF wave slice visualization.
EmfPipelineDesc
High-level descriptor for constructing the EMF visualization pipeline.
EmfSliceUniform
Slice parameter uniform (64 bytes, std140-aligned).
EtalonHolographicNodeGpu
96-byte std140/std430 aligned GPU representation of a semantic holographic entity.
EtalonObserverStandpointUniform
Observer standpoint uniform (128 bytes, std140-aligned).
EtalonVolumetricPipeline
Complete GPU volumetric ray-marching pipeline.
FrameCameraPod
FrameExtent
Validated dimensions for one frame resource set.
LinearDepthView
A real adapter-owned texture view for one temporal resource role.
ManifoldProjectionPod
ModelUniform
Model uniform block: model matrix + time scalar (std140 layout).
MotionVectorsView
A real adapter-owned texture view for one temporal resource role.
Motor
GPU-compatible Motor representation (64 bytes with explicit padding)
MotorEncoder
Motor encoder for batch GPU transfer
MsdfGlyphMetrics
Normalized glyph metrics for a single codepoint in the MSDF font atlas (normalized to 1.0 em).
MsdfTextQuad
GPU-ready MSDF glyph quad instance (#[repr(C)], 48 bytes, Pod, Zeroable).
NativeShot
NodeWire
Cubic bezier connection wire between two node graph pins.
PixelReadback
Readback result with inspectable refusal/recovery evidence.
PixelReceipt
Bounded evidence for a pixel readback. Pixel bytes are deliberately omitted.
ReactiveMaskView
A real adapter-owned texture view for one temporal resource role.
Rect2D
2D bounding rectangle.
RenderBindGroups
Pre-configured bind groups for rendering
RenderQuin
RenderQuin: 64-byte aligned struct for GPU transfer of PGA Motors and semantic data
RenderScene
Neutral scene contract for GPU rendering
ReviewGeometry
ReviewView
SceneCamera
Projection viewpoint configuration for examining the 10D epistemic manifold
SceneEdge
A renderable edge (line) with semantic styling
SceneFace
A filled polygon (face) with semantic styling
SceneNode
A renderable node (vertex) with semantic styling
ScenePoint
A 3D point in screen space (normalized to viewport dimensions)
ScreenPoint
Screen-space point (2D coordinates in physical pixels).
ShapedTextRunMetrics
Summary statistics returned by zero-heap text shaping.
ShotProbe
Std140Field
A field in a std140 layout calculation.
SystemTelemetry
System telemetry metrics for ambient visualization.
TemporalAdmission
Validated temporal flags passed to Qualia’s existing frame scheduler.
TemporalFrameContract
All information needed to admit one temporal frame, kept beside the compiled Qualia plan.
TemporalHistoryContract
Explicit request for the history lifecycle of one frame.
TemporalProducerCapabilities
Allocation-free capability summary derived from a typed producer contract.
TemporalProducerContract
The three genuine producer views required for temporal accumulation.
TimeUniform
Time uniform block: sim time + resolution (std140 layout).
UiLayoutNode
Single node in the zero-heap intrusive UI layout tree.
UiLayoutStyle
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.
WebGpuAdapterReport
Adapter identity and the small capability subset relevant to this renderer.
WebGpuCapabilityReport
Capability evidence that does not contain GPU handles or unbounded data.
WebGpuFeatureReport
Stable, bounded feature facts exposed to native and browser callers.
WebGpuLimitReport
Stable device limits needed to reason about the offscreen acceptance slice.
WebGpuRuntimeReceipt
Runtime evidence returned by a renderer after a pixel acceptance attempt.
ZeroHeapUiCanvas
Fixed-capacity declarative UI canvas (upgraded to 512 Flexbox/Grid widgets + MSDF text runs).
ZeroHeapUiLayoutTree
Zero-heap two-pass (measure + arrange) Flexbox & 2D Grid layout solver.

Enums§

AlignItems
FlexDirection
HistoryPublication
Explicit publication decision for one frame’s resolved history.
JustifyContent
PixelFormat
The only pixel format owned by this acceptance slice.
PixelReceiptStatus
A fixed-size, deterministic record of one pixel acceptance attempt.
SizeRule
Std140Type
std140 field type descriptor (used by the layout calculator).
TemporalCapabilityRefusal
Reasons the scheduler refuses to connect a producer contract to Qualia’s temporal graph.
TemporalContractError
Errors found while assembling a typed producer contract.
TemporalResource
Producer role named in a refusal or capability report.
WebGpuStatus
Stable status for a renderer capability probe or pixel receipt.
WidgetKind
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) into out_rgba8 with zero heap.
glyph_metrics_for_char
Returns the MsdfGlyphMetrics for any Unicode char in O(1) with zero heap allocation.
glyph_slot_for_char
Maps a Unicode char to its slot index [0..128) in the embedded MSDF atlas. Slots 0..95 cover printable ASCII 0x20..=0x7E; slots 95..128 cover 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 MsdfTextQuad instances in zero heap, performing pair kerning and greedy word-wrapping at max_width_px (when max_width_px > 0.0).

Type Aliases§

Color4f
RGBA normalized color [r, g, b, a].
Margin
Padding