Gmagick::quantizeimage
(PECL gmagick >= Unknown)
Gmagick::quantizeimage — Analisa as cores dentro de uma imagem de referência
Descrição
public Gmagick::quantizeimage(
int $numColors,
int $colorspace,
int $treeDepth,
bool $dither,
bool $measureError):
Gmagick
Analisa as cores em uma imagem de referência e escolhe um número fixo de
cores para representar a imagem. O objetivo do algoritmo é minimizar a
diferença de cor entre a imagem de entrada e de saída e, ao mesmo tempo, minimizar o tempo de processamento.
Parâmetros
numColors-
O número de cores.
colorspace-
Executa a redução de cores neste espaço de cores, normalmente RGBColorspace.
treeDepth-
Normalmente, esse valor inteiro é zero ou um. Zero ou um diz à função
para escolher uma profundidade de árvore ideal de Log4(número_de_cores). Uma árvore com essa profundidade geralmente
permite a melhor representação da imagem de referência com a menor quantidade de memória
e a velocidade computacional mais rápida. Em alguns casos, como uma imagem com baixa dispersão de
cores (poucos números de cores), é necessário um valor diferente de Log4(number_colors).
Para expandir completamente a árvore de cores, use o valor 8.
dither-
Um valor diferente de zero distribui a diferença entre uma imagem original e o algoritmo de redução de cor correspondente para pixels vizinhos ao longo de uma curva de Hilbert.
measureError-
Um valor diferente de zero mede a diferença entre as imagens original e quantizada. Essa diferença é o erro total de quantização. O erro é calculado somando todos os pixels de uma imagem a distância ao quadrado no espaço RGB entre cada valor de pixel de referência e seu valor quantizado.
Valor Retornado
O objeto Gmagick em caso de sucesso.
Erros/Exceções
Lança uma exceção
GmagickException em caso de erro.
