array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.imagecolorexact.php', 1 => 'imagecolorexact', 2 => 'Ermittelt den Index-Wert der angegebenen Farbe', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'GD- und Image-Funktionen', ), 'prev' => array ( 0 => 'function.imagecolordeallocate.php', 1 => 'imagecolordeallocate', ), 'next' => array ( 0 => 'function.imagecolorexactalpha.php', 1 => 'imagecolorexactalpha', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/image/functions/imagecolorexact.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imagecolorexact

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

imagecolorexact — Ermittelt den Index-Wert der angegebenen Farbe

Beschreibung

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

Gibt den Index der angegebenen Farbe in der Farb-Palette des Bildes zurück.

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 den Paletten-Index der angegeben Farbe zurück, oder -1, falls die Farbe nicht existiert.

Changelog

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

Beispiele

Beispiel #1 Ermittle Farben des GD-Logos

<?php
// Lade ein Bild
$im = imagecreatefrompng('./gdlogo.png');

$colors = Array();
$colors[] = imagecolorexact($im, 255, 0, 0);
$colors[] = imagecolorexact($im, 0, 0, 0);
$colors[] = imagecolorexact($im, 255, 255, 255);
$colors[] = imagecolorexact($im, 100, 255, 52);

print_r($colors);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Array
(
    [0] => 16711680
    [1] => 0
    [2] => 16777215
    [3] => 6618932
)

Siehe auch