imagealphablending

イメージのブレンドモードを設定する

説明

bool imagealphablending(GdImage $image, bool $enable)

imagealphablending によりTrueColorイメージに二つの異なる描画モードを使用可能となります。ブレンドモードでは、全ての描画関数に指定される色のalphaチャネル要素として使用され、例えばimagesetpixelでは背景色の透過割合を定義します。結果として、gd は描画色に関してその点に存在する色を自動的にブレンドし、イメージに結果を保存します。結果のピクセルは、透明になります。ブレンドモードでない場合、描画色は形式的にそのアルファチャネル情報にコピーされ、出力ピクセルを置換します。ブレンドモードは、パレットイメージを描画している際には使用できません。

パラメータ

image: imagecreatetruecolorのような画像作成関数が返す GdImage オブジェクト。
enable: ブレンドモードを有効にするかどうか。True Color 画像の場合のデフォルトは true、それ以外の場合のデフォルトは false です。

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン	説明
8.0.0	`image` は、 GdImage クラスのインスタンスを期待するようになりました。これより前のバージョンでは、有効な `gd` resource が期待されていました。

例

例1 imagealphablending の使用例

<?php
// 画像を作成します
$im = imagecreatetruecolor(100, 100);

// アルファブレンディングをオンにします
imagealphablending($im, true);

// 正方形を描画します
imagefilledrectangle($im, 30, 30, 70, 70, imagecolorallocate($im, 255, 0, 0));

// 出力します
header('Content-Type: image/png');

imagepng($im);
imagedestroy($im);
?>