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
): true

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 immer true zurück.

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:

Ausgabe des Beispiels: Einfaches imagerectangle()-Beispiel