View source for SetPedRotation

__NOTOC__
{{Server client function}}
{{Deprecated|setElementRotation|}}

This function allows you to set the current rotation of the specified ped.

==Syntax== 
<syntaxhighlight lang="lua">
bool setPedRotation ( ped thePed, float rotation [, bool conformPedRotation = false ] )         
</syntaxhighlight> 

===Required Arguments=== 
*'''thePed:''' The [[ped]] to set the rotation of
*'''rotation:''' A [[float]] specifying the desired rotation in degrees.

===Optional Arguments=== 
{{New feature/item|3.0152|1.3.2|4680|
*'''conformPedRotation:''' A bool which should be set to ''true'' to ensure the ped rotation is correctly set in all circumstances. Failing to set this argument may result in the rotation being inverted when the ped is in the air and other inconsistencies. The default value of false is for backward compatibility with scripts which may depend upon the incorrect behaviour
}}

===Returns===
Returns ''true'' if successful, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This example allows a player to type the command 'disco', which will result in the player being rotated to a random direction every 1 second, infinite times.
<syntaxhighlight lang="lua">function discoTime ( )
     -- Randomly choose a new player rotation and set it
     newRotation = math.random ( 0, 360 )
     setPedRotation ( getLocalPlayer(), newRotation )
end

function initiateDiscoMode ( commandName )
     -- Trigger a random change in player rotation every second
     setTimer ( discoTime, 1000, 0 )
end
addCommandHandler ( "disco", initiateDiscoMode )
</syntaxhighlight>
</section>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.1-9.04680|Added conformPedRotation argument}}

==See Also==
{{Ped_functions}}
[[ru:setPedRotation]]