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

Exemplos

Example #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()