Transform Points

Read named attachment frames for models, propellers, cameras, lights or effects.

Verified against the project sources on 19 September 2026.

Syntax#

jolt_asset_get_point(asset, point_ref);
jolt_asset_get_point_transform(asset, point_ref, [body]);
jolt_asset_create_point(asset, point_ref, body);

Factories return undefined on failure; inspect jolt_get_error() immediately. Authoring lookups return independent validated record copies. A reference is a canonical UUID or an exact, case-sensitive Key. Body owners must be live managed bodies in the current world.

World frame = current Body origin transform × authored local transform. The center of mass is not the authoring origin. Positions use metres and rotations use normalized XYZW quaternions. Refresh snapshots as the body moves.

Transform Point is a neutral spatial marker. JSON v2 points[] contains id, key, optional name, position and rotation, with no scale, radius, force or gameplay type. Blender displays a fixed 0.24 m pink cube and 0.30 m RGB axes; runtime +X/+Y/+Z matches Blender −X/+Y/+Z. Use G/R; scale is locked.

Result shapes#

Example#

// Create: the asset contains Key "propeller_left".
propeller_point = jolt_asset_create_point(asset, "propeller_left", body_vehicle);
// Step or Draw: request a fresh world transform.
if (!is_undefined(propeller_point) && propeller_point.is_valid()) {
    var frame = propeller_point.get_transform();
    var model_matrix = model_matrix_from_transform(frame);
    // Pass model_matrix to your rendering system.
}
jolt_debug_enable(true);
jolt_debug_set(JOLT_DEBUG_POINTS, true);

Configured points store a snapshot of the asset and follow their current static/kinematic/dynamic owner. They allocate no native resource and apply no physics. Call destroy() when finished; owner destruction or jolt_stop() invalidates them automatically. Invalid getters return undefined. Bare lookup/transform calls do not register a debug marker.

Verified operation contracts#

These contracts distinguish units, return values, errors and lifetime according to the current implementation. Check results: false, 0 and undefined can mean different things for different methods.