imagefilledrectangle

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

imagefilledrectangle — Desenha um retângulo preenchido

Descrição

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

Cria um retângulo preenchido com a cor informada no parâmetro color na imagem fornecida em image, iniciando no ponto 1 e terminando no ponto 2. 0, 0 é o canto superior esquerdo da imagem.

Parâmetros

image: Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
x1: Coordenada x do ponto 1.
y1: Coordenada y do ponto 1.
x2: Coordenada x do ponto 2.
y2: Coordenada y do ponto 2.
color: A cor de preenchimento. 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

Exemplo #1 Uso de imagefilledrectangle()

<?php
// Cria uma imagem 55x30
$im = imagecreatetruecolor(55, 30);
$white = imagecolorallocate($im, 255, 255, 255);

// Desenha um retângulo branco
imagefilledrectangle($im, 4, 4, 50, 25, $white);

// Grava a imagem
imagepng($im, './imagefilledrectangle.png');
imagedestroy($im);
?>

O exemplo acima produzirá algo semelhante a: