SetVehicleDoorOpenRatio: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 10: Line 10:
==Required Arguments==
==Required Arguments==
*'''theVehicle:''' The [[vehicle]] that you wish to change the door open ratio of.
*'''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.
*'''door:''' A whole number, 0 (hood), 1 (trunk), 2 (front left), 3 (front right), 4 (rear left), 5 (rear right)
*'''ratio:''' The ratio value, ranging from 0 (fully closed) to 1 (fully open).
*'''ratio:''' The ratio value, ranging from 0 (fully closed) to 1 (fully open).



Revision as of 21:15, 20 September 2011

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: A whole number, 0 (hood), 1 (trunk), 2 (front left), 3 (front right), 4 (rear left), 5 (rear right)
  • 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