GetVehicleTurretPosition

From Multi Theft Auto: Wiki
Revision as of 17:19, 18 August 2007 by Norby89 (talk | contribs) (→‎Example)
Jump to navigation Jump to search


Dialog-information.png This article needs checking.

Reason(s): if the vehicle has no turret it returns 0, 0 not falseas the desciption says --Norby89 10:05, 18 August 2007 (CDT)

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
local vehicles = getElementsByType ( "vehicle" )
-- Loop through the vehicle list
for vehicleKey, vehicleValue in ipairs(vehicles) do
	-- Get the vehicle's turret position
	local x, y = getVehicleTurretPosition ( vehicleValue ) 
	-- If the vehicle has a turret (the function will return false if it doesn't) then
	if ( x ~= false ) then
		-- Tell everyone in the chat the turret's position
		outputChatBox ( "Turret position: " .. x .. ", " .. y .. "." )	
	end
end

See Also