PHP マニュアル
前のページ |  | 次のページ

# imagecolorallocate

(PHP 3, PHP 4, PHP 5)

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

## 説明

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

指定した RGB を配色とする色の ID を返します。

imagecolorallocate() は `image` で表される画像上で使用する各々の色を作成する際にコールする必要があります。

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

## パラメータ

`image`

  imagecreatetruecolor() のような画像作成関数が返す画像リソース。

`red`

  赤コンポーネントの値。

`green`

  緑コンポーネントの値。

`blue`

  青コンポーネントの値。

これらの値は 0 から 255 までの整数か、あるいは 0x00 から 0XFF までの 16 進数です。

## 返り値

色の ID、あるいは作成に失敗したい場合に `FALSE` を返します。

## 変更履歴

バージョン | 説明
--- | ---
5.1.3 より前 | 作成に失敗した場合には -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); ?>`

## 参考

imagecolorallocatealpha()
imagecolordeallocate()

前のページ | ホーム | 次のページ
imagecharup | 上に戻る | imagecolorallocatealpha