imagetruecolortopalette

(PHP 4 >= 4.0.6, PHP 5)

imagetruecolortopalette — TrueColor イメージをパレットイメージに変換する

説明

bool imagetruecolortopalette ( resource $image , bool $dither , int $ncolors )

imagetruecolortopalette() は、TrueColorイメージをパレットイメージに変換します。この関数のコードは、元々 Independent JPEG Groupライブラリ用に書かれたもので、素晴らしいものです。このコードは、色をできる限り維持することに加えて、アルファチャネルに関する情報を出力されるパレットにおいてできるだけ維持するように修正されています。これは、期待通りにうまくいきません。通常は、最高の出力品質が保障されるTrueColor出力イメージを単に出力するのが最良の方法です。

パラメータ

image: imagecreatetruecolor() のような画像作成関数が返す画像リソース。
dither: イメージにディザーをかけることを指定します。 TRUE の場合はディザーが行われます。出力はぼやけますが、色の近似はより良くなります。
ncolors: パレットに保持される最大の色数を設定します。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

例

例1 true color 画像からパレット画像への変換


<?php
// 新しい true color 画像を作成します
$im = imagecreatetruecolor(100, 100);

// ディザリングなしの 255 色パレットに変換します
imagetruecolortopalette($im, false, 255);

// 画像を保存します
imagepng($im, './paletteimage.png');
imagedestroy($im);
?>

注意

注意: この関数は、GD 2.0.1 以降を必要とします (2.0.28 以降を推奨します)。