IsElementSyncer: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(11 intermediate revisions by 6 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Client function}}
{{Client function}}
This function checks whether an [[element]] is a syncer or not. Accepted elements are [[ped]]'s and [[vehicle]]'s.
This function checks whether an [[element]] is synced by the local player or not. Accepted elements are [[ped|peds]] and [[vehicle|vehicles]].


==Syntax==
==Syntax==
Line 7: Line 7:
bool isElementSyncer ( element theElement )
bool isElementSyncer ( element theElement )
</syntaxhighlight>
</syntaxhighlight>
{{New feature/item|3.0141|1.4.0|6993|{{OOP||[[element]]:isSyncer|syncedByLocalPlayer}}}}


===Required Arguments===
===Required Arguments===
* '''theElement''': The [[element]] to check.
* '''theElement''': The [[element]] to check.


===Returns===
===Returns===
Returns ''true'' if the passed element is syncer, ''false'' otherwise.
Returns ''true'' if the passed element is synced by the local player, ''false'' otherwise.


==Example==
==Example==
<section name="Clientside example" class="client" show="true">
<section name="Client" class="client" show="true">
This example draws a string above peds synced by local player in 50m proximity
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- TODO
function renderSyncedElements ()
    -- Retrieve ped elements streamed in
    for k,el in ipairs (getElementsByType('ped', root, true)) do
        repeat
            if (not isElementSyncer(el)) then
                -- Skip if local player isn't syncer
                break
            end
           
            local pedX, pedY, pedZ = getElementPosition (el)
            local sX, sY, sD = getScreenFromWorldPosition (pedX, pedY, pedZ + 1.2)
            if (not sX) or (sD > 50) then
                -- Not on screen or too far away
                break
            end
           
            dxDrawText ('Syncer', sX, sY, 0, 0, tocolor(255,255,255,255), 20 / sD, 'arial')
        until true
    end
end
addEventHandler ('onClientRender', root, renderSyncedElements)
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>


==See Also==
==See Also==
{{Client element functions}}
{{Client element functions}}
[[Category:Needs Example]]

Latest revision as of 02:22, 1 January 2015

This function checks whether an element is synced by the local player or not. Accepted elements are peds and vehicles.

Syntax

bool isElementSyncer ( element theElement )

OOP Syntax Help! I don't understand this!

Method: element:isSyncer(...)
Variable: .syncedByLocalPlayer

Required Arguments

Returns

Returns true if the passed element is synced by the local player, false otherwise.

Example

Click to collapse [-]
Client

This example draws a string above peds synced by local player in 50m proximity

function renderSyncedElements ()
    -- Retrieve ped elements streamed in
    for k,el in ipairs (getElementsByType('ped', root, true)) do
        repeat
            if (not isElementSyncer(el)) then
                -- Skip if local player isn't syncer
                break
            end
            
            local pedX, pedY, pedZ = getElementPosition (el)
            local sX, sY, sD = getScreenFromWorldPosition (pedX, pedY, pedZ + 1.2)
            if (not sX) or (sD > 50) then
                -- Not on screen or too far away
                break
            end
            
            dxDrawText ('Syncer', sX, sY, 0, 0, tocolor(255,255,255,255), 20 / sD, 'arial')
        until true
    end
end
addEventHandler ('onClientRender', root, renderSyncedElements)

See Also