Gmagick::quantizeimages
(PECL gmagick >= Unknown)
Gmagick::quantizeimages — Анализирует цвета в последовательности изображений
Описание
public Gmagick::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, если возникла ошибка.