SetElementAttachedOffsets

From Multi Theft Auto: Wiki

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

Syntax

bool setElementAttachedOffsets ( element theElement, [ float xPosOffset, float yPosOffset, float zPosOffset, float xRotOffset, float yRotOffset, float zRotOffset ])

Required Arguments

• theElement: The attached element.

Optional Arguments

NOTE: When using optional arguments, you must supply all arguments before the one you wish to use. For more information on optional arguments, see Optional Arguments.

• xPosOffset: The x offset, if you want the elements to be a certain distance from one another (default 0).
• yPosOffset: The y offset (default 0).
• zPosOffset: The z offset (default 0).
• xRotOffset: The x rotation offset (default 0).
• yRotOffset: The y rotation offset (default 0).
• zRotOffset: The z rotation offset (default 0).

Returns

Returns true if the attaching process was successful, false otherwise.

Example

-- Offsets
local x,y,z,rx,ry,rz= 0,-1.5,-0.1,0,0,-90
 
function createArmedBobcat(cmd)
    local lx,ly,lz = getElementPosition(getLocalPlayer()) -- 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
        rz=rz+addZ
        setElementAttachedOffsets (base,x,y,z,rx,ry,rz) --update offsets
    end
end
 
addCommandHandler("bobcat", createArmedBobcat)
addCommandHandler("rotate", rotateIt)

See Also

• clearElementVisibleTo
• cloneElement
• createElement
• destroyElement
• getAllElementData
• getAttachedElements
• getElementAlpha

• getElementAttachedOffsets
• getElementCollisionsEnabled
• getElementAttachedTo
• getElementByID
• getElementByIndex
• getElementChild
• getElementChildren
• getElementChildrenCount
• getElementColShape
• getElementData
• getElementDimension
• getElementHealth
• getElementID
• getElementInterior
• getElementParent
• getElementPosition

• getElementRotation
• getElementsByType
• getElementsWithinColShape
• getElementType
• getElementVelocity
• getElementZoneName
• getRootElement
• isElement
• isElementAttached

• isElementDoubleSided

• isElementFrozen
• isElementVisibleTo
• isElementWithinColShape
• removeElementData
• setElementAlpha

• setElementCollisionsEnabled
• setElementData

• setElementDoubleSided
• setElementDimension

• setElementFrozen
• setElementHealth
• setElementID
• setElementInterior
• setElementParent
• setElementPosition

• setElementSyncer
• setElementRotation
• setElementVelocity
• setElementVisibleTo

• attachElements
• detachElements
• getElementModel
• getElementSyncer
• isElementInWater
• setElementAttachedOffsets
• setElementModel

• setLowLODElement
• getLowLODElement
• isElementLowLOD