imagetruecolortopalette

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

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

Описание

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

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

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

image

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

dither

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

num_colors

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

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

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

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

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

Примеры

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

<?php

// Создание truecolor-изображения
$im = imagecreatetruecolor(100, 100);

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

// Сохранение изображения
imagepng($im, './paletteimage.png');

?>