imagetruecolortopalette

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

imagetruecolortopalette Преобразовывает полноцветное изображения в палитровое

Описание

imagetruecolortopalette(GdImage $image, bool $dither, int $num_colors): bool

Функция imagetruecolortopalette() преобразовывает полноцветное изображение в палитровое. Код этой функции взят из кода библиотеки Независимой Группы JPEG. Код был модифицирован, чтобы сохранялось максимум информации об альфа компонентах цветов, а также передавались цвета в лучшем виде насколько это возможно. Но в итоге код работает не так хорошо, как хотелось бы. В связи с этим функцию можно использовать для вывода полноцветных изображений, она гарантирует самое высокое качество вывода. Но не более того.

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

image

Объект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().

dither

Если задано значение true, изображение будет сглаживаться. Сглаживание увеличивает шумность картинки, но в то же время обеспечивает лучшую передачу цветов.

num_colors

Задаёт максимальное количество цветов в палитре.

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

Возвращает true в случае успешного выполнения или false, если возникла ошибка.

Список изменений

Версия Описание
8.0.0 Параметр image теперь ожидает экземпляр класса GdImage; раньше параметр ждал корректный gd-ресурс (resource).

Примеры

Пример #1 Преобразование truecolor-изображения в палитровое

<?php
// Создание полноцветного изображения
$im = imagecreatetruecolor(100, 100);

// Преобразование в палитровое (255 цветов) без сглаживания
imagetruecolortopalette($im, false, 255);

// Сохранение картинки
imagepng($im, './paletteimage.png');
imagedestroy($im);
?>