Skip to main content

Module holographic_scene

Module holographic_scene 

Source
Expand description

Holographic Scene State-Graph, Scoped Manifold Slicing, and Predicate Broadcast Triggers.

Implements the zero-heap neuro-symbolic scene loop:

  1. Scoped State-Graph Slicing (WholeScene, Topic, SubjectClass, ManifoldNeighborhood)
  2. Compact CBOR-LD binary frame encoding/decoding into caller-supplied buffers
  3. Multi-second Animation Preset & Sub-Part Command NQuin packing/unpacking
  4. Zero-heap Predicate Broadcast Trigger evaluation across asset arrays with radial propagation delay, Allen Interval sequencing, and Defeater (DEFEATER_BIT) overrides
  5. Multi-vendor .p64 neural extension slot selection with Tier-0 universal fallback

Structs§

AssetStateNode
Live state-graph node for one scene asset (.10d flora/fauna or CAD mechanical assembly).
P64ExtensionSlot
Vendor/checkpoint slot descriptor inside a .p64 neural extension container.
PredicateTriggerRule
Declarative predicate broadcast rule emitted by the Scene AI or loaded from a .p64 cartridge.
ScheduledPresetCommand
Concrete multi-second animation preset command scheduled onto a matching asset.

Enums§

SceneGraphError
SceneSliceScope
Scope filter for querying a holographic slice of the scene state graph.

Constants§

CBOR_LD_SCENE_MAGIC
OP_SCENE_BLEND_SUBPART
OP_SCENE_DEFEATER_CANCEL
OP_SCENE_PLAY_PRESET
OP_SCENE_PREDICATE_TRIGGER

Functions§

decode_trigger_rules_cbor_ld_into
Decode compact CBOR-LD binary trigger rules emitted by the Scene AI into out_rules (zero-heap).
encode_scene_slice_cbor_ld_into
Encode a scoped slice of AssetStateNodes into a compact CBOR-LD binary frame (zero-heap). Each record is 44 bytes after the 8-byte header (CBOR_LD_SCENE_MAGIC + u32 count).
evaluate_predicate_triggers_zero_heap
Evaluate rules triggered by (trigger_event_hash, trigger_origin) across assets, honoring defeater_quins (DEFEATER_BIT) and radial wave propagation delays (zero-heap).
pack_preset_command_quin
Pack a multi-second animation preset command into a parity-valid 48-byte NQuin.
pack_preset_defeater_quin
Pack a Defeater (DEFEATER_BIT) Quin that cancels or overrides predicate triggers for entity_did.
select_p64_vendor_slot
Select the best matching vendor/model neural extension slot from a .p64 cartridge, returning None when the caller should use the Tier-0 universal CBOR-LD + NQuin fallback.
slice_scene_state_graph
Filter assets by scope into caller-supplied out_indices (zero-heap hot path).