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

# imagecolorallocatealpha

(PHP 4 >= 4.3.2, PHP 5)

imagecolorallocatealpha -- 画像で使用する色を透過度を指定して作成する

## 説明

int imagecolorallocatealpha ( resource image, int red, int green, int blue, int alpha )

imagecolorallocatealpha() は、 透明度を指定するパラメータ `alpha` が追加されている以外は imagecolorallocate() と等価です。

## パラメータ

`image`

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

`red`

  赤コンポーネントの値。

`green`

  緑コンポーネントの値。

`blue`

  青コンポーネントの値。

`alpha`

  `0` から `127` までの値。 `0` は完全に不透明な状態。 `127` は完全に透明な状態を表します。

色のパラメータは、0 から 255 までの整数値か 0x00 から 0xFF までの十六進値を指定します。

## 返り値

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

## 変更履歴

バージョン | 説明
--- | ---
5.1.3 より前 | 作成に失敗した場合には -1 を返します。

## 例

例 1. imagecolorallocatealpha() の使用例

`<?php
$size = 300;
$image=imagecreatetruecolor($size, $size);
// 白い背景で黒いふちどりにします
$back = imagecolorallocate($image, 255, 255, 255);
$border = imagecolorallocate($image, 0, 0, 0);
imagefilledrectangle($image, 0, 0, $size - 1, $size - 1, $back);
imagerectangle($image, 0, 0, $size - 1, $size - 1, $border);
$yellow_x = 100;
$yellow_y = 75;
$red_x = 120;
$red_y = 165;
$blue_x = 187;
$blue_y = 125;
$radius = 150;
// alpha 値を指定して色を作成します
$yellow = imagecolorallocatealpha($image, 255, 255, 0, 75);
$red = imagecolorallocatealpha($image, 255, 0, 0, 75);
$blue = imagecolorallocatealpha($image, 0, 0, 255, 75);
// 3つの重なる円を描きます
imagefilledellipse($image, $yellow_x, $yellow_y, $radius, $radius, $yellow);
imagefilledellipse($image, $red_x, $red_y, $radius, $radius, $red);
imagefilledellipse($image, $blue_x, $blue_y, $radius, $radius, $blue);
// 正しいヘッダを出力するのを忘れないように!
header('Content-type: image/png');
// 最後に、結果を出力します
imagepng($image);
imagedestroy($image);
?>`

上の例の出力は、たとえば 以下のようになります。

## 注意

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

## 参考

imagecolorallocate()
imagecolordeallocate()

前のページ | ホーム | 次のページ
imagecolorallocate | 上に戻る | imagecolorat