imagecolorat
(PHP 4, PHP 5, PHP 7, PHP 8)
imagecolorat — Liefert den Farbwert eines Bildpunktes
Beschreibung
Gibt den Farbindex des Pixels zurück, das sich an den angegebenen
Koordinaten im Bild befindet, das durch image
angegeben wurde.
Handelt es sich bei dem Bild um ein Echtfarben-Bild, gibt diese Funktion den RGB-Wert dieses Pixels als Integer zurück. Bitverschiebung und Maskierung kann verwendet werden, um auf die individuellen roten, grünen und blauen Komponentenwerte zuzugreifen.
Parameter-Liste
-
image -
Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
-
x -
x-Kooordinate des Punkts.
-
y -
y-Koordinate des Punkts.
Rückgabewerte
Gibt den Farbindex zurück. Bei einem Fehler wird false zurückgegeben.
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 |
|---|---|
| 8.0.0 |
image erwartet nun eine
GdImage-Instanz; vorher wurde eine
Ressource erwartet.
|
Beispiele
Beispiel #1 Zurgriff auf individuelle RGB-Werte
<?php
$im = imagecreatefrompng("php.png");
$rgb = imagecolorat($im, 10, 15);
$r = ($rgb >> 16) & 0xFF;
$g = ($rgb >> 8) & 0xFF;
$b = $rgb & 0xFF;
var_dump($r, $g, $b);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
int(119) int(123) int(180)
Beispiel #2 Menschenlesbare RGB-Werte unter Verwendung von imagecolorsforindex()
<?php
$im = imagecreatefrompng("php.png");
$rgb = imagecolorat($im, 10, 15);
$colors = imagecolorsforindex($im, $rgb);
var_dump($colors);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
array(4) {
["red"]=>
int(119)
["green"]=>
int(123)
["blue"]=>
int(180)
["alpha"]=>
int(127)
}
Siehe auch
- imagecolorset() - Setzt die Farbe für den angegebenen Paletten-Index
- imagecolorsforindex() - Ermittelt die Farbwerte eines Palettenindex
- imagesetpixel() - Setze ein einzelnes Pixel
