IsElementCollidableWith: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Added example)
(Added OOP syntax introduced in r6987)
Line 11: Line 11:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool isElementCollidableWith ( element theElement, element withElement )  
bool isElementCollidableWith ( element theElement, element withElement )  
</syntaxhighlight>  
</syntaxhighlight>
{{New feature/item|3.0141|1.4.0|6987|{{OOP||[[element]]:isCollidableWith||setElementCollidableWith}}}}


===Required Arguments===  
===Required Arguments===  

Revision as of 14:11, 31 December 2014

This function can be used to check whether specified element is collidable with another element.
Note: You can only use this function with the element types listed below.

Syntax

bool isElementCollidableWith ( element theElement, element withElement ) 

OOP Syntax Help! I don't understand this!

Method: element:isCollidableWith(...)
Counterpart: setElementCollidableWith

Required Arguments

  • theElement: The element which colliding you want to get
  • withElement: The other element which colliding with the first entity you want to get

Returns

Returns true if the elements collide with eachother, false otherwise.

Example

This example adds the command togglecol which toggles the collision between the player and ped.

Click to collapse [-]
Client
local tPed = {}
addEventHandler( "onClientPlayerSpawn", localPlayer,
    function()
        local x, y, z = getElementPosition(source)
        if isElement(tPed["thePed"]) then
            destroyElement(tPed["thePed"])
        end
        -- Creates a random ped near player
        tPed["thePed"] = createPed(math.random(209, 238), x+1, y+1, z)
    end
)

function toggleColisionFunc()
    if not isElement(tPed["thePed"]) then
        return
    end
    -- Is the local player collidable with the ped?
    local isCollidable = isElementCollidableWith( localPlayer, tPed["thePed"] )
    -- Toggles the colision with the ped.
    setElementCollidableWith( localPlayer, tPed["thePed"], not isCollidable )
end
-- Adds a command handler to enable/disable colisions with the ped
addCommandHandler("togglecol", toggleColisionFunc)

See Also