SetVehicleDoorOpenRatio: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 21: Line 21:


==Example==
==Example==
This example opens all the doors of the vehicle gradually over 2.5 seconds.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addCommandHandler ( "carshowoff", function ( playerSource )
addCommandHandler ( "carshowoff", function ( playerSource )

Revision as of 01:22, 18 January 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: 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