imagesavealpha

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

imagesavealpha — 画像を保存する際に、完全なアルファチャネル情報を保存するかどうかを指定する

説明

imagesavealpha(GdImage $image, bool $enable): bool

imagesavealpha() は画像を保存する際に（単一色の透過設定ではない）完全なアルファチャネル情報を保存するフラグを設定します。この関数は、完全なアルファチャンネル情報をサポートしている画像フォーマット、つまり、PNG, WebP, AVIF をサポートしています。

注意: imagesavealpha() は、PNG でのみ意味があります。なぜなら、完全なアルファチャンネル情報を WebP, AVIF は常に保存するからです。この振る舞いは将来変更される可能性があるので、依存すべきではありません。よって、WebP や AVIF 画像であっても imagesavealpha() を意図的にコールすべきです。

アルファチャネルを保存するためには、まずアルファブレンディングを解除する必要があります (imagealphablending($im, false))。

パラメータ

image: imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。
enable: アルファチャネルを保存するか否か。デフォルトは false です。

戻り値

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

変更履歴

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

例

例1 基本的な imagesavealpha() の使用法

<?php
// アルファチャネルつきの png 画像を読み込みます
$png = imagecreatefrompng('./alphachannel_example.png');

// アルファブレンディングを無効にします
imagealphablending($png, false);

// 望んだ操作をします

// アルファフラグを設定します
imagesavealpha($png, true);

// 画像をブラウザに出力します
header('Content-Type: image/png');

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

参考

imagealphablending() - イメージのブレンドモードを設定する

add a note

User Contributed Notes 2 notes

down

ray hatfield ¶

13 years ago


After much trial and error and gnashing of teeth I finally figured out how to composite a png with an 8-bit alpha onto a jpg. This was not obvious to me so I thought I'd share. Hope it helps.



I'm using this to create a framed thumbnail image:



<?php

// load the frame image (png with 8-bit transparency)

$frame = imagecreatefrompng('path/to/frame.png');



// load the thumbnail image

$thumb = imagecreatefromjpeg('path/to/thumbnail.jpg');



// get the dimensions of the frame, which we'll also be using for the

// composited final image.

$width = imagesx( $frame );

$height = imagesy( $frame );



// create the destination/output image.

$img=imagecreatetruecolor( $width, $height );



// enable alpha blending on the destination image.

imagealphablending($img, true);



// Allocate a transparent color and fill the new image with it.

// Without this the image will have a black background instead of being transparent.

$transparent = imagecolorallocatealpha( $img, 0, 0, 0, 127 );

imagefill( $img, 0, 0, $transparent );



// copy the thumbnail into the output image.

imagecopyresampled($img,$thumb,32,30,0,0, 130, 100, imagesx( $thumb ), imagesy( $thumb ) );



// copy the frame into the output image (layered on top of the thumbnail)

imagecopyresampled($img,$frame,0,0,0,0, $width,$height,$width,$height);



imagealphablending($img, false);



// save the alpha

imagesavealpha($img,true);



// emit the image

header('Content-type: image/png');

imagepng( $img );



// dispose

imagedestroy($img);



// done.

exit;

?>

down

-1

phil at unabacus dot net ¶

16 years ago


The comment left by "doggz at mindless dot com" will cause a duplication in layering of the transparent image - AlphaImageLoader loads the image as if it were a floating layer on top of the <img> element - so your image will double up.. so don't go thinking something very strange is happening with your PHP it's the silly browser ;)

The easiest (although not the best) way to get around this is to use the CSS background property instead of an image src - because as of yet you can't change an image's src dynamically using currently supported CSS:

<div style="width:200px; height:200px; background: url(my-trans-image.php); *background:url(); *filter:progid:
DXImageTransform.Microsoft.AlphaImageLoader(src='my-trans-image.php', sizingMethod='scale');"></div>

The above (although not pretty) keeps the image loaded as a background for any good browser as they should ignore the starred (*) CSS items and should support Alpha PNGs natively. IE will listen to the starred items and blank out the background whilst applying it's AlphaLoader on top. Obviously you need to know the width and height of your image but you can get this using getimagesize() or just by hardcoding.

Downsides to know:

1. Unless the user has 'backgrounds enabled when printing' your image wont show up when the webpage is printed.

2. You can't stretch or shrink a background image - if you change the div's dimensions from that of the image you will stretch it in IE (due to the 'scale' property - which you can change for sake of standardness to 'crop') but you will crop it in any other browser.

3. Most browsers treat images and backgrounds differently, in load priority and in the way the user can interact with them.

Other Options:

Other methods resort to using JavaScript or Browser Detection on the Server Side.

add a note