imagecolorresolve() function in PHP

The imagecolorresolve() function gets the index of the specified color or its closest possible alternative in a palette-based image. This function is useful when working with palette images where exact color matches might not be available.

Syntax

imagecolorresolve(resource $image, int $red, int $green, int $blue)

Parameters

• image − An image resource created by functions like imagecreate() or imagecreatefromgif().

• red − The value of the red component (0-255).

• green − The value of the green component (0-255).

• blue − The value of the blue component (0-255).

Return Value

Returns the color index of the specified color or its closest alternative in the image palette.

Example

The following example demonstrates how to resolve color indexes from RGB values ?

<?php
    // Create a palette-based image
    $img = imagecreate(100, 100);
    
    // Allocate some colors
    $white = imagecolorallocate($img, 255, 255, 255);
    $red = imagecolorallocate($img, 255, 0, 0);
    $green = imagecolorallocate($img, 0, 255, 0);
    $blue = imagecolorallocate($img, 0, 0, 255);
    
    // Resolve colors - get indexes for RGB values
    $colors = array();
    $colors[] = imagecolorresolve($img, 255, 0, 0);      // Exact red match
    $colors[] = imagecolorresolve($img, 250, 10, 10);    // Close to red
    $colors[] = imagecolorresolve($img, 0, 255, 0);      // Exact green match
    $colors[] = imagecolorresolve($img, 128, 128, 128);  // Closest to gray
    
    print_r($colors);
    
    imagedestroy($img);
?>

Array
(
    [0] => 1
    [1] => 1
    [2] => 2
    [3] => 0
)

How It Works

The function searches the image palette for an exact color match first. If no exact match is found, it returns the index of the closest color based on RGB distance calculation. This is particularly useful for palette-based images where the color palette is limited.

Conclusion

The imagecolorresolve() function is essential for working with palette-based images when you need to find color indexes. It automatically handles both exact matches and closest alternatives, making color manipulation more flexible.