imagecolorallocate

説明

int imagecolorallocate ( resource image, int red, int green, int blue)

imagecolorallocate()は、指定したRGB を配色とする色の色IDを返します。引数imはimagecreate()関数から返されたものです。red, green, blueはそれぞれ赤、緑、青のカラーコンポーネント値です。これらの値は0から255までの整数か、あるいは0x00から0XFFまでの16進数です。 imagecolorallocate()はimageで表される画像上で使用される各々の色を作成する際にコールする必要があります。

注意: imagecolorallocate()の最初のコールで背景色がセットされます。


<?php

// 背景色を赤にセット
$background = imagecolorallocate($im, 255, 0, 0);

// 他の色もセット
$white = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);

// 16進数での指定
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
$black = imagecolorallocate($im, 0x00, 0x00, 0x00);

?>

作成に失敗すると-1が返されます。

imagecolorallocatealpha()と imagecolordeallocate()も参照してください。