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

    VersionBeschreibung
    8.1.0 Der Parameter num_points ist veraltet und sollte nicht mehr verwendet werden.
    8.0.0image erwartet nun eine GdImage-Instanz; vorher wurde eine gültige gd-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);
    ?>

    Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    Ausgabe des Beispiels : imagefilledpolygon()

    Siehe auch

    To Top