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
.hmcanatomy asset pack (per-organ system / position / neutral colour). Platform-agnostic (native + WASM consumers). Shared metadata schema for a.hmcanatomy asset pack — the per-organmetacarried 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/STLmesh →NQuinstream (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(needscrate::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
AnatomyBodyFitto decoded organ vertices. - botanical_
anatomy - 4-Scale Botanical
.10dOrgan & Histology Dissection (FLOWER/LEAF/WOOD/ROOT). Botanical 4-Scale Digital Twin Anatomy, Histological Dissection & Living Container Generator. - camera
- Orbit camera → column-major
view_projectionfor 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
Meshinto a sealed.10dcontainer (the dense compiled-geometry sidecar) and read it back — the “mesh →.10d” step of the 3-D-anatomy asset pipeline. Compile an imported triangleMeshinto a sealed.10dcontainer — the dense compiled-geometry half of a geometry asset (seedocs/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.10dback withdecode_10d_meshinstead of reparsing the source GLB, and the q42 semantic manifest cites the container’scompiled_digest. - compile_
10d_ manifest - Attach the opt-in v2 identity manifest to an existing sealed
.10dcontainer. Opt-in attachment of identity-v2 metadata to an already compiled.10dasset. - contract
- Phenomenal viewport CI contract — WGSL bindings, binary layout, and regression oracles.
- control
- Interface Control Plane (ICP) — fixed-size
PortalControlCommandenvelopes. - 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_viewselects the expected LOD. Gated like the scientific geometry stack (needscrate::specialized_libs). P5.8 — LOD chain: author mesh → decimate N LODs → serialize to.10d→ renderer parses each level →plan_viewselects the expected LOD. - material_
compile - Material-section compilation and readback helpers for versioned
.10dassets. Cold-path material/submesh compilation over the canonical.10dgeometry 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.wgslPhase 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 minimalportalbundle. 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-onlyportalfacade so native tests can cover the colour/UV/MAT path. CPU decode for QualiaPortalload_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_10dmaterials. Decode budgets are not the Prolog sentinel. PNG/KTX2 ingest for QualiaPortalload_10dmaterials. - 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 vialayout_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,
.10dEONT1living 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
∫Ψ > τ → Factbridge, every capture under the deontic/standpoint consent gate (surveillance-refusal default). Gated likeplace_time(needscrate::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
.10dAnatomy (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.