imagecolorallocate

(PHP 3, PHP 4, PHP 5)

imagecolorallocate -- 画像で使用する色を作成する

説明

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

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

注意: imagecolorallocate() の最初のコールで パレットをもとにした画像 (imagecreate() を使用して作成した画像) で背景色がセットされます。

例 1. imagecolorallocate() example

<?php

$im
= imagecreate(100, 100);

// 背景色を赤にセット
$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() も参照ください。