GetVehicleComponentPosition
From Multi Theft Auto: Wiki
(Redirected from EngineGetFramePosition)
This function gets the component position of a vehicle.
Syntax
float, float, float getVehicleComponentPosition ( vehicle theVehicle, string theComponent [, string base = "root" ] )
OOP Syntax Help! I don't understand this!
- Method: vehicle:getComponentPosition(...)
 - Counterpart: setVehicleComponentPosition
 
Required Arguments
- theVehicle: The vehicle you wish to get component position of.
 - theComponent: A vehicle component (this is the frame name from the model file of the component you wish to modify)
 
Optional Arguments
- base: A string representing what the returned position is relative to. It can be one of the following values:
- parent: The position is relative to the parent component.
 - root: The position is relative to the root component.
 - world: The position is a world position.
 
 
Returns
Returns three floats indicating the position of the component, x, y and z respectively.
Example
Click to collapse [-]
This example gets the name and the position of the components and outputs it in the chat.addCommandHandler("vcp", -- short for 'vehicle component position'
    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 x, y, z = getVehicleComponentPosition(theVeh, k)
                outputChatBox("Position of "..k.." is"..x.." "..y.." "..z)
            end
        end
    end
)
Click to collapse [-]
This example shows every components name in 3D(Only for streamedin vehicles)local showComponents = false
bindKey("f5", "down", function() showComponents = not showComponents end)
addEventHandler("onClientRender", root,
    function()
        if (showComponents) then
            for _, veh in pairs(getElementsByType("vehicle", root, true)) do
                for compname in pairs(veh:getComponents()) do
                    local x, y = getScreenFromWorldPosition(veh:getComponentPosition(compname, "world"))
                    if (x) then
                        dxDrawText(compname, x, y, 0, 0, tocolor(255, 255, 255))
                    end
                end 
            end
        end
    end
)
Changelog
| Version | Description | 
|---|
| 1.4.0-9.07013 | Added base argument | 
See Also
FROM VERSION 1.5.7 r19626 ONWARDS
- attachTrailerToVehicle
 - blowVehicle
 - createVehicle
 - detachTrailerFromVehicle
 - fixVehicle
 - getHeliBladeCollisionsEnabled
 - getHelicopterRotorSpeed
 - getOriginalHandling
 - getTrainDirection
 - getTrainPosition
 - getTrainSpeed
 
FROM VERSION 1.6 r7485 ONWARDS
- getVehicleAdjustableProperty
 - getVehicleColor
 - getVehicleCompatibleUpgrades
 - getVehicleComponentPosition
 - getVehicleComponentRotation
 - getVehicleComponentScale
 - getVehicleComponentVisible
 - getVehicleComponents
 - getVehicleController
 - getVehicleCurrentGear
 - getVehicleDoorOpenRatio
 - getVehicleDoorState
 - getVehicleEngineState
 - getVehicleGravity
 - getVehicleHandling
 - getVehicleHeadLightColor
 - getVehicleLandingGearDown
 - getVehicleLightState
 - getVehicleMaxPassengers
 
- getVehicleModelDummyPosition
 - getVehicleModelExhaustFumesPosition
 - getVehicleModelFromName
 - getVehicleName
 - getVehicleNameFromModel
 - getVehicleNitroCount
 - getVehicleNitroLevel
 - getVehicleOccupant
 - getVehicleOccupants
 - getVehicleOverrideLights
 - getVehiclePaintjob
 - getVehiclePanelState
 - getVehiclePlateText
 - getVehicleSirens
 - getVehicleSirensOn
 - getVehicleSirenParams
 - getVehicleTowedByVehicle
 - getVehicleTowingVehicle
 
- getVehicleTurretPosition
 - getVehicleType
 - getVehicleUpgradeOnSlot
 - getVehicleUpgradeSlotName
 - getVehicleUpgrades
 - getVehicleVariant
 - getVehicleWheelStates
 - isTrainChainEngine
 - isTrainDerailable
 - isTrainDerailed
 - isVehicleBlown
 - isVehicleDamageProof
 - isVehicleFuelTankExplodable
 - isVehicleLocked
 - isVehicleNitroActivated
 - isVehicleNitroRecharging
 - isVehicleOnGround
 - isVehicleTaxiLightOn
 
- isVehicleWheelOnGround
 - isVehicleWindowOpen
 - removeVehicleUpgrade
 - resetVehicleComponentPosition
 - resetVehicleComponentRotation
 - resetVehicleComponentScale
 - setHeliBladeCollisionsEnabled
 - setHelicopterRotorSpeed
 - setTrainDerailable
 - setTrainDerailed
 - setTrainDirection
 - setTrainPosition
 - setTrainSpeed
 
FROM VERSION 1.6 r7485 ONWARDS
- setVehicleAdjustableProperty
 - setVehicleColor
 - setVehicleComponentPosition
 - setVehicleComponentRotation
 - setVehicleComponentScale
 - setVehicleComponentVisible
 - setVehicleDamageProof
 - setVehicleDirtLevel
 - setVehicleDoorOpenRatio
 - setVehicleDoorState
 - setVehicleDoorsUndamageable
 - setVehicleEngineState
 - setVehicleFuelTankExplodable
 - setVehicleGravity
 
- setVehicleHandling
 - setVehicleHeadLightColor
 - setVehicleLandingGearDown
 - setVehicleLightState
 - setVehicleLocked
 
- setVehicleModelDummyPosition
 - setVehicleModelExhaustFumesPosition
 - setVehicleNitroActivated
 - setVehicleNitroCount
 - setVehicleNitroLevel
 - setVehicleOverrideLights
 - setVehiclePaintjob
 - setVehiclePanelState
 - setVehiclePlateText
 - setVehicleSirens
 - setVehicleSirensOn
 - setVehicleTaxiLightOn