大网数据广告活动
PHP 语言与运行手册

imagecolortransparent · 将颜色定义为透明

· 52CE 我爱测

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

imagecolortransparent

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecolortransparent — 将颜色定义为透明

说明

function imagecolortransparent(GdImage $image, ?int $color = null): int

获取或设置指定 image 中的透明色。

参数

image

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

color

颜色标识符使用 imagecolorallocate() 创建。

返回值

返回新(或当前,如果未指定)透明色的标识符。如果 color 为 null,并且图像没有透明色,则返回的标识符为 -1。

更新日志

版本 说明
8.0.0 image 现在需要 GdImage 实例;之前需要有效的 gd resource。
8.0.0 color 现在允许为 null。

示例

示例 #1 imagecolortransparent() 示例

<?php
// 创建 55x30 图像
$im = imagecreatetruecolor(55, 30);
$red = imagecolorallocate($im, 255, 0, 0);
$black = imagecolorallocate($im, 0, 0, 0);

// 使背景透明
imagecolortransparent($im, $black);

// 画红色矩形
imagefilledrectangle($im, 4, 4, 50, 25, $red);

// 保存图像
imagepng($im, './imagecolortransparent.png');
?>

以上示例的输出类似于:

注释

注意:

透明度仅能使用 imagecopymerge() 和真彩色图像复制,而不使用 imagecopy() 或调色板图像。

注意:

透明色是图像的属性,透明度不是颜色的属性。一旦设定某个颜色为透明色,图像中之前绘制为该颜色的任何区域都成为透明的。

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。