GetElementAttachedOffsets: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{Server client function}} This function returns the offsets of an element that has been attached to another element using attachElements. ==Syntax== <syntaxhighlight lang="lua">[lua,...")
 
(Fix oop syntax)
 
(6 intermediate revisions by 5 users not shown)
Line 7: Line 7:
float, float, float, float, float, float getElementAttachedOffsets ( element theElement )
float, float, float, float, float, float getElementAttachedOffsets ( element theElement )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[element]]:getAttachedOffsets||setElementAttachedOffsets}}


===Required Arguments===  
===Required Arguments===  
Line 15: Line 16:


==Example==  
==Example==  
<section name="Client" class="client" show="true">
'''Example:''' This example creates a car with a minigun
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- TODO
-- 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)
</syntaxhighlight>
</syntaxhighlight>
</section>
==See Also==
==See Also==
{{Element functions}}
{{Element functions}}

Latest revision as of 13:46, 6 August 2016

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

Syntax

float, float, float, float, float, float getElementAttachedOffsets ( element theElement )

OOP Syntax Help! I don't understand this!

Method: element:getAttachedOffsets(...)
Counterpart: setElementAttachedOffsets


Required Arguments

  • theElement: The attached element.

Returns

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.

Example

Click to collapse [-]
Client

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