imageopenpolygon

(PHP 7 >= 7.2.0, PHP 8)

imageopenpolygon — Desenha um polígono aberto

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 (defasada 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
),
3,
$col_poly);

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

imagepng($image);
imagedestroy($image);
?>

O exemplo acima produzirá algo semelhante a:

Veja Também

imagepolygon() - Desenha um polígono