Dibuja un rectángulo

# imagerectangle

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

imagerectangle — Dibuja un rectángulo

### Descripción

function imagerectangle(
GdImage `$image`,
int `$x1`,
int `$y1`,
int `$x2`,
int `$y2`,
int `$color`
): true

imagerectangle() dibuja un rectángulo en las coordenadas especificadas. El punto 0, 0 es la esquina superior izquierda de la imagen.

### Parámetros

`image`
  Un objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().
`x1`

  X: coordenada de la esquina superior izquierda.

`y1`

  Y: coordenada de la esquina superior izquierda.

`x2`

  X: coordenada del punto inferior derecho.

`y2`

  Y: coordenada del punto inferior derecho.

`color`

  Un identificador de color creado con imagecolorallocate().

### Valores devueltos

Retorna siempre `true`.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `image` ahora espera una instancia de GdImage; anteriormente, se esperaba un resource `gd` válido.

### Ejemplos

Ejemplo #1 Ejemplo con imagerectangle()

    <?php
    // Creación de una imagen de 200 x 200 píxeles
    $canvas = imagecreatetruecolor(200, 200);

    // Asigna los colores
    $pink = imagecolorallocate($canvas, 255, 105, 180);
    $white = imagecolorallocate($canvas, 255, 255, 255);
    $green = imagecolorallocate($canvas, 132, 135, 28);

    // Dibuja 3 rectángulos, cada uno con su color
    imagerectangle($canvas, 50, 50, 150, 150, $pink);
    imagerectangle($canvas, 45, 60, 120, 100, $white);
    imagerectangle($canvas, 100, 120, 75, 160, $green);

    // Visualización
    header('Content-Type: image/jpeg');
    imagejpeg($canvas);
    ?>

Resultado del ejemplo anterior es similar a:

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open