Retourne la couleur associée à un index

# imagecolorsforindex

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

imagecolorsforindex — Retourne la couleur associée à un index

### Description

function 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 plage ; antérieur à cela, `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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open