createWater

Cria uma superfície de água.

Sintaxe

water createWater ( number x1, number y1, number z1, number x2, number y2, number z2, number x3, number y3, number z3 [, number x4, number y4, number z4 ] [, bool raso = false ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
x1, y1, z1	number	—	Primeiro vértice.
x2, y2, z2	number	—	Segundo vértice.
x3, y3, z3	number	—	Terceiro vértice.
x4, y4, z4	number	—	Quarto vértice. Se você passar os três, a água vira um quadrilátero em vez de um triângulo.
raso	bool	false	Se a água é rasa.

Retorno

O elemento de água criado, ou false se não foi possível criá-lo.

O quarto vértice é opcional em bloco: ou você passa x4, y4 e z4, ou nenhum deles. O argumento raso vem sempre por último, seja com três ou com quatro vértices.

-- piscina retangular no nível 10
local piscina = createWater(
    0,   0,   10,
    50,  0,   10,
    0,   50,  10,
    50,  50,  10
)

-- triângulo raso
local poca = createWater(100, 100, 5, 120, 100, 5, 100, 120, 5, true)

Cuidado

O servidor não valida o formato da superfície: ele cria o elemento e envia aos jogadores. Se o formato não for desenhável, o elemento existe no servidor mas não aparece no jogo.

Os vértices também podem ficar fora do mapa original. O cliente aceita a superfície desde que o x e o y de cada vértice estejam dentro de ±12000 da origem — como no MTA o limite é ±3000 — e coloca o que passa dos limites originais num conjunto estendido, que desenha e consulta como qualquer outra água. O z não é limitado, e o servidor não confere as coordenadas: uma superfície que o cliente não aceita existe no servidor mas nunca aparece no jogo.

Para esconder o próprio oceano — um dique seco, por exemplo — veja a setOceanHole, somente no servidor.

Veja também

• getWaveHeight — Devolve a altura das ondas.
• setWaveHeight — Define a altura das ondas.
• getWaterVertexPosition — Devolve a posição de um vértice de uma água.
• setWaterVertexPosition — Move um vértice de uma água.
• setWaterLevel — Define o nível da água — de um elemento específico ou do mundo inteiro.
• resetWaterLevel — Devolve toda a água à altura original do mapa.
• getWaterColor — Devolve a cor da água.
• setWaterColor — Define a cor da água.