~~NOTOC~~
<=[[4rpl:start| Index]] \\
<=[[4rpl:start#math_utility| Math Utility]]


====== ShortestAngle ======
ShortestAngle(<-cur <-new) ->rotAngle

===== Description =====
Given two angles in radians, calculates the shortest angle between the two. Useful for determining which direction a unit should rotate in order to turn to a given direction. A positive or negative value will be returned in the range of PI to -PI. Negative values indicate clockwise rotation.

===== Examples =====
<code 4rpl>
trace(ShortestAngle(1.1 2.5))
</code>
<=[[4rpl:start| Index]]