imagecolorresolve

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

imagecolorresolve — Ermittelt den Index-Wert der angegebenen Farbe oder die nächstmögliche Alternative dazu

Beschreibung

imagecolorresolve(
    GdImage $image,
    int $red,
    int $green,
    int $blue
): int

Diese Funktion gibt garantiert einen Farbindex für die angegebenen Farbe zurück, entweder den exakten oder den nächstmöglichen Wert.

Wenn das Bild aus einer Datei erzeugt wurde, so werden nur die Farben aufgelöst, die im Bild verwendet werden. Farben, die nur in der Farbpalette enthalten sind, werden nicht aufgelöst.

Parameter-Liste

image: Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
red: Wert der Rotkomponente.
green: Wert der Grünkomponente.
blue: Wert der Blaukomponente.

Rückgabewerte

Gibt einen Farbindex zurück.

Changelog

Version	Beschreibung
8.0.0	`image` erwartet nun eine GdImage-Instanz; vorher wurde eine gültige `gd`-Ressource erwartet.

Beispiele

Beispiel #1 Verwendung von imagecoloresolve(), um Farben aus einem Bild auszulesen

<?php
// Lade ein Bild
$im = imagecreatefromgif('phplogo.gif');

// Ermittle die nächstgelegenen Farben des Bildes
$colors = array();
$colors[] = imagecolorresolve($im, 255, 255, 255);
$colors[] = imagecolorresolve($im, 0, 0, 200);

// Output
print_r($colors);

imagedestroy($im);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Array
(
    [0] => 89
    [1] => 85
)

Siehe auch

imagecolorclosest() - Ermittelt den Index der Farbe, die der angegebenen Farbe am nächsten kommt