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.