GetPlayerRotation

From Multi Theft Auto: Wiki
Revision as of 18:45, 22 April 2007 by Jbeta (talk | contribs)
Jump to navigation Jump to search

This function returns the current rotation (in degrees) of a player around the Z axis. It's used with on-foot players: use getVehicleRotation on the occupied vehicle if the player is in one.

Syntax

float getPlayerRotation ( player thePlayer )

Required Arguments

  • thePlayer: the player whose rotation you want to retrieve.

Returns

Returns a float containing the player's rotation, or false if an invalid player (or one in a vehicle) was passed.

Example

This code adds a getrot command to get the player's current rotation.

-- register outputPlayerRotation as a handler for the getrot command
addCommandHandler ( "getrot", "outputPlayerRotation" )

function outputPlayerRotation ( sourcePlayer )
	-- if the command was triggered by an ingame player
	if ( sourcePlayer ) then
		-- if he is in a vehicle
		if isPlayerInVehicle ( sourcePlayer ) then
			-- store the vehicle element
			local playerVehicle = getPlayerOccupiedVehicle ( sourcePlayer )
			-- and output its rotation
			outputChatBox ( "Your vehicle's rotation is: " .. getVehicleRotation ( playerVehicle ), sourcePlayer )
		-- if he is on foot
		else
			-- output the player's rotation
			outputChatBox ( "Your rotation is: " .. getPlayerRotation ( sourcePlayer ), sourcePlayer )
		end
	end
end

See Also