(PHP 4, PHP 5, PHP 7)
imagecolorallocate — Alloziert eine Farbe für eine Grafik
$image
, int $red
, int $green
, int $blue
) : intLiefert einen Farb-Kennzeichner zurück, der die Farbe, die aus den gegebenen RGB-Komponenten besteht, darstellt.
imagecolorallocate() muss aufgerufen werden, um jede Farbe
zu erzeugen, die in dem Bild, das durch image
angegeben wird, verwendet werden soll.
Hinweis:
Der erste Aufruf von imagecolorallocate() bestimmt die Hintergrundfarbe von palettenbasierten Bilder – also Bildern, die durch imagecreate() erzeugt wurden.
image
Eine von den verschiedenen Erzeugungsfunktionen wie imagecreatetruecolor() gelieferte Grafikressource.
redWert der Rotkomponente.
greenWert der Grünkomponente.
blueWert der Blaukomponente.
Ein Farb-Kennzeichner oder FALSE falls die Farbe nicht alloziert werden
konnte.
Diese Funktion kann sowohl das
boolsche FALSE zurückliefern, als auch einen nicht-boolschen Wert, welcher zu FALSE ausgewertet wird.
Weitere Informationen entnehmen Sie bitte dem Abschnitt über die
boolschen Typen. Benutzen Sie deshalb
den === Operator,
um den Rückgabewert dieser Funktion zu überprüfen.
| Version | Beschreibung |
|---|---|
| 5.1.3 |
Liefert FALSE zurück, wenn die Farbe nicht alloziert werden konnte.
Zuvor wurde -1 zurückgeliefert.
|
Beispiel #1 imagecolorallocate() Beispiel
<?php
$im = imagecreate(100, 100);
// färbt den Hintergrund rot
$background = imagecolorallocate($im, 255, 0, 0);
// alloziert weitere Farben
$white = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);
// hexadezimale Schreibweise
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
$black = imagecolorallocate($im, 0x00, 0x00, 0x00);
?>