Obtém o índice da cor especificada

Descrição

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

Retorna o índice, na paleta da imagem, da cor especificada.

Se a imagem foi criada a partir de um arquivo, apenas as cores usadas na imagem são resolvidas. As cores presentes apenas na paleta não serão resolvidas.

Parâmetros

image: Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
red: Valor do componente vermelho.
green: Valor do componente verde.
blue: Valor do componente azul.

Valor Retornado

Retorna o índice, na paleta da imagem, da cor especificada, ou -1 se a cor não existir.

Registro de Alterações

Versão	Descrição
8.0.0	O parâmetro `image` agora espera uma instância de GdImage; anteriormente, um resource `gd` válido era esperado.

Exemplos

Example #1 Obtém cores da logomarca GD

<?php
// Configura uma imagem
$im = imagecreatefrompng('./gdlogo.png');

$colors   = Array();
$colors[] = imagecolorexact($im, 255, 0, 0);
$colors[] = imagecolorexact($im, 0, 0, 0);
$colors[] = imagecolorexact($im, 255, 255, 255);
$colors[] = imagecolorexact($im, 100, 255, 52);

print_r($colors);

// Libera da memória
imagedestroy($im);
?>

O exemplo acima produzirá algo semelhante a:

Array
(
    [0] => 16711680
    [1] => 0
    [2] => 16777215
    [3] => 6618932
)

Veja Também

imagecolorclosest() - Obtém o índice da cor mais próxima à especificada