imagecolorsforindex

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

imagecolorsforindex — Ermittelt die Farbwerte eines Palettenindex

Beschreibung

imagecolorsforindex(GdImage $image, int $color): array

Gibt die Farbwerte eines Palettenindex zurück.

Parameter-Liste

image

Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.

color

Der Palettenindex.

Rückgabewerte

Gibt ein assoziatives Array mit den Schlüsseln red, green, blue und alpha zurück, das die entsprechenden Werte für den angegebenen Palettenindex enthält.

Changelog

Version Beschreibung
8.0.0 image erwartet nun eine GdImage-Instanz; vorher wurde eine gültige gd-Ressource erwartet.
8.0.0 imagecolorsforindex() löst jetzt eine ValueError Ausnahme aus, wenn color außerhalb des Bereichs liegt; zuvor wurde stattdessen false zurückgegeben.

Beispiele

Beispiel #1 imagecolorsforindex()-Beispiel

<?php

// Erzeuge ein Bild
$im = imagecreatefrompng('nexen.png');

// Ermittle eine Farbe
$start_x = 40;
$start_y = 50;
$color_index = imagecolorat($im, $start_x, $start_y);

// Bringe es in menschenlesbare Form
$color_tran = imagecolorsforindex($im, $color_index);

// Was ist es?
print_r($color_tran);

?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Array
(
   [red] => 226
   [green] => 222
   [blue] => 252
   [alpha] => 0
)

Siehe auch