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

getElementAttachedOffsets

Client-side
Server-side
Shared

Pair: setElementAttachedOffsets

Manual Review Required

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

This function returns the offsets of an element that has been attached to another element using attachElements.

OOP Syntax Help! I don't understand this!

  • Method:element:getAttachedOffsets(...)

Syntax 

float,​ float,​ float,​ float,​ float,​ float getElementAttachedOffsets ( element theElement )
Required Arguments
  • theElement: The attached element.

Returns

  • float: value1
  • float: value2
  • float: value3
  • float: value4
  • float: value5
  • float: value6

Returns 6 floats , of which the first 3 indicate the position offset (x, y, z), and the last 3 indicate the rotation offset (x, y, z), if successful. false otherwise.

Code Examples

shared

Example:This example creates a car with a minigun

-- Offsets
local x,y,z,rx,ry,rz= 0,-1.5,-0.1,0,0,-90


function createArmedBobcat(cmd)
    local lx, ly, lz = getElementPosition(localPlayer) -- get the position of the player
    lx = lx + 5 -- add 5 units to the x position


    veh = createVehicle( 422, lx, ly, lz) -- create a bobcat
    base = createObject( 2985, 2,2,2) -- create a minigun_base object
    setElementCollisionsEnabled ( base, false ) -- the minigun_base damages the car
    -- you could alternatively load an empty col file for the minigun object
    attachElements ( base, veh,  x,y,z,rx,ry,rz) -- attach the base to the bobcat
end


function rotateIt(cmd, addZ)
    if(addZ) then
        local x, y, z, rx, ry, rz = getElementAttachedOffsets (base) -- get the offsets
        rz = rz + addZ
        setElementAttachedOffsets (base, x, y, z, rx, ry, rz) -- update offsets
    end
end


addCommandHandler("bobcat", createArmedBobcat)
addCommandHandler("rotate", rotateIt)

See Also

Element Functions
Element Events
Reference