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