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

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

    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open