# imagerectangle

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

imagerectangle — Zeichnet ein Rechteck

### Beschreibung

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

imagerectangle() erzeugt ein Rechteck mit den angegebenen Koordinaten.

### Parameter-Liste

`image`

  Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.

`x1`

  Obere linke x-Koordinate.

`y1`

  Obere linke y-Koordinate. 0,0 ist die obere linke Ecke des Bildes.

`x2`

  Untere rechte x-Koordinate.

`y2`

  Untere rechte y-Koordinate.

`color`

  Eine Farbkennung, die mit imagecolorallocate() erzeugt wurde.

### Rückgabewerte

Gibt bei Erfolg `true` zurück. Bei einem Fehler wird `false` zurückgegeben.

### Changelog

Version | Beschreibung
--- | ---
8.0.0 | `image` erwartet nun eine GdImage-Instanz; vorher wurde eine gültige `gd`-Ressource erwartet.

### Beispiele

Beispiel #1 Einfaches imagerectangle()-Beispiel

`<?php
// Erzeuge ein 200x200-Bild
$canvas = imagecreatetruecolor(200, 200);
// Alloziere Farben
$pink = imagecolorallocate($canvas, 255, 105, 180);
$white = imagecolorallocate($canvas, 255, 255, 255);
$green = imagecolorallocate($canvas, 132, 135, 28);
// Zeichne drei Rechtecke mit unterschiedlicher Farbe
imagerectangle($canvas, 50, 50, 150, 150, $pink);
imagerectangle($canvas, 45, 60, 120, 100, $white);
imagerectangle($canvas, 100, 120, 75, 160, $green);
// Ausgabe
header('Content-Type: image/jpeg');
imagejpeg($canvas);
?>`

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

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