# imagecolorsforindex

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

imagecolorsforindex — Retourne la couleur associée à un index

### Description

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

Retourne la couleur associée à un index spécifié.

### Liste de paramètres

`image`

  Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

`color`

  L'index de la couleur.

### Valeurs de retour

Retourne un tableau associatif avec les clés `"red"`, `"green"`, `"blue"` et `"alpha"` qui contiennent les valeurs pour l'index de la couleur spécifiée.

### Historique

Version | Description
--- | ---
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.
8.0.0 | La fonction imagecolorsforindex() lance désormais une exception ValueError si `color` est hors de portée; auparavant, `false` était retourné à la place.

### Exemples

Exemple #1 Exemple avec imagecolorsforindex()

`<?php
// on ouvre une image
$im = imagecreatefrompng('nexen.png');
// on obtient une couleur
$start_x = 40;
$start_y = 50;
$color_index = imagecolorat($im, $start_x, $start_y);
// on la rend lisible
$color_tran = imagecolorsforindex($im, $color_index);
// quelle est-elle ?
print_r($color_tran);
?>`

Résultat de l'exemple ci-dessus est similaire à :

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

### Voir aussi

- imagecolorat() - Retourne l'index de la couleur d'un pixel donné
- imagecolorexact() - Retourne l'index de la couleur donnée