imagefilledpolygon

(PHP 4, PHP 5, PHP 7, PHP 8)

imagefilledpolygon — Desenha um polígono preenchido

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, 6, $blue);

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

O exemplo acima produzirá algo semelhante a:

Veja Também

imagepolygon() - Desenha um polígono