# imagetruecolortopalette

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

imagetruecolortopalette — Convertit une image en couleurs vraies en image à palette

### Description

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

imagetruecolortopalette() convertit l'image en vraies couleurs `image` en image à palette. Le code de cette fonction est directement tiré de la bibliothèque du `Independent JPEG Group`, qui est tout simplement génial. Le code a été modifié pour préserver l'essentiel du canal alpha dans la nouvelle palette, en plus de conserver les couleurs du mieux possible. Mais cela ne fonctionne pas toujours comme voulu. Il est alors préférable de générer un résultat en vraies couleurs, ce qui donne toujours le meilleur rendu.

### Liste de paramètres

`image`

  Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

`dither`

  Indique si l'image doit être granuleuse - si défini à `true`, alors l'image sera un peu plus granuleuse mais l'approximation des couleurs sera meilleure.

`num_colors`

  Le nombre maximal de couleurs dans la palette finale.

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.

### Exemples

Exemple #1 Conversion d'une image truecolor en une palette

`<?php
// Création d'une image truecolor
$im = imagecreatetruecolor(100, 100);
// Conversion en palette de 255 couleurs
imagetruecolortopalette($im, false, 255);
// Sauvegarde de l'image
imagepng($im, './paletteimage.png');
?>`