SetPlayerRotation: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Server function}}
{{Server client function}}
{{Deprecated|setElementRotation}}


__NOTOC__  
__NOTOC__  
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.
This function allows you to set the current rotation of the specified player.


==Syntax==  
==Syntax==  
Line 11: Line 12:
===Required Arguments===  
===Required Arguments===  
*'''thePlayer:''' The [[player]] to set the rotation of
*'''thePlayer:''' The [[player]] to set the rotation of
*'''rotation:''' A [[float]] specifying the desired rotation.
*'''rotation:''' A [[float]] specifying the desired rotation in degrees.


===Returns===
===Returns===
Line 17: Line 18:


==Example==  
==Example==  
This example code makes the player named Cheesepie look south.
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 ( player, command )
<syntaxhighlight lang="lua">function discoTime ( player )
     -- Randomly choose a new playe rotation and set it
     -- Randomly choose a new player rotation and set it
     newRotation = math.random ( 0, 360 )
     newRotation = math.random ( 0, 360 )
     setPlayerRotation ( player, newRotation )
     setPlayerRotation ( player, newRotation )
end
end


--When 'disco' command is typed
function initiateDiscoMode ( player, commandName )
function initiateDiscoMode ( player, commandName )
     --Trigger a random change in player rotation every second.
     --Trigger a random change in player rotation every second
     --Send the player who activated discoTime to the function so his rotation will be changed.
     --Send the stored 'activating player' to the discoTime
    --function, so his rotation will be changed.
     setTimer (discoTime, 1000, 0, player )
     setTimer (discoTime, 1000, 0, player )
end
end
Line 34: Line 35:
==See Also==
==See Also==
{{Player functions}}
{{Player functions}}
[[Category:Incomplete]]

Latest revision as of 22:13, 5 July 2014

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use setElementRotation instead.


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

Syntax

bool setPlayerRotation ( player thePlayer, float rotation )         

Required Arguments

  • thePlayer: The player to set the rotation of
  • rotation: A float specifying the desired rotation in degrees.

Returns

Returns true if successful, false otherwise.

Example

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.

function discoTime ( player )
     -- Randomly choose a new player rotation and set it
     newRotation = math.random ( 0, 360 )
     setPlayerRotation ( player, newRotation )
end

function initiateDiscoMode ( player, commandName )
     --Trigger a random change in player rotation every second
     --Send the stored 'activating player' to the discoTime
     --function, so his rotation will be changed.
     setTimer (discoTime, 1000, 0, player )
end
addCommandHandler ( "disco", initiateDiscoMode )

See Also