getRoofPosition

Devolve a altura do teto logo acima de um ponto.

Sintaxe

number getRoofPosition ( number x, number y, number z )

Retorno

O Z do teto encontrado, ou false quando não há nada acima do ponto. Diferente de getGroundPosition, aqui dá para distinguir os dois casos.

Argumentos que não sejam números geram um erro de Lua.

Exemplo

local teto = getRoofPosition(x, y, z)
if teto then
    outputDebugString("altura livre: " .. (teto - z))
end

Veja também

• processLineOfSight — Traça uma linha entre dois pontos e descreve o primeiro obstáculo encontrado.
• isLineOfSightClear — Responde apenas se existe caminho livre entre dois pontos, sem descrever o obstáculo.
• processLineAgainstMesh — Traça uma linha contra a malha de um elemento específico e devolve o ponto exato do triângulo atingido.
• testSphereAgainstWorld — Testa uma esfera contra o mundo e descreve o que ela encostou.
• getGroundPosition — Devolve a altura do chão logo abaixo de um ponto.