Descrição

Assinatura a partir do PHP 8.0.0 (sem suporte a argumentos com nome)

imagefilledpolygon(GdImage $image, array $points, int $color): bool

Assinatura alternativa (descontinuada a partir do PHP 8.1.0)

imagefilledpolygon(
    GdImage $image,
    array $points,
    int $num_points,
    int $color
): bool

imagefilledpolygon() cria um polígono preenchido na imagem fornecida em image.

Parâmetros

image: Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
points: Um array contendo as coordenadas x e y dos vértices consecutivos do polígono.
num_points: Número total de pontos (vértices), que devem ser pelo menos 3.
Se este parâmetro for omitido na segunda assinatura, points deve ter um número par de elementos, e num_points será assumido como count($points)/2.
color: Um identificador de cor criado com imagecolorallocate().

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão	Descrição
8.1.0	O parâmetro `num_points` foi descontinuado.
8.0.0	O parâmetro `image` agora espera uma instância de GdImage; anteriormente, um resource `gd` válido era esperado.

Exemplos

Exemplo #1 Exemplo de imagefilledpolygon()

<?php
// configura o array de pontos para o polígono
$values = array(
            40,  50,  // Ponto 1 (x, y)
            20,  240, // Ponto 2 (x, y)
            60,  60,  // Ponto 3 (x, y)
            240, 20,  // Ponto 4 (x, y)
            50,  40,  // Ponto 5 (x, y)
            10,  10   // Ponto 6 (x, y)
            );

// cria imagem
$image = imagecreatetruecolor(250, 250);

// aloca cores
$bg   = imagecolorallocate($image, 0, 0, 0);
$blue = imagecolorallocate($image, 0, 0, 255);

// preenche o fundo
imagefilledrectangle($image, 0, 0, 249, 249, $bg);

// desenha um polígono
imagefilledpolygon($image, $values, $blue);

// descarrega a imagem
header('Content-type: image/png');
imagepng($image);
?>

O exemplo acima produzirá algo semelhante a:

Veja Também

imagepolygon() - Desenha um polígono