@ue-too/math / index / angleSpan

Function: angleSpan()

angleSpan(from, to): number

Defined in: index.ts:722

Calculates the smallest angular difference between two angles.

Parameters

from

number

Starting angle in radians

to

number

Ending angle in radians

Returns

number

The smallest angle span from 'from' to 'to', in range (-π, π]

Remarks

This function accounts for wrapping around 2π and always returns the shorter path. Positive result means counter-clockwise rotation, negative means clockwise.

Example

// From 0° to 90°
angleSpan(0, Math.PI / 2); // π/2 (90 degrees CCW)

// From 350° to 10° (shorter to go CCW through 0°)
angleSpan(350 * Math.PI / 180, 10 * Math.PI / 180); // ≈ 20 degrees

// From 10° to 350° (shorter to go CW through 0°)
angleSpan(10 * Math.PI / 180, 350 * Math.PI / 180); // ≈ -20 degrees