Gmagick::quantizeimages

(PECL gmagick >= Unknown)

Gmagick::quantizeimagesАнализирует цвета в последовательности изображений

Описание

publicGmagick::quantizeimages(
    int$numColors,
    int$colorspace,
    int$treeDepth,
    bool$dither,
    bool$measureError
): Gmagick

Анализирует цвета в последовательности изображений и выбирает фиксированное количество цветов для представления изображения. Целью алгоритма является минимизация разницы в цвете между входным и выходным изображением при минимизации времени обработки.

Список параметров

numColors

Количество цветов.

colorspace

Цветовое пространство, в котором выполнится уменьшение цвета, обычно RGB.

treeDepth

Обычно это целое значение равно нулю или единице. Ноль или единица указывает Quantize выбрать оптимальную глубину дерева Log4(number_colors). Дерево этой глубины обычно обеспечивает наилучшее представление эталонного изображения с наименьшим объёмом памяти и максимальной скоростью вычислений. В некоторых случаях, например для изображения с низкой цветовой дисперсией (несколько цветов), требуется значение, отличное от Log4(number_colors). Чтобы полностью развернуть дерево цветов, используйте значение 8.

dither

Значение, отличное от нуля, распределяет разницу между исходным изображением и соответствующим алгоритмом уменьшения цвета на соседние пиксели вдоль кривой Гильберта.

measureError

Значение, отличное от нуля, измеряет разницу между исходным и квантованным изображениями. Эта разница составляет полную ошибку квантования. Ошибка вычисляется путём суммирования по всем пикселям изображения квадрата расстояния в пространстве RGB между значением каждого эталонного пикселя и его квантованным значением.

Возвращаемые значения

Объект Gmagick в случае успешного выполнения.

Ошибки

Вызывает GmagickException, если возникла ошибка.

To Top