imagepalettetotruecolor

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

imagepalettetotruecolor — Converte uma imagem baseada em paleta para cores verdadeiras

Descrição

imagepalettetotruecolor(GdImage $image): bool

Converte uma imagem baseada em paleta, criada por funções como imagecreate(), para uma imagem em cores verdadeiras, como imagecreatetruecolor().

Parâmetros

image

Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().

Valor Retornado

Retorna true se a conversão for concluída, ou se a imagem de origem já estiver em cores verdadeiras, caso contrário é retornado false.

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 Converte qualquer objeto de imagem para cores verdadeiras 

<?php
// Compatibilidade com versões anteriores
if(!function_exists('imagepalettetotruecolor'))
{
    function imagepalettetotruecolor(&$src)
    {
        if(imageistruecolor($src))
        {
            return(true);
        }

        $dst = imagecreatetruecolor(imagesx($src), imagesy($src));

        imagecopy($dst, $src, 0, 0, 0, 0, imagesx($src), imagesy($src));
        imagedestroy($src);

        $src = $dst;

        return(true);
    }
}

// Closure de apoio
$typeof = function() use($im)
{
    echo 'typeof($im) = ' . (imageistruecolor($im) ? 'cores verdadeiras' : 'paleta'), PHP_EOL;
};

// Cria uma imagem baseada em paleta
$im = imagecreate(100, 100);
$typeof();

// Converte para cores verdadeiras
imagepalettetotruecolor($im);
$typeof();

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

O exemplo acima produzirá:

typeof($im) = paleta
typeof($im) = cores verdadeiras

Veja Também