~~NOTOC~~
<=[[4rpl:start| Index]]

<WRAP tabs>
  * [[4rpl:commands:getunitorientation|Get]]
  * [[4rpl:commands:setunitorientation|Set]]
</WRAP>

:!: Available in version 2.3.2 and later.
====== SetUnitOrientation ======
SetUnitOrientation(<-unit <-orientation)

===== Description =====
Set the orientation of a unit. The orientation is one of 4 values, 0,1,2,3. These correspond to FORWARD, RIGHT, BACK, LEFT. The default orientation for units is 0, or FORWARD.  Changing the orientation will rotate the unit, in increments of 90 degrees, to face in the given orientation. If the unit occupies the map, the cells occupied by the unit will be updated.

===== Examples =====
<code 4rpl>
SetUnitOrientation(self 1)
</code>

=== See also ===

  * [[GetUnitOrientation]]
  * [[SetUnitRotation]] rotates unit an arbitrary amount


<=[[4rpl:start| Index]]