SetPlayerRotation: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Server function}}
{{Server client function}}
{{Needs_Checking|The rotation must be a varible, it cannot be an actual number. For example, getplayerrotation and set it to a varible, then set player rotation to that varible + 10. Vehicle rotation function worked with a number. Other rotation functions may not be accepting numbers too, but vehicle did. So I doubt it. -Ransom}}
{{Deprecated|setElementRotation}}
[[Category:Incomplete]]


__NOTOC__  
__NOTOC__  
Line 13: 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 19: 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">
<syntaxhighlight lang="lua">function discoTime ( player )
cheesepie = getPlayerFromNick ( "Cheesepie" )     -- try to get the player by his nick
    -- Randomly choose a new player rotation and set it
if ( cheesepie ) then                            -- make sure we found him (there may be no player named Cheesepie on the server)
    newRotation = math.random ( 0, 360 )
    setPlayerRotation ( cheesepie, 180 )         -- set his roation
    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
end
</syntaxhighlight>
addCommandHandler ( "disco", initiateDiscoMode )</syntaxhighlight>


==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