Skip to main content

Module physics

Module physics 

Source
Expand description

Physics of artefacts — bbox admission, kinematic joints, material/mass/momentum (Phase 2). Physics of artefacts (Phase 2, RENDERER_IMPLEMENTATION_PLAN.md).

Deterministic, zero-alloc operators over rendered artefacts, built on the PGA motor oracle (render::pga) so physics and the GPU projector share one geometry:

  • aabb — axis-aligned extent + rigid/scale transform of an artefact’s box.
  • admission — deterministic admission of a proposed transform; refuses contraction below a material floor or movement outside world bounds (no probabilistic guess).
  • joint — kinematic joints as PGA motors animated over time t (composable into chains).
  • material — mass / material / momentum (the P in the Manifold-Coordinate).

Rail-check: deterministic prevention; zero-heap operators (fixed arrays, no Vec in the path).

Modules§

aabb
Axis-aligned bounding box for an artefact, and the rigid+scale transform of its extent.
admission
Deterministic admission of a proposed transform on an artefact (Phase 2).
joint
Kinematic joints as PGA motors animated over time t (Phase 2).
material
Material, mass, and momentum for an artefact.
response
Bounded driven spring response for articulated scene bodies. Integration delegates to the canonical Qualia calculus solver, not a renderer-local RK4.

Structs§

Aabb
An axis-aligned bounding box (model or world space).
Admission
An admission policy for an artefact: how far it may be compressed, and where it may exist.
Body
A physical body: a material filling a bounding box, with a linear velocity.
Joint
A single-DOF kinematic joint driven by a constant rate.
Material
Bulk material properties of an artefact.

Enums§

JointKind
The kind of single-DOF joint.
Refusal
Why a transform was refused. Carries the offending measurement so the caller can report it.

Functions§

chain_motor_at
Compose a chain of joint motors at time t (root-first): m0 ⊗ m1 ⊗ … ⊗ mn. Zero-alloc.