imagefilledpolygon

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

imagefilledpolygon — Zeichnet ein gefülltes Polygon

Beschreibung

Signatur seit PHP 8.0.0 (keine Unterstützung für benannte Argumente)

imagefilledpolygon(GdImage $image, array $points, int $color): bool

Alternative Signatur (seit PHP 8.1.0 veraltet)

imagefilledpolygon(
    GdImage $image,
    array $points,
    int $num_points,
    int $color
): bool

imagefilledpolygon() erzeugt ein gefülltes Polygon im Bild, das durch image angegeben wurde.

Parameter-Liste

image: Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
points: Ein Array, das die x- und y-Koordinaten der aufeinanderfolgenden Polygon-Eckpunkte enthält.
num_points: Die Anzahl der Eckpunkte, die mindestens 3 sein muss.
Wenn dieser Parameter gemäß der zweiten Signatur weggelassen wird, muss points eine gerade Anzahl von Elementen haben, und num_points wird angenommen als count($punkte)/2.
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.1.0	Der Parameter `num_points` ist veraltet und sollte nicht mehr verwendet werden.
8.0.0	`image` erwartet nun eine GdImage-Instanz; vorher wurde eine Ressource erwartet.

Beispiele

Beispiel #1 imagefilledpolygon()-Beispiel


<?php
// Initialisiere das Array der Polygon-Punkte
$values = array(
            40,  50,  // Punkt 1 (x, y)
            20,  240, // Punkt 2 (x, y)
            60,  60,  // Punkt 3 (x, y)
            240, 20,  // Punkt 4 (x, y)
            50,  40,  // Punkt 5 (x, y)
            10,  10   // Punkt 6 (x, y)
            );

// Erzeuge das Bild
$image = imagecreatetruecolor(250, 250);

// Weise Farben zu
$bg   = imagecolorallocate($image, 0, 0, 0);
$blue = imagecolorallocate($image, 0, 0, 255);

// Fülle den Hintergrund
imagefilledrectangle($image, 0, 0, 249, 249, $bg);

// Zeichne ein Polygon
imagefilledpolygon($image, $values, 6, $blue);

// Gib das Bild aus
header('Content-type: image/png');
imagepng($image);
imagedestroy($image);
?>