createColPolygon

Cria uma área com o formato que você quiser, descrita por uma lista de vértices.

Sintaxe

colshape createColPolygon ( number centroX, number centroY, number x1, number y1, number x2, number y2, number x3, number y3, ... )

Parâmetros

Nome	Tipo	Padrão	Descrição
centroX	number	—	X do centro da área.
centroY	number	—	Y do centro da área.
x1, y1, …	number	—	Os vértices, em pares X e Y, na ordem em que formam o contorno.

Retorno

A colshape criada, ou false se faltar um argumento ou ele não for um número (um aviso é escrito no console de debug) ou se a criação falhar.

O primeiro par de números é o centro da área e não entra na lista de vértices. Depois dele são necessários pelo menos 3 vértices, ou seja, 6 números; qualquer par também pode ser passado como um Vector2. Se um desses 3 primeiros vértices faltar ou não for um número, a função escreve um aviso e devolve false. Depois do terceiro vértice, os pontos continuam sendo lidos enquanto os dois próximos valores forem números (ou strings — uma não numérica faz a chamada falhar do mesmo jeito); a lista simplesmente termina no primeiro valor que não começa um par completo, então um número ímpar sobrando no final é ignorado em vez de recusado.

Exemplo

-- triângulo, com o centro aproximado da área na frente
local territorio = createColPolygon(
    100.0, 100.0,       -- centro
    50.0,  50.0,        -- vértice 1
    150.0, 50.0,        -- vértice 2
    100.0, 150.0        -- vértice 3
)

Veja também

• createColCircle — Cria um círculo no plano do mapa, sem limite de altura.
• createColCuboid — Cria uma caixa alinhada aos eixos.
• createColSphere — Cria uma esfera.
• createColRectangle — Cria um retângulo no plano do mapa, sem limite de altura.
• createColTube — Cria um cilindro em pé, com a base na posição informada.
• getColShapeType — Descobre qual é o formato de uma colshape.
• isInsideColShape — Verifica se uma posição está dentro da forma.
• getColShapeRadius — Lê o raio de um círculo, esfera ou tubo.