uē-tôo

Appearance

@ue-too/board / angleSpan

Function: angleSpan() ​

angleSpan(from, to): number

Defined in: packages/board/src/camera/utils/rotation.ts:274

Calculates the signed angular distance between two angles, taking the shorter path.

Parameters ​

from ​

number

Starting angle in radians

to ​

number

Target angle in radians

Returns ​

number

Signed angular difference in radians, in the range (-π, π]

Remarks ​

Returns the shortest angular path from from to to:

  • Positive value: rotate counter-clockwise (positive direction)
  • Negative value: rotate clockwise (negative direction)
  • Always returns the smaller of the two possible paths

Example ​

typescript
angleSpan(0, Math.PI/2);        // π/2 (90° ccw)
angleSpan(Math.PI/2, 0);        // -π/2 (90° cw)
angleSpan(0, 3*Math.PI/2);      // -π/2 (shorter to go cw)
angleSpan(3*Math.PI/2, 0);      // π/2 (shorter to go ccw)
angleSpan(0, Math.PI);          // π (180°, ambiguous)