isElementOnScreen

Diz se o elemento está aparecendo na tela.

Sintaxe

bool isElementOnScreen ( element oElemento )

Retorno

true se o elemento está visível na tela neste momento, false caso contrário — inclusive quando ele não está carregado no mundo. Se o argumento não é um elemento válido, um aviso é registrado e a função devolve nil.

É a checagem certa antes de desenhar algo em cima de um elemento: sem ela você desenha marcações para coisas que estão atrás da câmera.

Exemplo

addEventHandler("onClientRender", root, function()
    for _, veiculo in ipairs(getElementsByType("vehicle")) do
        if isElementOnScreen(veiculo) then
            -- só aqui vale a pena calcular a posição na tela e desenhar
        end
    end
end)

Veja também

• getLocalPlayer — Devolve o jogador dono desta máquina.
• isElementLocal — Diz se o elemento existe apenas nesta máquina.
• isElementStreamedIn — Diz se o elemento está carregado no mundo neste momento.
• isElementStreamable — Diz se o elemento ainda participa do carregamento por distância.
• setElementStreamable — Fixa um elemento no mundo ou devolve ele ao carregamento normal.
• isElementWaitingForGroundToLoad — Diz se o elemento está esperando o chão terminar de carregar.
• getElementBoundingBox — Devolve os cantos da caixa que envolve o modelo do elemento.
• getElementRadius — Devolve o raio da esfera que envolve o modelo do elemento.