imagecolorallocate

(PHP 4, PHP 5, PHP 7)

imagecolorallocateAlloziert eine Farbe für eine Grafik

Beschreibung

imagecolorallocate ( resource $image , int $red , int $green , int $blue ) : int

Liefert 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.

Parameter-Liste

image

Eine von den verschiedenen Erzeugungsfunktionen wie imagecreatetruecolor() gelieferte Grafikressource.

red

Wert der Rotkomponente.

green

Wert der Grünkomponente.

blue

Wert der Blaukomponente.

Diese Parameter sind Ganzzahlen zwischen 0 und 255 oder Hexadezimalzahlen zwischen 0x00 und 0xFF.

Rückgabewerte

Ein Farb-Kennzeichner oder FALSE falls die Farbe nicht alloziert werden konnte.

Warnung

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.

Changelog

Version Beschreibung
5.1.3 Liefert FALSE zurück, wenn die Farbe nicht alloziert werden konnte. Zuvor wurde -1 zurückgeliefert.

Beispiele

Beispiel #1 imagecolorallocate() Beispiel

<?php

$im 
imagecreate(100100);

// färbt den Hintergrund rot
$background imagecolorallocate($im25500);

// alloziert weitere Farben
$white imagecolorallocate($im255255255);
$black imagecolorallocate($im000);

// hexadezimale Schreibweise
$white imagecolorallocate($im0xFF0xFF0xFF);
$black imagecolorallocate($im0x000x000x00);

?>

Siehe auch