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

Version Beschreibung
8.0.0 image 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