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');

?>