Documentación offline PHP master

imagecolorsforindex

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

imagecolorsforindex

Retorna el color asociado a un índice

Descripción#

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

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 recurso `gd` de tipo `resource` 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 con `imagecolorsforindex`

```php

Resultado del ejemplo anterior es similar a:

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

Véase también#

imagecolorat

imagecolorexact