imagecolorset
(PHP 4, PHP 5, PHP 7, PHP 8)
imagecolorset — Setzt die Farbe für den angegebenen Paletten-Index
Beschreibung
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
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
- imagecolorat() - Liefert den Farbwert eines Bildpunktes
