SetVehicleDoorOpenRatio

From Multi Theft Auto: Wiki
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 number of milliseconds the door should take to reach the value you have specified. A value of 0 will change the door open ratio instantly.

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