PHP 4, PHP 5, PHP 7, PHP 8
imagecolorclosest - Get the index of the closest color to the specified color
Code Examples

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

Returns the index of the color in the palette of the image which is "closest" to the specified RGB value.

The "distance" between the desired color and each color in the palette is calculated as if the RGB values represented points in three-dimensional space.

If you created the image from a file, only colors used in the image are resolved. Colors present only in the palette are not resolved.



A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor.


Value of red component.


Value of green component.


Value of blue component.

The colors parameters are integers between 0 and 255 or hexadecimals between 0x00 and 0xFF.

Return Values

Returns the index of the closest color, in the palette of the image, to the specified one


Version Description
8.0.0 image expects a GdImage instance now; previously, a resource was expected.

Related Functions

Example of imagecolorclosest

Show all examples for imagecolorclosest

PHP Version:

Function imagecolorclosest:

Image Processing and GD Functions

Most used PHP functions