imagetruecolortopalette

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

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

Описание

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

?>