GetVehicleTurretPosition: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 6: Line 6:


This function also has two variants that allow you to retrieve data from just one of the two axes.
This function also has two variants that allow you to retrieve data from just one of the two axes.
{{UsingRadians}}


===Required Arguments===
===Required Arguments===
Line 13: Line 11:


===Returns===
===Returns===
Returns two [[float]]s for the X (horizontal) and Y (vertical) axis rotation respectively. The function will return ''false'' in the first return value if the vehicle does not have a driver or the vehicle is not a vehicle with a turret.
Returns two [[float]]s for the X (horizontal) and Y (vertical) axis rotation respectively. These values are in radians. The function will return ''false'' in the first return value if the vehicle does not have a driver or the vehicle is not a vehicle with a turret.  
 
{{UsingRadians}}


==Example==
==Example==

Revision as of 00:11, 19 May 2006

This function gets the position of a vehicle's turret, if it has one. Vehicles with turrets include firetrucks and tanks.

Syntax

float float getVehicleTurretPosition ( vehicle turretVehicle )

This function also has two variants that allow you to retrieve data from just one of the two axes.

Required Arguments

  • turretVehicle: The vehicle whose rotation you want to retrieve. This should be a vehicle with a turret with a player in.

Returns

Returns two floats for the X (horizontal) and Y (vertical) axis rotation respectively. These values are in radians. The function will return false in the first return value if the vehicle does not have a driver or the vehicle is not a vehicle with a turret.

Template:UsingRadians

Example

-- Find all the vehicles, and store them in a vehicles variable
vehicles = getElementsByType ( "vehicle" )
-- Loop through the vehicle list
for vehicleKey, vehicleValue in vehicles do
	-- Get the vehicle's turret position
	x, y = getVehicleTurretPosition ( vehicleValue ) 
	-- If the vehicle has a turret (the function will return false if it doesn't) then
	if ( x ~= false )
		-- Tell everyone in the chat the turret's position
		outputChatBox ( "Turret position: " .. x .. ", " .. y .. "." )	
	end
end