SetVehicleWheelScale

From Multi Theft Auto: Wiki
Revision as of 23:42, 3 September 2020 by AlexTMjugador (talk | contribs) (Document function introduced in r20642)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This function sets the scale of all the wheels of a vehicle. The wheel scale multiplies the visible height and length (but not width) of all the wheels in a vehicle, without affecting their collisions or the handling, similarly to setVehicleComponentScale. The wheel scale is applied after the model wheel size.

[[{{{image}}}|link=|]] Note: Installing or removing a wheel upgrade in a vehicle resets the wheel scale to the default value.
[[{{{image}}}|link=|]] Tip: The default value for vehicles without wheel upgrades is 1, which renders the wheels in the model as usual. On the other hand, the default value for vehicles with a wheel upgrade depends on the wheel size of the model.

Syntax

bool setVehicleWheelScale ( vehicle theVehicle, float wheelScale )

OOP Syntax Help! I don't understand this!

Method: vehicle:setWheelScale(...)
Variable: .wheelScale
Counterpart: [[getVehicleWheelScale]]


Required Arguments

  • theVehicle: The vehicle whose wheel scale you wish to modify.
  • wheelScale: The wheel scale value to set.

Returns

Returns true if the wheel scale has been set successfully, or an error if some parameter is invalid.

Example

Preview of the results of invoking the shrinkwheels command

This example adds a shrinkwheels command that reduces the wheel scale of a vehicle in half each time it is invoked.

addCommandHandler("shrinkwheels", function()
    local veh = getPedOccupiedVehicle(localPlayer)
    if veh then
        local newScale = getVehicleWheelScale(veh) * 0.5
        setVehicleWheelScale(veh, newScale)
        outputChatBox("Vehicle wheel scale set to " .. newScale .. ".", 0, 255, 0)
    else
        outputChatBox("You must be in a vehicle to use this command.", 255, 0, 0)
    end
end)

See Also