imagesavealpha

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

imagesavealpha — 保存图像时是否保留完整的 alpha 通道信息

说明

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

imagesavealpha() 设置标记，确定在保存图像时是否保存完整的 alpha 通道信息（与单一透明色相反）。 这仅支持支持完整 alpha 通道信息的图像格式，即 PNG、WebP 和 AVIF。

注意: imagesavealpha() is only meaningful for PNG images, since the full alpha channel is always saved for WebP and AVIF. It is not recommended to rely on this behavior, as it may change in the future. Thus, imagesavealpha() should be called deliberately also for WebP and AVIF images.

必须禁用 alpha 混合（imagealphablending($im, false)），以首先保留 alpha 通道。

参数

image

由图象创建函数(例如imagecreatetruecolor())返回的 GdImage 对象。

enable

是否保存透明（alpha）通道。默认 false。

返回值

成功时返回 true， 或者在失败时返回 false。

更新日志

版本 说明
8.0.0 image 现在需要 GdImage 实例；之前需要有效的 gd resource。

示例

示例 #1 基础 imagesavealpha() 用法

<?php
// 载入带 alpha 通道的 png 图像
$png = imagecreatefrompng('./alphachannel_example.png');

// 关闭 alpha 混合
imagealphablending($png, false);

// Do desired operations

//并设置 alpha 标志
imagesavealpha($png, true);

// 输出图像到浏览器
header('Content-Type: image/png');

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

参见