SetVehicleWheelsRotation: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (Replaced vehicleElement with theVehicle as seen on all other vehicle related functions)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Client function}}
{{Client function}}
Allows the scripter to manipulate wheel rotation for vehicles. This function supports Automobiles, Bikes (Including BMX), and Trailers.
This function is used to manipulate the wheel rotation of a vehicle. Cars, Bikes (including BMX) and Trailers are supported.


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool setVehicleWheelsRotation ( vehicle vehicleElement, float rotation )
bool setVehicleWheelsRotation ( vehicle theVehicle, float rotation )
</syntaxhighlight>
</syntaxhighlight>


===Required Arguments===
===Required Arguments===
* '''vehicleElement:''' the vehicle (Automobile, Bike, or Trailer) whose wheel rotation is to be set.
* '''theVehicle:''' the vehicle whose wheel rotation is to be set.
* '''rotation:''' the new wheel rotation value.
* '''rotation:''' the new wheel rotation value.


Line 20: Line 20:
<section name="Client" class="client" show="true">
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addEventHandler("onClientVehicleEnter", getRootElement(),
addEventHandler("onClientVehicleEnter", root,
     function()
     function()
         local theVeh = getPedOccupiedVehicle(localPlayer)
         local theVeh = getPedOccupiedVehicle(localPlayer)

Revision as of 08:38, 30 June 2024

This function is used to manipulate the wheel rotation of a vehicle. Cars, Bikes (including BMX) and Trailers are supported.

Syntax

bool setVehicleWheelsRotation ( vehicle theVehicle, float rotation )

Required Arguments

  • theVehicle: the vehicle whose wheel rotation is to be set.
  • rotation: the new wheel rotation value.

Returns

Returns true if successful, false otherwise.

Example

This example sets the wheel rotation of the vehicle when the player gets into any vehicle and if there is any attached trailer.

Click to collapse [-]
Client
addEventHandler("onClientVehicleEnter", root,
    function()
        local theVeh = getPedOccupiedVehicle(localPlayer)
        if setVehicleWheelsRotation(theVeh, 0) then 
            outputChatBox("SET OK")
        else
            outputChatBox("SET FAILED")
        end
    end
)

addEventHandler("onClientPreRender", root, function()
    local theVeh = getPedOccupiedVehicle(localPlayer)
    if theVeh then
        setVehicleWheelsRotation(theVeh, 0)
        -- also do it for trailer
        local trailer = getVehicleTowedByVehicle(theVeh)
        if trailer then
            setVehicleWheelsRotation(trailer, 0)
        end
    end
end)

See Also