setVehicleComponentRotation | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

setVehicleComponentRotation

Client-side
Server-side
Shared

Pair: getVehicleComponentRotation

Manual Review Required

Please finish this page using the corresponding Old Wiki article. Go to Contribution guidelines for more information.

This function sets the component rotation of a vehicle.

Note

Before r6974 the component rotations went the wrong way (i.e. opposite to the vehicle rotations). This has been corrected, so you'll have to modify any scripts written before r6974 that use this function.

OOP Syntax Help! I don't understand this!

  • Method:vehicle:setComponentRotation(...)

Syntax 

bool setVehicleComponentRotation ( vehicle theVehicle, string theComponent, float rotX, float rotY, float rotZ, [ string base = "parent" ] )
Required Arguments
  • theVehicle: The vehicle you wish to set component rotation of.
  • theComponent: A vehicle component (this is the frame name from the model file of the component you wish to modify)
  • rotX: The component's rotation around the x axis in degrees.
  • rotY: The component's rotation around the y axis in degrees.
  • rotZ: The component's rotation around the z axis in degrees.
Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use.

  • base (default: "parent"): A string representing what the supplied rotation ( rotX , rotY , rotZ ) is relative to. It can be one of the following values: parent: The rotation is relative to the parent component. root: The rotation is relative to the root component. world: The rotation is a world rotation, relative to the world's coordinates axes.

Returns

  • bool: value

Returns true if the component rotation was set successfully, false otherwise.

Code Examples

shared

Example 1:This example would change the roatation of the component when the player enters a vehicle.

addEventHandler("onClientVehicleEnter", getRootElement(),
    function()
        local theVeh = getPedOccupiedVehicle(localPlayer)
        local getComponent = getVehicleComponents(theVeh) -- returns table with all the components of the vehicle
        if (theVeh) then
      for k in pairs (getComponent) do
          local rx, ry, rz = getVehicleComponentRotation(theVeh, k) --get the rotation of the component
                setVehicleComponentRotation(theVeh, k, rx+10, ry+10, rz+10) -- increases by 10 unit
      end
        end
    end
)

See Also

Vehicle Functions
Vehicle Events
Reference