imagecolorat

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecolorat — Liefert den Farbwert eines Bildpunktes

Beschreibung

imagecolorat(GdImage $image, int $x, int $y): int|false

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.

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
8.0.0 image erwartet nun eine GdImage-Instanz; vorher wurde eine gültige gd-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