imagecolorexact

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecolorexact — 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

Exemplo #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);
?>

O exemplo acima produzirá algo semelhante a:

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

Veja Também