Descrição

Assinatura a partir do PHP 8.0.0 (não suportada com argumentos nomeados)

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

Assinatura alternativa (descontinuada a partir do PHP 8.1.0)

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

imageopenpolygon() desenha um polígono aberto na imagem informada em image. A contrário de imagepolygon(), nenhuma linha é desenhada entre o último ponto e o primeiro ponto.

Parâmetros

image

Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().

points

Um array contendo os vértices do polígono, por exemplo:

points[0] = x0

points[1] = y0

points[2] = x1

points[3] = y1

num_points

Número total de pontos (vértices), que devem ser pelo menos 3.

Se este parâmetro for omitido conforme a segunda assinatura, points precisa ter um número par de elementos, e será assumido que num_points será igual a 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 imageopenpolygon()

<?php
// Cria uma imagem vazia
$image = imagecreatetruecolor(400, 300);

// Aloca uma cor para o polígono
$col_poly = imagecolorallocate($image, 255, 255, 255);

// Desenha o polígono
imageopenpolygon($image, array(
        0,   0,
        100, 200,
        300, 200
    ),
    $col_poly);

// Mostra a imagem no navegador
header('Content-type: image/png');

imagepng($image);
?>

O exemplo acima produzirá algo semelhante a:

Veja Também

imagepolygon() - Desenha um polígono