imagefilledrectangle

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

imagefilledrectangle — Zeichnet ein gefülltes Rechteck

Beschreibung

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

Erzeugt ein mit der Farbe color gefülltes Rechteck im angegebenen image, das sich von Punkt 1 bis zu Punkt 2 erstreckt. 0,0 ist die obere linke Ecke des Bildes.

Parameter-Liste

image: Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
x1: x-Koordinate von Punkt 1.
y1: y-Koordinate von Punkt 1.
x2: x-Koordinate von Punkt 2.
y2: y-Koordinate von Punkt 2.
color: Die Füllfarbe. 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 Beispiel für die Verwendung von imagefilledrectangle()

<?php
// Erzeuge ein 55x30-Bild
$im = imagecreatetruecolor(55, 30);
$white = imagecolorallocate($im, 255, 255, 255);

// Zeichne ein weißes Rechteck
imagefilledrectangle($im, 4, 4, 50, 25, $white);

// Speichere das Bild
imagepng($im, './imagefilledrectangle.png');
imagedestroy($im);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie: