@ue-too/math / 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
typescript
// 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