Smooth Paths

Builds a cubic Hermite curve and provides distance-aware sampling utilities.

build_smooth() generates missing tangents, constructs the native PathConstraintPathHermite, transports a stable normal along the curve, applies each point's roll, and builds an approximate arc-length table.

Syntax#

track.build_smooth(smoothness=1.0);

Requirements#

Automatic tangent rule#

• Interior open-path and all loop tangents use 0.5 × smoothness × (next − previous).
• Open-path endpoints use smoothness times their adjacent segment.
• Tangents added with add_point_tangent() are preserved.

Sampling by arc length#

var midpoint = track.get_position(0.5);
var direction = track.get_direction(0.5);

var distance = track.get_length() * 0.25;
var position = track.get_position_at_distance(distance);
var tangent = track.get_direction_at_distance(distance);

Public fractions represent normalized approximate arc length, not the raw per-segment Hermite parameter. Fraction 0.5 is therefore the physical midpoint of the path.

Frames and spatial queries#

var euler = track.get_rotation(0.5);
var quaternion = track.get_rotation_quaternion(0.5);
var nearest = track.get_closest_point(x, y, z);
var bounds = track.get_bounds();

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.