Retorna el color asociado a un índice

# imagecolorsforindex

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

imagecolorsforindex — Retorna el color asociado a un índice

### Descripción

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

Retorna el color asociado a un índice especificado.

### Parámetros

`image`
  Un objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().
`color`

  El índice del color.

### Valores devueltos

Retorna un array asociativo con las claves `"red"`, `"green"`, `"blue"` y `"alpha"` que contienen los valores para el índice del color especificado.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `image` ahora espera una instancia de GdImage; anteriormente, se esperaba un resource `gd` válido.
8.0.0 | La función imagecolorsforindex() ahora lanza una excepción ValueError si `color` está fuera de rango; anteriormente, se retornaba `false` en su lugar.

### Ejemplos

Ejemplo #1 Ejemplo con imagecolorsforindex()

    <?php

    // se abre una imagen
    $im = imagecreatefrompng('nexen.png');

    // se obtiene un color
    $start_x = 40;
    $start_y = 50;
    $color_index = imagecolorat($im, $start_x, $start_y);

    // se lo hace legible
    $color_tran = imagecolorsforindex($im, $color_index);

    // ¿Cuál es?
    print_r($color_tran);

    ?>

Resultado del ejemplo anterior es similar a:

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

### Ver también

- imagecolorat() - Devuelve el índice del color de un píxel dado
- imagecolorexact() - Devuelve el índice del color especificado

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