imagecolorallocate
(PHP 4, PHP 5, PHP 7)
imagecolorallocate — 画像で使用する色を作成する
説明
int imagecolorallocate
( resource
$image
, int $red
, int $green
, int $blue
)指定した RGB を配色とする色の ID を返します。
imagecolorallocate() は image
で表される画像上で使用する各々の色を作成する際にコールする必要があります。
注意:
imagecolorallocate() の最初のコールで パレットをもとにした画像 (imagecreate() を使用して作成した画像) で背景色がセットされます。
パラメータ
-
image -
imagecreatetruecolor() のような画像作成関数が返す画像リソース。
-
red -
赤コンポーネントの値。
-
green -
緑コンポーネントの値。
-
blue -
青コンポーネントの値。
返り値
色の ID、あるいは作成に失敗したい場合に FALSE を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 5.1.3 |
作成に失敗した場合に FALSE を返すようになりました。
これより前のバージョンでは、-1 を返していました。
|
例
例1 imagecolorallocate() の例
<?php
$im = imagecreate(100, 100);
// 背景色を赤にします
$background = imagecolorallocate($im, 255, 0, 0);
// その他の色を設定します
$white = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);
// 十六進で指定します
$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
$black = imagecolorallocate($im, 0x00, 0x00, 0x00);
?>
忘却曲線を使ってこの関数を確実に記憶に残す
