oxijolt — safe Rust API for Jolt Physics

The safe API of oxijolt over the raw bindings in oxijolt-sys, built on the joltc C wrapper of Jolt Physics 5.6. Everything is headless.

A PhysicsWorld holds:

• rigid bodies of box, sphere, cylinder, capsule, tapered capsule and cylinder, convex hull, triangle mesh, heightfield, compound and scaled shapes;
• scene queries;
• characters, wheeled vehicles and ragdolls;
• twelve kinds of constraints;
• soft bodies;
• contact and activation events, and a contact listener.

A world's state can be saved and restored, and the world moved to a floating origin. Jolt's jobs run on Jolt's thread pool or on the caller's. The repository's README says what is not bound yet, and its docs/ directory has the guides.

use oxijolt::prelude::* brings in the commonly used types; the math types are in oxijolt::prelude::math.

Features

• double-precision: world positions in f64; forwards to oxijolt-sys/double-precision.
• cross-platform-deterministic: forwards to oxijolt-sys/cross-platform-deterministic.
• debug-renderer: forwards to oxijolt-sys/debug-renderer and enables PhysicsWorld::debug_lines.
• asserts: Jolt's debug assertions (oxijolt-sys/asserts); a failed assertion prints its message and aborts the process. The one exception is the physics-update-error assertion: the step goes on and its StepReport says what was dropped.
• bindgen: generates the raw bindings with libclang at build time (oxijolt-sys/bindgen).