Skip to main content

Module scene_graph

Module scene_graph 

Source
Expand description

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.

Preserves the legacy authoring [SceneGraph] / [SceneNode] types alongside the Tier-1 (HotZeroHeap) generational [NodePool] and [SceneNodeRecord] architecture.

Re-exports§

pub use ontology_binding::apply_ontogenetic_allometry;
pub use ontology_binding::dispatch_affordance;
pub use ontology_binding::interpolate_ontogenetic_scales;
pub use ontology_binding::AffordanceDispatchOutcome;
pub use ontology_binding::DevelopmentalStage;
pub use ontology_binding::LivingOntologyState;

Modules§

ik
Inverse kinematics — look-at and CCD (Cyclic Coordinate Descent).
light
Light sources — point, directional, spot, ambient.
node
Scene graph nodes — hierarchy, duplication, semantic links.
ontology_binding
.10d EONT1 Living Ontology & Affordance Scene-Graph Binding (ontology_binding.rs).
pool
Zero-Heap Generational 10D Scene Graph Pool (pool.rs).
prefab
Prefab Property Inheritance & Delta Mask (prefab.rs).
smooth_damp
Smooth damp — critically-damped spring smoothing (Unity-style).
transform_sync
Zero-Heap Topological PGA Motor Hierarchy Propagation (transform_sync.rs).

Structs§

IkResult
IK solver result.
InheritableField
Wrapper for an individual inheritable property with $O(1)$ delta-mask tracking.
Light
A light source in the scene.
NodeHandle
Generational handle referencing a SceneNodeRecord inside a NodePool.
NodePool
Fixed-capacity, zero-heap generational scene node pool.
NodePoolSlice
Slice-backed view over caller-provided arena slices (supports up to MAX_SCENE_ARENA_NODES = 16,384+ nodes).
PrefabDeltaMask
64-bit bitmask tracking which fields of a SceneNodeRecord have been overridden on an instance.
SceneGraph
The scene graph — a collection of nodes with hierarchy.
SceneNode
A scene graph node with a local transform and optional children.
SceneNodeRecord
192-byte (3 cache-line) zero-heap scene graph node record.
SemanticLink
A semantic link between a scene node and a semantic entity (IRI).
SyncedHolographicNode
Platform-agnostic 96-byte GPU record matching HolographicNodeGpu byte-for-byte.
SyncedInstanceTransform
Dirty GPU instance transform emitted during propagate_transforms_zero_heap.
TransformSyncSummary
Summary counts returned by propagate_transforms_zero_heap.

Enums§

LightType
Light source type.
NodeKind
Multi-modal representation kind of a scene node in the unified .10d / Holographic pipeline.

Constants§

INVALID_GENERATION
Sentinel generation value indicating an unallocated or invalid NodeHandle.
MAX_SCENE_ARENA_NODES
Maximum supported node capacity for slice-backed caller arenas.
VISIBILITY_CAST_SHADOWS
VISIBILITY_HOLOGRAPHIC_INTERFERENCE
VISIBILITY_RAYCAST_PICKABLE
VISIBILITY_RECEIVE_SHADOWS
VISIBILITY_VISIBLE
Visibility bitflags for SceneNodeRecord::visibility_flags.

Functions§

apply_archetype_to_instance
Propagates all non-overridden fields from a parent .10d archetype record into instance in $O(1)$ time while respecting instance.modified_mask.
bilateral_pull_active_for_node
Checks whether bilateral deontic pull is active for a given scene node and observer DID.
ccd_ik
CCD (Cyclic Coordinate Descent) IK solver.
compute_topological_order
Computes a parent-before-child topological ordering of active nodes into out_order.
duplicate_node
Convenience function: duplicate a node in a scene graph.
link_semantic
Convenience function: link a scene node to a semantic entity.
look_at_ik
Look-at IK: rotate a chain so the end effector points toward a target.
override_local_motor
Overrides instance.local_motor and marks BIT_LOCAL_MOTOR in instance.modified_mask.
override_local_scale
Overrides instance.local_scale and marks BIT_LOCAL_SCALE in instance.modified_mask.
override_material_id
Overrides instance.material_id and marks BIT_MATERIAL_ID in instance.modified_mask.
override_node_kind
Overrides instance.node_kind and marks BIT_NODE_KIND in instance.modified_mask.
propagate_transforms_zero_heap
Propagates world PGA Motor transforms in topological order with zero heap allocation.
smooth_damp
Smoothly damp a scalar value toward a target.
smooth_damp_vec3
Smoothly damp a 3D vector toward a target.