imagecolorclosest

imagecolorclosest(GdImage $image, int $red, int $green, int $blue): int
```php

Devuelve el índice de la color de la paleta que es la más cercana al valor RGB pasado.

La "distancia" entre la color deseada y las colores de la paleta se calcula considerando el espacio RGB como un espacio de 3 dimensiones.

Si la imagen fue creada a partir de un fichero, solo se resuelven los colores utilizados en la imagen. Los colores presentes únicamente en la paleta no se resuelven.

## Parámetros

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

`red`  
Valor del componente rojo.

`green`  
Valor del componente verde.

`blue`  
Valor del componente azul.

Los argumentos sobre las colores son enteros comprendidos entre 0 y 255 o hexadecimales comprendidos entre 0x00 y 0xFF.

## Valores devueltos

Devuelve el índice de la color más cercana, en la paleta de la imagen, a la dada.

## 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. |

## Ejemplos

Búsqueda de un juego de colores en una imagen

#0: Búsqueda (254, 145, 154); Correspondencia : (252, 150, 148).
#1: Búsqueda (153, 145, 188); Correspondencia : (148, 150, 196).
#2: Búsqueda (153, 90, 145); Correspondencia : (148, 90, 156).
#3: Búsqueda (255, 137, 92); Correspondencia : (252, 150, 92).