GetVehicleTurretPosition

From Multi Theft Auto: Wiki
Revision as of 13:04, 23 August 2007 by Jbeta (talk | contribs) (Removed reference to variants, removed Using Radians template)
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)
Dialog-information.png This article needs checking.

Reason(s): "Returns" section info is wrong, this function doesn't retrieve rotation. The example could be improved.

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 )

Required Arguments

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

Returns

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

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