imagetruecolortopalette

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

imagetruecolortopaletteConverte uma imagem em cores verdadeiras em uma imagem de paleta

Descrição

imagetruecolortopalette(GdImage$image, bool$dither, int$num_colors): bool

imagetruecolortopalette() converte uma imagem em cores verdadeiras em uma imagem de paleta. O código para esta função foi originalmente escrito a partir do código da biblioteca do Independent JPEG Group, que é excelente. O código foi modificado para presevar o máximo possível de informação do canal alfa na paleta resultante, além de preservar as cores da melhor maneira possível. Isto não funciona tão bem quanto esperado. Normalmente é melhor simplesmente produzir uma imagem em cores verdadeiras, o que garante a qualidade de saída mais alta possível.

Parâmetros

image

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

dither

Indica se a imagem deve ser pontilhada - se for true o pontilhamento será usado, o que resultará em uma imagem mais salpicada mas com uma melhor aproximação de cores.

num_colors

Define o número máximo de cores que deve sem mantido na paleta.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

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

Exemplos

Exemplo #1 Convertendo uma imagem em cores verdadeiras em uma imagem de paleta

<?php
// Cria uma nova imagem em cores verdadeiras
$im = imagecreatetruecolor(100, 100);

// Converte para paleta sem pontilhamento e com 255 cores
imagetruecolortopalette($im, false, 255);

// Grava a imagem
imagepng($im, './paletteimage.png');
imagedestroy($im);
?>
To Top