Dgs3DImageDetachFromElement

From Multi Theft Auto: Wiki
Revision as of 22:11, 11 August 2022 by TFv10 (talk | contribs)
Jump to navigation Jump to search

This function detaches attached 3DImageElement from another element.

Syntax

bool dgs3DImageDetachFromElement ( element the3DImageElement, [ element theAttachToElement ] )

OOP Syntax Help! I don't understand this!

Method: element:3DImageDetachFromElement(...)
Counterpart: 3DImageAttachToElement


Required Arguments

  • the3DImageElement: The element to be detached (the "child")

Optional Arguments

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

  • theAttachToElement: The element you wish to detach from, will detach from the attached element if this isn't specified.

Returns

Returns true if the detaching was successful, false otherwise.

Example

Example 1: This example attaches a marker to a vehicle, and detaches it when it blows up:

if isVoiceEnabled() then
    local dgs = exports.dgs 
    local micPNG = dxCreateTexture('assests/mic.png');
    local icons = {};
    addEventHandler('onClientPlayerVoiceStart',root,
        function()
            print('[Voice-System]: '..getPlayerName(source)..' started talking.')
            local x,y,z = getElementPosition(source);
            if ((source ~= localPlayer and isElementOnScreen(source)) or (localPlayer == source)) and not isElement(icons[source]) then
                icons[source] = dgs:dgsCreate3DImage(x,y,z+1.5,micPNG,tocolor(255,255,255,255),4,4,20);
                dgs:dgs3DImageAttachToElement( icons[source],localPlayer,0,0,1.5)
            end 
        end
    )
    addEventHandler('onClientPlayerVoiceStop',root,
        function() 
            print('[Voice-System]: '..getPlayerName(source)..' Stoped talking.')
            if isElement(icons[source]) then
                dgs:dgs3DImageDettachFromElement( icons[source],localPlayer);
                destroyElement(icons[source]);
                icons[source] = nil;
            end
        end
    )
end

See Also