imagerectangle

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

imagerectangleDesenha um retângulo

Descrição

imagerectangle(
    GdImage$image,
    int$x1,
    int$y1,
    int$x2,
    int$y2,
    int$color
): bool

imagerectangle() cria um retângulo nas coordenadas especificadas.

Parâmetros

image

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

x1

Coordenada x do canto superior esquerdo.

y1

Coordenada y do canto superior esquerdo. 0, 0 é o canto superior esquerdo da imagem.

x2

Coordenada x do canto inferior direito.

y2

Coordenada y do canto inferior direito.

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ãoDescrição
8.0.0 O parâmetro image agora espera uma instância de GdImage; anteriormente, um resourcegd válido era esperado.

Exemplos

Exemplo #1 Exemplo simples de imagerectangle()

<?php
// Cria uma imagem 200 x 200
$canvas = imagecreatetruecolor(200, 200);

// Aloca cores
$pink = imagecolorallocate($canvas, 255, 105, 180);
$white = imagecolorallocate($canvas, 255, 255, 255);
$green = imagecolorallocate($canvas, 132, 135, 28);

// Desenha três retângulos cada um com sua própria cor
imagerectangle($canvas, 50, 50, 150, 150, $pink);
imagerectangle($canvas, 45, 60, 120, 100, $white);
imagerectangle($canvas, 100, 120, 75, 160, $green);

// Mostra e libera da memória
header('Content-Type: image/jpeg');

imagejpeg($canvas);
imagedestroy($canvas);
?>

O exemplo acima produzirá algo semelhante a:

Saída do exemplo: Exemplo simples de imagerectangle()
To Top