imagecolorset

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

    imagecolorset — Setzt die Farbe für den angegebenen Paletten-Index

    Beschreibung

    imagecolorset(
        GdImage$image,
        int$color,
        int$red,
        int$green,
        int$blue,
        int$alpha = 0
    ): ?false

    Hierdurch wird der Farbwert der Palette auf die angegebene Farbe gesetzt. Dies ist nützlich bei Aktionen wie "Fülle Farbe X mit Farbe Y" (Flood-Fill-Effekt), ohne den sonst notwendigen Aufwand für solche Aktionen betreiben zu müssen.

    Parameter-Liste

    image

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

    color

    Ein Index der Palette.

    red

    Wert der Rotkomponente.

    green

    Wert der Grünkomponente.

    blue

    Wert der Blaukomponente.

    alpha

    Wert der Alpha-Komponente.

    Rückgabewerte

    Die Funktion gibt bei Erfolg null zurück. Bei einem Fehler wird false zurückgegeben.

    Changelog

    VersionBeschreibung
    8.0.0image erwartet nun eine GdImage-Instanz; vorher wurde eine gültige gd-Ressource erwartet.

    Beispiele

    Beispiel #1 imagecolorset()-Beispiel

    <?php
    // Erzeuge ein 300x100 Bild
    $im = imagecreate(300, 100);

    // Setze den Hintergrund auf Rot
    imagecolorallocate($im, 255, 0, 0);

    // Ermittle den Farbindex des Hintergrunds
    $bg = imagecolorat($im, 0, 0);

    // Setze den Hintergrund auf Blau
    imagecolorset($im, $bg, 0, 0, 255);

    // Gib das Bild an den Browser aus
    header('Content-Type: image/png');

    imagepng($im);
    imagedestroy($im);
    ?>

    Siehe auch

    To Top