Skip to main content

Module render

Module render 

Source
Expand description

Renderer / engine — the manifold projection + WebGPU viewport.

Phase 0.2a (RENDERER_IMPLEMENTATION_PLAN.md): the formerly-flat portal_* modules are consolidated under one render tree. The platform-agnostic pieces (camera, PGA oracle, projection, telemetry, standpoint, spectral, acoustic, control, contract, asset import) compile everywhere. The WebGPU renderer core (gpu) compiles wherever gpu-runtime is enabled; only the browser facade (portal, portal_wasm) remains gated to wasm + portal.

Re-exports§

pub use entity_compile_gates as twin_compile_gates;
pub use vertebrate_anatomy as zoological_anatomy;

Modules§

acceptance_contract
Cross-platform measured capability evidence and fail-closed acceptance gates. Cross-platform measured capability evidence and fail-closed acceptance gates.
acoustic
Phenomenal U2/U3 spectral parity — shared σ truth for vision and AcousticPlane (P-F2).
anatomy
Browser Anatomy render backends. Shared pack metadata remains in anatomy_pack. Browser Anatomy render backends.
anatomy_pack
Shared metadata schema for a .hmc anatomy asset pack (per-organ system / position / neutral colour). Platform-agnostic (native + WASM consumers). Shared metadata schema for a .hmc anatomy asset pack — the per-organ meta carried in each bundle entry.
ao_quality
Bounded screen-space ambient occlusion quality profiles and bilateral reconstruction. Bounded screen-space ambient occlusion quality profiles and bilateral reconstruction.
asset_package
HMC packaging and digest-verified resolution for compiled render assets. Content-addressed HMC packaging and zero-copy resolution for compiled render assets.
assets
Asset import: OBJ / STL / GLB → Mesh + semantic NQuins (Phase 1.3). Asset-import bridge — OBJ / STL mesh → NQuin stream (Phase 1.3, RENDERER_IMPLEMENTATION_PLAN.md).
atmosphere
Shared authored sky, lighting and analytic-atmosphere presets. Shared authored sky, lighting and analytic-atmosphere presets.
authoring
Authoring vocabulary + render planner (Phase 5): a qapp declares 3D + 2D views over one manifold; the planner enforces attestation gates, rights-bounded contexts, and budget-driven 3D→2D degradation before drawing. Gated like place_time (needs crate::modalities). Phase 5 — the authoring vocabulary (ns/ui) + render planner (the qapps upgrade; §6/§7).
barrier
Validate-before-render barrier needs full modalities::logic::geometry_asset_shacl (not modalities_lite / wasm-ontology-only). Validate-before-render barrier (P2)
body_fit
Person-authored body fit applied to decoded organ vertices (CCF space). Apply a person-authored AnatomyBodyFit to decoded organ vertices.
botanical_anatomy
4-Scale Botanical .10d Organ & Histology Dissection (FLOWER / LEAF / WOOD / ROOT). Botanical 4-Scale Digital Twin Anatomy, Histological Dissection & Living Container Generator.
camera
Orbit camera → column-major view_projection for the Qualia portal (CPU hot path, zero-heap).
camera_mount
Camera attachment to a native rigid body, expressed through the existing orbit camera ABI. The current ABI preserves world-up rather than bank roll.
compile_10d
Compile a Mesh into a sealed .10d container (the dense compiled-geometry sidecar) and read it back — the “mesh → .10d” step of the 3-D-anatomy asset pipeline. Compile an imported triangle Mesh into a sealed .10d container — the dense compiled-geometry half of a geometry asset (see docs/manuals/standards/geometry-asset-ontology.md §3). This is the “mesh → .10d” step of the 3-D-anatomy asset pipeline: the renderer and the anatomy layer read the .10d back with decode_10d_mesh instead of reparsing the source GLB, and the q42 semantic manifest cites the container’s compiled_digest.
compile_10d_manifest
Attach the opt-in v2 identity manifest to an existing sealed .10d container. Opt-in attachment of identity-v2 metadata to an already compiled .10d asset.
contract
Phenomenal viewport CI contract — WGSL bindings, binary layout, and regression oracles.
control
Interface Control Plane (ICP) — fixed-size PortalControlCommand envelopes.
cpu_texture_mips
Caller-buffered CPU RGBA8 mip reducer and format-specific reference filtering. Caller-buffered CPU RGBA8 mip reducer and format-specific reference filtering.
deferred_resolve
Deferred resolve CPU reference oracle and continuous EMF spectral PBR integration. Deferred resolve CPU reference oracle and continuous EMF spectral PBR integration.
derivation
Decoupled Derivation Job (P2)
entity_compile_gates
Deterministic validation gates and TAA Oklab perceptual clamping for entity compilation. Deterministic Validation Gates & TAA Oklab Clamping for qualia-cli entity-compile.
frame_graph
Allocation-free frame graph resource and pass dependency model. Allocation-free frame graph resource and pass dependency model.
gamut
P7.2 — Gamut / object-colour solid + closest-point gamut mapping. P7.2 — Gamut / object-colour solid + closest-point gamut mapping.
gpu
WebGPU renderer (PortalGpu) — depth, bloom, tensor-node projection, mesh surfaces. Cross-platform WebGPU viewport for the Qualia renderer SDK.
gpu_colour_kernel
P7.4 — GPU colour-projection / gamut batch kernel + CPU oracle. P7.4 — GPU colour-projection / gamut batch kernel + CPU oracle.
hardware_governor
Dynamic GPU memory & compute throughput governor. Dynamic Memory & GPU Compute Throughput Governor.
hmc_playback
Browser HMC mesh source verification and resident-upload lifecycle. Browser HMC mesh playback and resident-upload bookkeeping.
instance_culling
Caller-buffered CPU frustum visibility lists with stable source-index indirection. Canonical packed instance ABI and deterministic visibility delegation.
lighting
Physically-based and stylized cinematic lighting evaluation. Physically-based and stylized cinematic lighting evaluation.
lod_chain
LOD chain (P5.8): author mesh → decimate N LODs → serialize to .10d → renderer parses each level → plan_view selects the expected LOD. Gated like the scientific geometry stack (needs crate::specialized_libs). P5.8 — LOD chain: author mesh → decimate N LODs → serialize to .10d → renderer parses each level → plan_view selects the expected LOD.
material_compile
Material-section compilation and readback helpers for versioned .10d assets. Cold-path material/submesh compilation over the canonical .10d geometry compiler.
mesh_surface_frames
Caller-buffered seam-aware box projection and source normal generation. Caller-buffered seam-aware box projection and source normal generation.
mesh_tangent_frames
Caller-buffered UV-aligned tangent frames for authored normal maps. Caller-buffered UV-aligned tangent frames for authored normal maps.
metamer
P7.1 — Metamers as the affine fibre of the colour-matching projection. P7.1 — Metamers as the affine fibre of the colour-matching projection.
model_substrate
Model-as-substrate (Phase 6, §F): one buffer holds a renderable manifold AND the transcoded P64 weights; the renderer projects the manifold while the weights are co-resident. Gated to where crate::p64_weight (the transcoder) compiles. Phase 6 — model-as-substrate (graph–tensor duality, STELLAR §F).
naga_bridge
Naga bridge: WGSL → naga IR → GLSL ES 300 compilation. Naga bridge: WGSL source → naga IR → GLSL ES 300 compilation.
naga_sanitize
Naga IR sanitizer for WebGL2 (GLSL ES 300) compatibility. Naga IR sanitizer for WebGL2 (GLSL ES 300) compatibility.
navigation
GPU/CPU node picking helpers and camera fly-to for PR-C11 navigation.
output
Scene-linear display output and manual exposure controls. Scene-linear display output and manual exposure controls.
pga
3D PGA motors as dual quaternions — CPU oracle for projector.wgsl Phase 2b+.
physics
Physics of artefacts — bbox admission, kinematic joints, material/mass/momentum (Phase 2). Physics of artefacts (Phase 2, RENDERER_IMPLEMENTATION_PLAN.md).
place_time
Place / space / time binding — an artefact NQuin queried by the spatio-temporal AND deontic modalities over one shared identity (Phase 3); delegates to the inherited modality stack. Gated to exactly the configs where crate::modalities (the values/logic layer it builds on) is compiled — native always; on wasm only with the logic/scientific/full feature sets, not the minimal portal bundle. Phase 3 — place / space / time binding for artefacts (STELLAR §E step 3).
portal_emf_state
Bounded field ownership and GPU adoption/recovery state, testable natively. One accepted current field and exact immutable source, independent of GPU life.
portal_load_10d
CPU decode for QualiaPortal load_10d (SurfaceReading + UV01 + MAT3/MAT4 + orbit-frame mesh). Lives outside the wasm-only portal facade so native tests can cover the colour/UV/MAT path. CPU decode for QualiaPortal load_10d.
portal_load_emf
CPU admission of current EMF and explicit local-grid display projection. Current EMF typed admission and bounded local-frame display projection. Exact source, physical vectors/units, clocks and frames remain scientific data; display magnitude does not imply carrier, colour, sigma or acoustic frequency.
portal_load_textures
PNG/KTX2 ingest for load_10d materials. Decode budgets are not the Prolog sentinel. PNG/KTX2 ingest for QualiaPortal load_10d materials.
portal_qac
Admitted current QAC source and bounded exact-sample windows. Retained current QAC observations for CPU/browser adapters. Admission is cold and bounded; immutable windows never rehash or allocate. No audio normalization, pressure conversion, playback, or synthesized previews.
projection
Unified manifold projection — one project(), many views (Phase 1.4). Unified manifold projection (Phase 1.4, RENDERER_IMPLEMENTATION_PLAN.md) — one projection, many views.
quality_profiles
Deterministic native/WASM render-quality admission and graceful-degradation budgets. Deterministic native/WASM render-quality admission and graceful-degradation budgets.
quality_runtime
Fixed-memory adaptation policy with sustained-load hysteresis and bounded decision receipts. Fixed-memory adaptation policy with sustained-load hysteresis and bounded decision receipts.
rdf_holograph
RDF / NQuin → 96-byte holographic node layout (10D fold, RGBA32F atlas). RDF / NQuin → holographic semantic-graph layout.
rdf_holograph_vibe
VibeScript theatre adapter: eval construct_theatre, pack via layout_placed_into. QualiaPortal theatre adapter: evaluate a VibeScript scene, pack GPU nodes.
scene_graph
N7: Scene graph — node hierarchy, lights, semantic links, duplication, IK, smooth damp. Scene graph — generational 10D node pool, prefab delta inheritance, .10d EONT1 living ontology binding, topological PGA [Motor] propagation, lights, semantic links, and IK.
scene_primitives
Bounded cold-path primitive assembly for authored interactive scenes. Deterministic primitive assembly for small authored scenes. Geometry is built once when scene state changes; rendering remains in the portal.
screen_metric
Screen-space visual angle error, retinal slip acuity, and 4-tier virtualization classifier. Screen-space visual angle error, retinal slip acuity, and 4-tier virtualization classifier.
sense
Sense path — the input twin (Phase 4): microphone PCM → forward DSP → the ∫Ψ > τ → Fact bridge, every capture under the deontic/standpoint consent gate (surveillance-refusal default). Gated like place_time (needs crate::modalities). Phase 4 — the sense path (the input twin of the renderer; STELLAR §D).
skeletal
Caller-buffered VibeScript motor rig sampling, attachments and skinning. Caller-buffered skeletal animation using the rigid motor algebra (etalon_render::skeletal). Joint transforms are rigid; authoring scale is baked into mesh/bind positions. Sampling, hierarchy composition and skinning allocate no heap memory.
source_frame
Borrowed source-bound pose contract and cold canonical model admission. Borrowed source-bound pose publication. This is view state, not a player, source store, authority grant, renderer or frame clock.
spectral
Spectral perceptual palette — re-exported from etalon-render.
spectral_basis
Continuous EMF spectral basis functions (Jakob-Hanika), closed-form Gaussian moments, and wave optics. Continuous EMF spectral basis functions (Jakob-Hanika), closed-form Gaussian moments, and wave optics.
spectral_blend
P7.3 — σ spectral blend as interpolation on the spectral manifold. P7.3 — σ spectral blend as interpolation on the spectral manifold.
spectral_kernel
P7.0 — Spectral-space kernel: SPD/CMF POD types + CIE linear-projection. P7.0 — Spectral-space kernel: SPD/CMF POD types + CIE linear-projection.
spectral_lut
Pure-Rust Levenberg-Marquardt spectral inversion solver, 32x32x32 LUT baker, and zero-heap trilinear sampler. Deterministic Zero-Heap Spectral Inversion LUT & Levenberg-Marquardt Solver in Pure Rust.
spectral_operator
P7.7 — Unified spectral-operator API surface. P7.7 — Unified spectral-operator API surface.
spectral_oracle
P7.8 — golden-oracle + CPU/GPU differential + determinism harness. P7.8 — golden-oracle + CPU/GPU differential + determinism harness.
standpoint
Human-Centric observer standpoint — the chosen context and right to perceive (decoupled from the camera lens; no hardware fingerprinting).
surface_authoring
Bounded authored surface maps and planar UV projection, native and WASM. Deterministic tileable surface authoring. Callers own all public output.
telemetry
GPU telemetry and observer contracts for the Qualia portal (U2 viewport).
temporal_producers
Reference math and host producer models for temporal accumulation. Reference math and host producer models for temporal accumulation.
temporal_resolve
Bounded temporal resolve policy, history lifecycle, and CPU reference oracle. Bounded temporal resolve policy, history lifecycle, and CPU reference oracle.
texture_decode
Bounded, caller-buffered PNG/JPEG decode from verified external texture resources. Bounded cold-path image decoding for renderer resources.
texture_ingestion
Production texture ingestion for external/data URI and embedded images.
texture_ktx2
Allocation-free KTX2 container metadata and level-range parser (native + WASM). Allocation-free KTX2 container metadata and level-range parser (native + WASM).
texture_ktx2_rgba8
Allocation-free decoder for uncompressed single-face RGBA8 KTX2 base levels. Allocation-free decoder for uncompressed single-face RGBA8 KTX2 base levels.
texture_stream_policy
Deterministic caller-buffered texture mip residency planning and budget admission. Deterministic caller-buffered texture mip residency planning and budget admission.
texture_streaming_plan
Deterministic, allocation-free mip admission for texture streaming.
texture_transcode
Bounded zero-heap compressed texture transcode and block decode bridge. Bounded zero-heap compressed texture transcode and block decode bridge.
vegetation
Bounded zero-heap vegetation instance pool and dynamic collision bending. Bounded zero-heap vegetation instance pool and dynamic collision bending.
vertebrate_anatomy
Scale-5 Comparative Vertebrate 3-Layer .10d Anatomy (Skeletal / Muscular / Integument). Comparative Vertebrate Anatomy & 3-Layer Biomechanical Living Containers (zoological_anatomy.rs).
water_surface
Caller-buffered shoreline attributes for native open water meshes.