SetVehicleDoorOpenRatio

From Multi Theft Auto: Wiki
Revision as of 01:22, 18 January 2011 by EAi (talk | contribs) (→‎Example)
Jump to navigation Jump to search

This function sets how much a vehicle's door is open. Doors include the boot/trunk and the bonnet of the vehicle.

Syntax

bool setVehicleDoorOpenRatio ( vehicle theVehicle, int door, float ratio [, int time ] )

Required Arguments

  • theVehicle: The vehicle that you wish to change the door open ratio of.
  • door: An integer between 0 and 5 specifying the door you want to change open ratio of.
  • ratio: The ratio value, ranging from 0 (fully closed) to 1 (fully open).

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • time: The time that the change will take. A value of 0 will change the door open ratio inmediately.

Returns

Returns true if the door open ratio was successfully set, false if invalid arguments are passed.

Example

This example opens all the doors of the vehicle gradually over 2.5 seconds.

addCommandHandler ( "carshowoff", function ( playerSource )
	local vehicle = getPedOccupiedVehicle ( playerSource )
	if vehicle then
		for i=0,5 do
			setVehicleDoorOpenRatio ( vehicle, i, 1 - getVehicleDoorOpenRatio ( vehicle, i ), 2500 )
		end
	end
end )

See Also