什么是GD库？PHP中7大类64个GD库函数用法详解

        GD库作为Web开发的重要组件，解决了服务器端动态生成图像的核心需求，在验证码生成、图片缩略图处理、水印添加等场景中发挥着不可替代的作用。在PHP应用中，GD库通过一系列图像处理函数实现画布创建、图形绘制、文字渲染和特效处理等功能，其轻量高效的特性使其成为PHP开发者处理图像任务的首选方案，极大增强了Web应用的图像交互能力。相较于其他图像处理方案，GD库的优势在于无需额外安装软件即可实现基础的图像处理需求。

一、什么是GD库？

        PHP中的GD库是一个开源的图像处理扩展库，它提供了一系列用于创建和操作图像的函数接口。这个库最初由Thomas Boutell开发，后来被整合到PHP中成为核心扩展之一。GD库采用C语言编写，能够高效地处理各种图形操作任务，包括图像生成、格式转换、特效处理等，目前支持PNG、JPEG、GIF、WBMP等多种主流图像格式。在Web开发领域，GD库是实现动态图像处理的关键技术组件，几乎所有需要服务器端图像处理的PHP应用都会依赖这个库。

        从技术架构来看，GD库本质上是一组面向过程的API函数集合，这些函数可以直接操作图像资源。当PHP脚本调用GD函数时，实际上是通过扩展模块调用底层C库的图形处理能力。这种设计使得GD库既保持了C语言的高性能，又能与PHP的脚本特性无缝结合。值得注意的是，不同PHP版本集成的GD库版本存在差异，例如PHP 5.4默认搭载GD 2.0，而PHP 7.0以上版本则支持更先进的GD 2.1特性。开发者可以通过gd_info()函数获取当前环境的GD库详细信息，包括支持的图像格式和功能特性。

        GD库在现代Web开发中具有不可替代的重要性。首先，它使得PHP具备了动态生成图像的能力，这是实现验证码、统计图表等功能的底层支撑。例如电商网站的商品缩略图、社交媒体的头像裁剪、内容管理系统的水印添加等常见需求，都需要依赖GD库的图像处理功能。其次，GD库提供了像素级的图像控制接口，开发者可以精确操作每个像素点的颜色值，这为特殊效果处理（如滤镜、马赛克等）创造了条件。更重要的是，GD库作为PHP的标准扩展，其稳定性和兼容性经过长期验证，相比第三方图像处理方案具有更好的部署便利性。

        在实际应用中，GD库的典型使用场景主要集中在三个领域。最基础的是图像生成，包括创建空白画布、绘制几何图形、添加文字等操作。例如生成动态验证码时，需要先创建图像资源，然后用随机函数绘制干扰线和验证码文本，最后输出到浏览器。其次是图像处理，这是GD库的核心价值所在，涵盖缩放、裁剪、旋转、合并等常见操作。比如制作缩略图时，通常会组合使用imagecopyresampled()和imagecrop()函数，在保持比例的同时确保关键内容可见。最后是格式转换，通过imagejpeg()、imagepng()等输出函数，可以实现不同图像格式之间的相互转换，这对优化网站资源加载速度很有帮助。

        从技术实现角度看，使用GD库处理图像通常遵循标准流程。首先要创建或加载图像资源，这个步骤根据来源不同可选择imagecreatetruecolor()创建空白图像，或使用imagecreatefromjpeg()等函数加载现有文件。接着进行图像处理操作，此时需要注意资源管理问题，特别是处理大尺寸图像时要及时释放不再需要的资源。最后通过输出函数保存或直接发送图像到客户端，这个阶段需要根据实际需求设置质量参数，如JPEG的压缩质量、PNG的压缩级别等。在整个过程中，正确的颜色管理和透明度处理尤为关键，需要合理使用imagealphablending()和imagesavealpha()等函数控制混合模式。

        GD库虽然功能强大，但在使用过程中也存在一些限制和注意事项。最显著的是内存消耗问题，处理高分辨率图像时可能占用大量内存，需要通过memory_limit配置适当调整。另外，不同版本对图像格式的支持存在差异，早期版本可能缺少WebP等现代格式的支持，需要开发者特别注意环境兼容性。性能方面，复杂的图像处理操作（如高斯模糊）可能产生较高CPU负载，在生产环境中需要考虑使用队列异步处理或缓存机制。值得注意的是，GD库某些函数在不同PHP版本中的行为可能发生变化，例如GIF支持就经历过移除又重新添加的过程，这要求开发者在跨版本部署时进行充分测试。

        随着Web技术的发展，GD库也在持续演进。最新版本的GD库增加了对WebP格式的支持，这显著提升了网络图像传输的效率。同时，现代PHP框架通常会对GD库进行面向对象的封装，提供更符合当前编程范式的接口，如Laravel的Intervention Image扩展。尽管出现了Imagick等替代方案，GD库凭借其轻量级特性和广泛的部署基础，仍然是PHP图像处理的首选方案。对于开发者而言，深入理解GD库的工作原理和最佳实践，仍然是构建高效图像处理应用的基础。

二、如何理解GD库？

我们可以打两个比喻，从下面2个角度去理解GD库的应用。

（一）GD库：神奇的数字画板

我们可以把GD库比作一个神奇的「数字画板」🧑‍🎨。想象一下你在手机上用绘图软件创作——选择画布尺寸、拿起画笔涂色、添加文字特效，最后保存成图片。GD库就是服务器端的这个创作工具包，只是它完全通过代码指令来操作‌。

graph LR
A[空白画布] --> B[绘制图形]
B --> C[添加文字]
C --> D[特效处理]
D --> E[输出图片]

🌈 核心功能比喻

‌1、画布 = 图像资源‌
imagecreatetruecolor(800,600) 就像领到一张800x600像素的空白画纸，等待创作。

2‌、画笔 = 绘图函数‌
imagefilledrectangle()是方形蜡笔🟦，imageellipse()是圆规⚪，imageline()则是直尺📏——这些都是你作图的工具。

‌3、调色盘 = 颜色管理‌
imagecolorallocate()如同调色盘，混合RGB数值（255,0,0=❤️鲜红）填充到图形中。

4‌、特效工具 = 图像处理‌

• 缩略图：像用缩小镜看画🔍

• 水印：如同盖章落款📌

• 旋转：好比旋转画架🔄

‌5、保存作品 = 输出格式‌
根据需求保存为不同“相框”：

• imagepng() → 高清玻璃框（无损）

• imagejpeg() → 便携塑料框（有损压缩）

• imagewebp() → 智能电子相框📱

（二）GD库：无所不能的图片加工厂

‌GD库就像一家「全能图片加工厂」🏭‌

1‌、原料车间（创建图像）‌

• imagecreatetruecolor()：领一块空白画布（纯白底）

• imagecreatefromjpeg()：进货现成的照片原料（像搬来整箱苹果）

2‌、加工流水线（图像处理）‌

• ‌裁剪工‌ imagecrop()：把照片切掉多余边角（像切掉苹果坏的部分）

• ‌缩放机‌ imagescale()：调整照片尺寸（像把大苹果压缩成小果盘）

• ‌旋转臂‌ imagerotate()：把歪斜的照片摆正（像扶正倒下的瓶子）

• ‌调色师‌ imagefilter()：给照片加滤镜（像给苹果打蜡增亮）

‌3、包装部门（输出成品）‌

• imagejpeg()：打包成通用快递箱（兼容所有设备）

• imagepng()：用高级保鲜盒包装（保留更多细节）

• imagewebp()：用真空压缩袋打包（体积最小）

‌4、特殊工种‌

• ‌水印印章‌ imagestring()：给照片盖版权章（像在苹果贴商标）

• ‌像素点焊工‌ imagesetpixel()：修复照片瑕疵（像补苹果表面的疤）

• ‌透视玻璃‌ imagealphablending()：做透明叠加效果（像把苹果放在玻璃板上拍照）

‌5、工厂特色‌

• ‌来料加工‌：不支持凭空造物（必须先有图像资源）

• ‌全手工操作‌：每个步骤都要写代码指令（没有图形按钮界面）

• ‌瞬时生产‌：图片生成完立刻清空流水线（需手动销毁资源）

三、GD库函数总体列表

以下是PHP GD库所有函数的完整列表（基于GD 2.3.3版本），按功能分类逐条列出，共7大类64个：

‌（一）图像信息获取‌

1. gd_info() - 获取当前GD库的安装信息

2. imagetypes() - 返回支持的图像类型（如IMG_PNG|IMG_JPG等）

3. getimagesize() - 获取图像尺寸及类型信息

4. imagesx() - 获取图像宽度

5. imagesy() - 获取图像高度

6. imageistruecolor() - 检查图像是否为真彩色

（二）图像创建与加载‌

1. imagecreate() - 创建基于调色板的图像

2. imagecreatetruecolor() - 创建真彩色图像

3. imagecreatefromgd() - 从GD格式文件创建图像

4. imagecreatefromgd2() - 从GD2格式文件创建图像

5. imagecreatefromgd2part() - 从GD2文件部分区域创建图像

6. imagecreatefromgif() - 从GIF文件创建图像

7. imagecreatefromjpeg() - 从JPEG文件创建图像

8. imagecreatefrompng() - 从PNG文件创建图像

9. imagecreatefromstring() - 从二进制字符串创建图像

10. imagecreatefromwbmp() - 从WBMP文件创建图像

11. imagecreatefromxbm() - 从XBM文件创建图像

12. imagecreatefromxpm() - 从XPM文件创建图像

13. imagecreatefromwebp() - 从WebP文件创建图像

（三）颜色与透明度‌

1. imagecolorallocate() - 分配颜色（RGB）

2. imagecolorallocatealpha() - 分配带透明度的颜色

3. imagecolordeallocate() - 释放颜色资源

4. imagecolortransparent() - 设置透明色

5. imagecolorat() - 获取某像素点的颜色索引

6. imagecolorsforindex() - 获取颜色索引的RGB值

7. imagecolorset() - 修改调色板中的颜色

8. imagecolorstotal() - 返回调色板中的颜色数

（四）绘图与文本‌

1. imageline() - 绘制直线

2. imagerectangle() - 绘制矩形

3. imagefilledrectangle() - 绘制实心矩形

4. imagepolygon() - 绘制多边形

5. imagefilledpolygon() - 绘制实心多边形

6. imagearc() - 绘制椭圆弧

7. imageellipse() - 绘制椭圆

8. imagefilledellipse() - 绘制实心椭圆

9. imagestring() - 绘制水平文本（内置字体）

10. imagestringup() - 绘制垂直文本（内置字体）

11. imagettftext() - 用TrueType字体绘制文本

12. imagechar() - 绘制单个水平字符

13. imagecharup() - 绘制单个垂直字符

（五）图像处理‌

1. imagecopy() - 复制图像部分区域

2. imagecopyresized() - 复制并调整大小（低质量）

3. imagecopyresampled() - 复制并调整大小（高质量）

4. imagescale() - 缩放图像

5. imagecrop() - 裁剪图像

6. imagecropauto() - 自动裁剪（如透明区域）

7. imagerotate() - 旋转图像

8. imageflip() - 翻转图像（水平/垂直）

9. imagefilter() - 应用滤镜（如模糊、灰度等）

10. imagesavealpha() - 保存PNG图像的Alpha通道

（六）图像输出‌

1. imagepng() - 输出PNG图像

2. imagejpeg() - 输出JPEG图像（可设质量）

3. imagegif() - 输出GIF图像

4. imagewbmp() - 输出WBMP图像

5. imagegd() - 输出GD格式图像

6. imagegd2() - 输出GD2格式图像

7. imagewebp() - 输出WebP图像

（七）其他功能‌

1. imagealphablending() - 设置混色模式

2. imageantialias() - 启用抗锯齿

3. imageinterlace() - 设置隔行扫描

4. imagesetthickness() - 设置线条宽度

5. imagesetpixel() - 绘制单个像素点

6. iptcembed() - 嵌入IPTC数据到JPEG

7. iptcparse() - 解析IPTC数据块

‌完整度说明‌

• 部分函数如imagefttext()（FreeType文本）需额外扩展支持

• WebP相关函数需GD库编译时启用WebP支持

• 实际可用函数可能因PHP版本和GD库编译选项而异

四、GD库图像信息获取类函数用法详解（6个）

1、gd_info() - 获取GD库安装信息

语法结构

array gd_info(void)

功能说明

该函数返回一个关联数组，包含当前安装的GD库的版本信息和功能支持情况15。

返回参数详解

返回的数组包含以下键值对：

• GD Version: GD库版本号(字符串)

• FreeType Support: 是否支持FreeType字体(布尔值)

• FreeType Linkage: FreeType链接方式(字符串)

• GIF Read Support: 是否支持读取GIF图像(布尔值)

• GIF Create Support: 是否支持创建GIF图像(布尔值)

• JPEG Support: 是否支持JPEG图像(布尔值)

• PNG Support: 是否支持PNG图像(布尔值)

• WBMP Support: 是否支持WBMP图像(布尔值)

• XPM Support: 是否支持XPM图像(布尔值)

• XBM Support: 是否支持XBM图像(布尔值)

• WebP Support: 是否支持WebP图像(布尔值)

• BMP Support: 是否支持BMP图像(布尔值)

• JIS-mapped Japanese Font Support: 是否支持JIS映射的日文字体(布尔值)

示例代码及解析

<?php
// 获取GD库信息
$gd_info = gd_info();
// 输出GD库版本
echo "GD版本: " . $gd_info['GD Version'] . "\n";
// 检查PNG支持
if ($gd_info['PNG Support']) {echo "支持PNG格式\n";
} else {echo "不支持PNG格式\n";
}
// 打印全部信息
print_r($gd_info);
?>

‌代码解析‌：

1. gd_info()调用返回一个包含GD库信息的数组

2. 通过数组键名访问特定信息，如GD Version获取版本号

3. 检查特定功能支持情况，如PNG Support判断PNG支持

4. print_r打印全部GD库信息

注意事项

• 使用前应确保GD库已安装并启用5

• 不同PHP版本返回的数组内容可能有所不同

• 某些功能可能依赖于系统库，如FreeType需要安装freetype库

2、imagetypes() - 返回支持的图像类型

语法结构

int imagetypes(void)

功能说明

返回当前GD库支持的图像格式的位掩码值，可以与以下常量进行按位与(&)操作来判断是否支持特定格式5：

• IMG_GIF: GIF格式

• IMG_JPG: JPEG格式

• IMG_PNG: PNG格式

• IMG_WBMP: WBMP格式

• IMG_WEBP: WebP格式

• IMG_BMP: BMP格式

• IMG_XPM: XPM格式

返回值

返回一个整数，表示支持的图像类型的位掩码组合。

示例代码及解析

<?php
// 获取支持的图像类型
$supported = imagetypes();
// 检查支持情况
if ($supported & IMG_PNG) {echo "支持PNG格式\n";
}
if ($supported & IMG_JPG) {echo "支持JPEG格式\n";
}
if ($supported & IMG_GIF) {echo "支持GIF格式\n";
}
// 输出所有支持的格式
echo "支持的格式: ";
$types = [];
if ($supported & IMG_GIF) $types[] = "GIF";
if ($supported & IMG_JPG) $types[] = "JPEG";
if ($supported & IMG_PNG) $types[] = "PNG";
if ($supported & IMG_WBMP) $types[] = "WBMP";
if ($supported & IMG_WEBP) $types[] = "WEBP";
if ($supported & IMG_BMP) $types[] = "BMP";
if ($supported & IMG_XPM) $types[] = "XPM";
echo implode(", ", $types);
?>

‌代码解析‌：

1. imagetypes()返回支持的图像类型位掩码

2. 使用按位与(&)操作检查特定格式支持

3. 构建数组收集所有支持的格式名称

4. 使用implode将数组转换为逗号分隔的字符串输出

注意事项

• 返回值是位掩码，需要使用按位操作判断支持情况

• 不同PHP版本支持的常量可能不同

• 实际支持情况还取决于GD库编译时的配置

3、getimagesize() - 获取图像尺寸及类型信息

语法结构

array|false getimagesize(string $filename, array &$image_info = null)

参数说明

• $filename: 要检查的图像文件名(字符串)

• $image_info: 可选参数，用于存储额外图像信息(数组引用)

返回值

成功时返回包含7个元素的数组，失败返回false。数组元素：

1. 图像宽度(像素)

2. 图像高度(像素)

3. 图像类型常量(IMAGETYPE_XXX)

4. 包含width/height属性的字符串，可直接用于HTML的<img>标签

5. 图像的MIME类型

6. 颜色通道数(3表示RGB, 4表示RGBA)

7. 位深度(每像素位数)

图像类型常量

• IMAGETYPE_GIF

• IMAGETYPE_JPEG

• IMAGETYPE_PNG

• IMAGETYPE_SWF

• IMAGETYPE_PSD

• IMAGETYPE_BMP

• IMAGETYPE_WBMP

• IMAGETYPE_XBM

• IMAGETYPE_WEBP

示例代码及解析

<?php
// 获取图像信息
$image_file = "example.jpg";
$size = getimagesize($image_file, $info);
if ($size === false) {die("无法获取图像信息");
}
// 输出基本信息
echo "宽度: " . $size[0] . "px\n";
echo "高度: " . $size[1] . "px\n";
echo "类型: " . image_type_to_extension($size[2]) . "\n";
echo "HTML属性: " . $size[3] . "\n";
echo "MIME类型: " . $size['mime'] . "\n";
// 输出额外信息(如果有)
if (!empty($info)) {echo "额外信息:\n";print_r($info);
}
// 使用list获取各个值
list($width, $height, $type, $attr) = getimagesize($image_file);
echo "使用list解构: $width x $height ($type)";
?>

‌代码解析‌：

1. 调用getimagesize()获取图像信息

2. 检查返回值是否为false(失败)

3. 访问数组元素获取各种信息

4. 使用image_type_to_extension()将类型常量转换为扩展名

5. 使用list()解构数组获取各个值

注意事项

• 文件必须存在且可读

• 支持本地文件和URL(如果allow_url_fopen启用)

• 对于非常大的图像可能消耗较多内存

• 某些图像格式可能无法正确识别

4、imagesx() - 获取图像宽度

语法结构

int imagesx(resource $image)

参数说明

• $image: 由图像创建函数(如imagecreatetruecolor)返回的图像资源

返回值

返回图像的宽度(像素)，失败时返回0。

示例代码及解析

<?php
// 创建图像资源
$width = 200;
$height = 100;
$image = imagecreatetruecolor($width, $height);
// 获取宽度
$image_width = imagesx($image);
echo "图像宽度: " . $image_width . "px\n";
// 与创建时的宽度比较
if ($image_width == $width) {echo "宽度匹配\n";
}
// 销毁资源
imagedestroy($image);
?>

‌代码解析‌：

1. 使用imagecreatetruecolor()创建图像资源

2. 使用imagesx()获取图像宽度

3. 验证获取的宽度是否与创建时一致

4. 使用imagedestroy()释放资源

注意事项

• 参数必须是有效的图像资源

• 对于空资源或无效资源返回0

• 通常与imagesy()一起使用获取完整尺寸

5、imagesy() - 获取图像高度

语法结构

int imagesy(resource $image)

参数说明

• $image: 由图像创建函数返回的图像资源

返回值

返回图像的高度(像素)，失败时返回0。

示例代码及解析

<?php
// 从文件创建图像资源
$filename = "example.png";
$image = imagecreatefrompng($filename);
// 获取高度
$image_height = imagesy($image);
echo "图像高度: " . $image_height . "px\n";
// 计算宽高比
$ratio = imagesx($image) / $image_height;
echo "宽高比: " . number_format($ratio, 2) . "\n";
// 销毁资源
imagedestroy($image);
?>

‌代码解析‌：

1. 使用imagecreatefrompng()从文件创建图像资源

2. 使用imagesy()获取图像高度

3. 结合imagesx()计算宽高比

4. 使用number_format()格式化输出

5. 使用imagedestroy()释放资源

注意事项

• 参数必须是有效的图像资源

• 对于空资源或无效资源返回0

• 通常与imagesx()配合使用

6、imageistruecolor() - 检查图像是否为真彩色

语法结构

bool imageistruecolor(resource $image)

参数说明

• $image: 由图像创建函数返回的图像资源

返回值

如果是真彩色图像返回true，否则返回false。

真彩色与调色板图像区别

• 真彩色图像: 每个像素直接存储RGB值(24位或32位)

• 调色板图像: 使用颜色索引表，每个像素存储索引值(通常8位)

示例代码及解析

<?php
// 创建真彩色图像
$truecolor = imagecreatetruecolor(100, 100);
// 创建调色板图像
$palette = imagecreate(100, 100);
// 检查图像类型
echo "真彩色图像: " . (imageistruecolor($truecolor) ? "是" : "否") . "\n";
echo "调色板图像: " . (imageistruecolor($palette) ? "是" : "否") . "\n";
// 转换图像类型
$converted = imagepalettetotruecolor($palette);
echo "转换后: " . (imageistruecolor($converted) ? "是" : "否") . "\n";
// 销毁资源
imagedestroy($truecolor);
imagedestroy($palette);
imagedestroy($converted);
?>

‌代码解析‌：

1. 使用imagecreatetruecolor()创建真彩色图像

2. 使用imagecreate()创建调色板图像

3. 使用imageistruecolor()检查图像类型

4. 使用imagepalettetotruecolor()转换图像类型

5. 再次检查转换后的图像类型

6. 释放所有图像资源

注意事项

• 真彩色图像支持更多颜色但占用更多内存

• 某些函数(如imagetruecolortopalette)需要特定类型图像

• 可以使用imagepalettetotruecolor()将调色板图像转换为真彩色

GD库中图像信息获取类的6个函数综合比较表

五、GD库图像创建与加载类函数用法详解（13个）

1、imagecreate() - 创建基于调色板的图像

语法结构

resource|false imagecreate(int $width, int $height)

参数说明

• $width: 图像宽度(像素)，必须大于0

• $height: 图像高度(像素)，必须大于0

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 创建200x100像素的调色板图像
$width = 200;
$height = 100;
$image = imagecreate($width, $height);
// 检查是否创建成功
if ($image === false) {die("无法创建图像资源");
}
// 分配背景色(红色)
$bg_color = imagecolorallocate($image, 255, 0, 0);
// 填充背景
imagefill($image, 0, 0, $bg_color);
// 输出图像
header('Content-Type: image/png');
imagepng($image);
// 释放资源
imagedestroy($image);
?>

‌代码解析‌：

1. imagecreate()创建调色板图像，指定宽高

2. 检查返回值是否为false(创建失败)

3. imagecolorallocate()分配颜色(红色)

4. imagefill()填充背景

5. 设置HTTP头并输出PNG图像

6. imagedestroy()释放资源

注意事项

• 调色板图像最多支持256色

• 第一个分配的颜色自动成为背景色

• 性能比真彩色图像好但色彩表现有限

2、imagecreatetruecolor() - 创建真彩色图像

语法结构

resource|false imagecreatetruecolor(int $width, int $height)

参数说明

• $width: 图像宽度(像素)，必须大于0

• $height: 图像高度(像素)，必须大于0

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 创建400x300的真彩色图像
$image = imagecreatetruecolor(400, 300);
// 创建渐变色背景
for ($y = 0; $y < 300; $y++) {$color = imagecolorallocate($image, 0, $y/300*255, 255-$y/300*255);imageline($image, 0, $y, 399, $y, $color);
}
// 添加文字
$text_color = imagecolorallocate($image, 255, 255, 255);
imagestring($image, 5, 150, 140, "TrueColor", $text_color);
// 输出
header('Content-Type: image/jpeg');
imagejpeg($image, null, 90);
// 释放
imagedestroy($image);
?>

‌代码解析‌：

1. 创建400x300真彩色图像

2. 使用循环创建垂直渐变背景

3. 添加白色文字

4. 输出JPEG图像(质量90)

5. 释放资源

注意事项

• 支持16.7百万色(24位)

• 默认背景为黑色

• 适合照片等高质量图像处理

3、imagecreatefromgd() - 从GD格式文件创建图像

语法结构

resource|false imagecreatefromgd(string $filename)

参数说明

• $filename: GD格式图像文件路径

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 从GD文件创建图像
$gd_file = "example.gd";
$image = imagecreatefromgd($gd_file);
if ($image === false) {die("无法加载GD文件");
}
// 获取图像信息
$width = imagesx($image);
$height = imagesy($image);
// 转换为PNG输出
header('Content-Type: image/png');
imagepng($image);
// 释放
imagedestroy($image);
?>

‌代码解析‌：

1. 从GD格式文件加载图像

2. 检查是否加载成功

3. 获取图像尺寸

4. 转换为PNG格式输出

5. 释放资源

注意事项

• GD格式是GD库的原始格式

• 现在很少使用，主要用于遗留系统

• 文件通常以.gd为扩展名

4、imagecreatefromgd2() - 从GD2格式文件创建图像

语法结构

resource|false imagecreatefromgd2(string $filename)

参数说明

• $filename: GD2格式图像文件路径

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 从GD2文件创建图像
$image = imagecreatefromgd2("texture.gd2");
if (!$image) {// 尝试创建新图像作为后备$image = imagecreatetruecolor(100, 100);$color = imagecolorallocate($image, 200, 200, 200);imagefill($image, 0, 0, $color);
}
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 尝试加载GD2文件

2. 如果失败则创建新的灰色图像

3. 输出PNG图像

4. 释放资源

注意事项

• GD2是GD格式的改进版

• 支持分块存储提高大图像处理效率

• 现代应用中也较少使用

5、imagecreatefromgd2part() - 从GD2文件部分区域创建图像

语法结构

resource|false imagecreatefromgd2part(string $filename, int $srcX, int $srcY, int $width, int $height
)

参数说明

• $filename: GD2格式图像文件路径

• $srcX: 源图像左上角x坐标

• $srcY: 源图像左上角y坐标

• $width: 要截取的宽度

• $height: 要截取的高度

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 从GD2文件截取100x100的区域(从50,50开始)
$image = imagecreatefromgd2part("large_image.gd2", 50, 50, 100, 100);
if ($image === false) {die("无法截取图像区域");
}
// 添加边框
$border_color = imagecolorallocate($image, 255, 0, 0);
imagerectangle($image, 0, 0, 99, 99, $border_color);
// 输出
header('Content-Type: image/jpeg');
imagejpeg($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 从GD2文件截取指定区域

2. 检查是否成功

3. 添加红色边框标记截取区域

4. 输出JPEG图像

5. 释放资源

注意事项

• 适用于处理大型GD2图像的部分区域

• 坐标和尺寸不能超出原图范围

• 必须先确保GD2文件有效

6、imagecreatefromgif() - 从GIF文件创建图像

语法结构

resource|false imagecreatefromgif(string $filename)

参数说明

• $filename: GIF图像文件路径

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 从GIF文件创建图像
$gif_file = "animation.gif";
$image = imagecreatefromgif($gif_file);
if (!$image) {die("无法加载GIF图像");
}
// 如果是动画GIF，只获取第一帧
// 转换为PNG输出
header('Content-Type: image/png');
imagepng($image);
// 获取图像尺寸
echo "宽度: " . imagesx($image) . "px, 高度: " . imagesy($image) . "px";
imagedestroy($image);
?>

‌代码解析‌：

1. 加载GIF文件

2. 检查是否成功

3. 输出PNG格式(只输出第一帧)

4. 获取并显示图像尺寸

5. 释放资源

注意事项

• 动画GIF只读取第一帧

• 某些GIF版本可能不支持

• 透明度信息会被保留

7、imagecreatefromjpeg() - 从JPEG文件创建图像

语法结构

resource|false imagecreatefromjpeg(string $filename)

参数说明

• $filename: JPEG图像文件路径

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 从JPEG创建图像(带错误处理)
try {$image = @imagecreatefromjpeg("photo.jpg");if ($image === false) {throw new Exception("无法加载JPEG图像");}// 添加水印$watermark_color = imagecolorallocatealpha($image, 255, 255, 255, 60);imagestring($image, 5, 10, 10, "SAMPLE", $watermark_color);// 输出高质量JPEGheader('Content-Type: image/jpeg');imagejpeg($image, null, 95);} catch (Exception $e) {// 创建错误替代图像$image = imagecreatetruecolor(400, 300);$bg = imagecolorallocate($image, 200, 200, 200);imagefill($image, 0, 0, $bg);$text_color = imagecolorallocate($image, 255, 0, 0);imagestring($image, 5, 150, 140, $e->getMessage(), $text_color);header('Content-Type: image/jpeg');imagejpeg($image);
} finally {if (isset($image)) {imagedestroy($image);}
}
?>

‌代码解析‌：

1. 使用错误抑制符@和try-catch处理错误

2. 加载JPEG图像

3. 添加半透明水印

4. 输出高质量JPEG

5. 出错时创建错误提示图像

6. 确保资源被释放

注意事项

• 支持渐进式JPEG

• 大图像可能消耗较多内存

• 建议使用错误处理机制

8、imagecreatefrompng() - 从PNG文件创建图像

语法结构

resource|false imagecreatefrompng(string $filename)

参数说明

• $filename: PNG图像文件路径

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 从PNG创建图像并保留透明度
$png_file = "transparent.png";
$image = imagecreatefrompng($png_file);
if ($image === false) {die("无法加载PNG图像");
}
// 确保保留透明度
imagealphablending($image, false);
imagesavealpha($image, true);
// 创建新图像并合并
$new_image = imagecreatetruecolor(imagesx($image), imagesy($image));
$white = imagecolorallocate($new_image, 255, 255, 255);
imagefill($new_image, 0, 0, $white);
imagecopy($new_image, $image, 0, 0, 0, 0, imagesx($image), imagesy($image));
// 输出
header('Content-Type: image/png');
imagepng($new_image);
// 释放
imagedestroy($image);
imagedestroy($new_image);
?>

‌代码解析‌：

1. 加载PNG图像

2. 设置保留透明度

3. 创建新白色背景图像

4. 合并原图(带透明度)到新图像

5. 输出PNG

6. 释放两个图像资源

注意事项

• 必须正确处理alpha通道

• imagesavealpha()是关键

• 适合处理带透明度的图形

9、imagecreatefromstring() - 从二进制字符串创建图像

语法结构

resource|false imagecreatefromstring(string $image_data)

参数说明

• $image_data: 包含图像数据的字符串

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 从Base64字符串创建图像
$base64_string = "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQAQMAAAAlPW0iAAAABlBMVEX///8AAABVwtN+AAAAE0lEQVR4XmP8z0A8YIKMYYKMAX4gBBcAMfQJiAAAAABJRU5ErkJggg==";
$binary_data = base64_decode($base64_string);
// 尝试从字符串创建图像
$image = imagecreatefromstring($binary_data);
if ($image === false) {die("无效的图像数据");
}
// 获取图像类型
$type = getimagesizefromstring($binary_data)[2];
$types = [IMAGETYPE_GIF => "GIF",IMAGETYPE_JPEG => "JPEG",IMAGETYPE_PNG => "PNG",IMAGETYPE_WEBP => "WEBP"
];
// 输出
header('Content-Type: image/' . strtolower($types[$type]));
switch ($type) {case IMAGETYPE_GIF: imagegif($image); break;case IMAGETYPE_JPEG: imagejpeg($image); break;case IMAGETYPE_PNG: imagepng($image); break;case IMAGETYPE_WEBP: imagewebp($image); break;
}
imagedestroy($image);
?>

‌代码解析‌：

1. 解码Base64图像数据

2. 从二进制字符串创建图像

3. 使用getimagesizefromstring()检测图像类型

4. 根据类型输出正确格式

5. 释放资源

注意事项

• 可以自动检测多种格式

• 适合处理数据库存储的图像

• 必须确保字符串是有效的图像数据

10、imagecreatefromwbmp() - 从WBMP文件创建图像

语法结构

resource|false imagecreatefromwbmp(string $filename)

参数说明

• $filename: WBMP图像文件路径

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 从WBMP创建图像(无线位图)
$wbmp_file = "graphic.wbmp";
$image = imagecreatefromwbmp($wbmp_file);
if ($image === false) {die("无法加载WBMP图像");
}
// 转换为PNG输出
header('Content-Type: image/png');
imagepng($image);
// 获取图像信息
$width = imagesx($image);
$height = imagesy($image);
$is_truecolor = imageistruecolor($image);
echo "尺寸: {$width}x{$height}, 类型: " . ($is_truecolor ? "真彩色" : "调色板");
imagedestroy($image);
?>

‌代码解析‌：

1. 加载WBMP文件

2. 检查是否成功

3. 转换为PNG输出

4. 获取并显示图像信息

5. 释放资源

注意事项

• WBMP是单色位图格式

• 主要用于移动设备

• 现代应用中较少使用

11、imagecreatefromxbm() - 从XBM文件创建图像

语法结构

resource|false imagecreatefromxbm(string $filename)

参数说明

• $filename: XBM图像文件路径

返回值

成功返回图像资源标识符，失败返回false。

示例代码及解析

<?php
// 从XBM创建图像(X BitMap)
$xbm_file = "icon.xbm";
$image = imagecreatefromxbm($xbm_file);
if ($image === false) {die("无法加载XBM图像");
}
// 分配颜色(反转颜色)
$bg = imagecolorallocate($image, 255, 255, 255);
$fg = imagecolorallocate($image, 0, 0, 0);
// 重新绘制图像
for ($y = 0; $y < imagesy($image); $y++) {for ($x = 0; $x < imagesx($image); $x++) {$color = imagecolorat($image, $x, $y);imagesetpixel($image, $x, $y, $color ? $bg : $fg);}
}
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 加载XBM文件

2. 检查是否成功

3. 分配黑白颜色

4. 反转XBM颜色(通常XBM是黑底白图)

5. 输出PNG图像

6. 释放资源

注意事项

• XBM是ASCII编码的位图格式

• 常用于X Window系统

• 本质上是C语言源代码

12、imagecreatefromxpm() - 从XPM文件创建图像

语法结构

resource|false imagecreatefromxpm(string $filename)

参数说明

• $filename: XPM图像文件路径

返回值

成功返回图像资源标识符，失败返回false。

XPM格式特点

XPM(X PixMap)是：

1. 基于ASCII文本的图像格式

2. 使用C语言语法定义

3. 支持颜色名称和透明度

4. 常用于Unix/Linux系统图标

示例代码及解析

<?php
// 检查XPM支持
if (!function_exists('imagecreatefromxpm')) {die("您的GD库不支持XPM格式");
}
// 从XPM文件创建图像
$xpm_file = "icon.xpm";
$image = imagecreatefromxpm($xpm_file);
if ($image === false) {// 创建替代图像$image = imagecreatetruecolor(64, 64);$bg = imagecolorallocate($image, 240, 240, 240);$text_color = imagecolorallocate($image, 200, 0, 0);imagefill($image, 0, 0, $bg);imagestring($image, 3, 10, 25, "XPM Load Failed", $text_color);
} else {// 添加边框$border_color = imagecolorallocate($image, 100, 100, 100);imagerectangle($image, 0, 0, imagesx($image)-1, imagesy($image)-1, $border_color);
}
// 输出PNG
header('Content-Type: image/png');
imagepng($image);
// 释放资源
imagedestroy($image);
?>

‌代码解析‌：

1. 首先检查XPM支持

2. 尝试加载XPM文件

3. 失败时创建错误提示图像

4. 成功时添加边框

5. 输出PNG格式

6. 释放资源

注意事项

• XPM文件本质是C源代码

• 需要GD库编译时启用XPM支持

• 文件通常有.xpm扩展名

• 适合处理小型图标类图像

13、imagecreatefromwebp() - 从WebP文件创建图像

语法结构

resource|false imagecreatefromwebp(string $filename)

参数说明

• $filename: WebP图像文件路径

返回值

成功返回图像资源标识符，失败返回false。

WebP格式特点

1. Google开发的现代图像格式

2. 支持有损和无损压缩

3. 支持透明度(alpha通道)

4. 通常比JPEG/PNG更小的文件大小

示例代码及解析

<?php
// 从WebP创建图像(带透明度处理)
$webp_file = "photo.webp";
$image = imagecreatefromwebp($webp_file);
if ($image === false) {die("无法加载WebP图像");
}
// 获取图像信息
$width = imagesx($image);
$height = imagesy($image);
$is_truecolor = imageistruecolor($image);
// 创建新图像并保留透明度
$new_image = imagecreatetruecolor($width, $height);
imagealphablending($new_image, false);
imagesavealpha($new_image, true);
// 填充透明背景
$transparent = imagecolorallocatealpha($new_image, 0, 0, 0, 127);
imagefill($new_image, 0, 0, $transparent);
// 合并图像
imagecopy($new_image, $image, 0, 0, 0, 0, $width, $height);
// 添加水印(半透明)
$watermark_color = imagecolorallocatealpha($new_image, 255, 255, 255, 60);
imagettftext($new_image, 20, 0, 10, 30, $watermark_color, 'arial.ttf', 'WATERMARK');
// 输出
header('Content-Type: image/webp');
imagewebp($new_image, null, 90); // 质量90
// 释放资源
imagedestroy($image);
imagedestroy($new_image);
?>

‌代码解析‌：

1. 加载WebP图像

2. 获取图像尺寸和类型信息

3. 创建新图像并设置alpha通道处理

4. 填充透明背景

5. 复制原图像到新图像

6. 添加半透明水印(使用TrueType字体)

7. 输出WebP格式(质量90)

8. 释放两个图像资源

注意事项

• 需要GD库2.1.0及以上版本

• 必须正确处理alpha通道

• 输出质量参数范围0-100

• 适合需要高压缩率的Web应用

GD库中图像创建与加载类13个函数综合比较表

通用注意事项

1. ‌资源管理‌：所有图像资源都应使用imagedestroy()释放

2. ‌错误处理‌：应检查每个函数返回值是否为false

3. ‌内存考虑‌：大图像会消耗大量内存

4. ‌格式支持‌：不同服务器GD库配置可能支持不同格式

5. ‌文件权限‌：确保PHP有权限读取源文件

6. ‌输出缓冲‌：输出图像前确保没有其他输出

六、GD库颜色与透明度类函数用法详解（8个）

1、imagecolorallocate() - 分配颜色(RGB)

语法结构

int|false imagecolorallocate(resource $image, int $red, int $green, int $blue)

参数说明

• $image: 图像资源

• $red: 红色分量(0-255)

• $green: 绿色分量(0-255)

• $blue: 蓝色分量(0-255)

返回值

成功返回颜色索引值，失败返回false。

示例代码及解析

<?php
// 创建200x200图像
$image = imagecreatetruecolor(200, 200);
// 分配三种颜色
$red = imagecolorallocate($image, 255, 0, 0);     // 纯红
$green = imagecolorallocate($image, 0, 255, 0);   // 纯绿
$blue = imagecolorallocate($image, 0, 0, 255);    // 纯蓝
// 绘制彩色条纹
for ($i = 0; $i < 200; $i++) {$color = $i < 70 ? $red : ($i < 140 ? $green : $blue);imageline($image, 0, $i, 199, $i, $color);
}
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建200x200真彩色图像

2. 分配红、绿、蓝三种颜色

3. 使用循环绘制三色条纹

4. 输出PNG图像

5. 释放资源

注意事项

• 调色板图像中第一个分配的颜色自动成为背景色

• 颜色索引只在当前图像资源中有效

• 真彩色图像支持更多颜色分配

2、imagecolorallocatealpha() - 分配带透明度的颜色

语法结构

int|false imagecolorallocatealpha(resource $image, int $red, int $green, int $blue, int $alpha
)

参数说明

• $image: 图像资源

• $red: 红色分量(0-255)

• $green: 绿色分量(0-255)

• $blue: 蓝色分量(0-255)

• $alpha: 透明度(0-127)，0完全不透明，127完全透明

返回值

成功返回颜色索引值，失败返回false。

示例代码及解析

<?php
// 创建透明背景图像
$image = imagecreatetruecolor(300, 200);
imagealphablending($image, false); // 关闭混合模式
imagesavealpha($image, true);      // 保存alpha通道
// 分配透明色和半透明色
$transparent = imagecolorallocatealpha($image, 0, 0, 0, 127); // 完全透明
$semi_blue = imagecolorallocatealpha($image, 0, 0, 255, 60);  // 半透明蓝
// 填充透明背景
imagefill($image, 0, 0, $transparent);
// 绘制半透明圆形
imagefilledellipse($image, 150, 100, 180, 180, $semi_blue);
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建真彩色图像并设置alpha处理

2. 分配完全透明和半透明蓝色

3. 填充透明背景

4. 绘制半透明圆形

5. 输出PNG(保留透明度)

6. 释放资源

注意事项

• 必须配合imagesavealpha()使用

• 仅适用于真彩色图像

• alpha值越大越透明

3、imagecolordeallocate() - 释放颜色资源

语法结构

bool imagecolordeallocate(resource $image, int $color)

参数说明

• $image: 图像资源

• $color: 要释放的颜色索引

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建图像
$image = imagecreate(100, 100);
// 分配多个颜色
$color1 = imagecolorallocate($image, 255, 0, 0);
$color2 = imagecolorallocate($image, 0, 255, 0);
$color3 = imagecolorallocate($image, 0, 0, 255);
// 使用颜色
imagefill($image, 0, 0, $color1);
// 释放不再需要的颜色
imagecolordeallocate($image, $color2);
imagecolordeallocate($image, $color3);
// 检查调色板颜色数
echo "调色板颜色数: " . imagecolorstotal($image) . "\n";
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建调色板图像

2. 分配三种颜色

3. 使用第一种颜色填充

4. 释放未使用的两种颜色

5. 检查调色板颜色数

6. 输出图像并释放资源

注意事项

• 主要用于调色板图像节省资源

• 真彩色图像通常不需要手动释放

• 不能释放正在使用的颜色

4、imagecolortransparent() - 设置透明色

语法结构

int imagecolortransparent(resource $image, int $color = -1)

参数说明

• $image: 图像资源

• $color: 要设置为透明的颜色索引(默认-1表示取消透明色)

返回值

返回当前的透明色索引，如果没有透明色则返回-1。

示例代码及解析

<?php
// 创建调色板图像
$image = imagecreate(200, 200);
// 分配颜色(第一个自动成为背景色)
$bg = imagecolorallocate($image, 255, 255, 255); // 白色背景
$red = imagecolorallocate($image, 255, 0, 0);
$green = imagecolorallocate($image, 0, 255, 0);
// 设置白色为透明色
imagecolortransparent($image, $bg);
// 绘制图形
imagefilledrectangle($image, 50, 50, 150, 150, $red);
imagefilledellipse($image, 100, 100, 80, 80, $green);
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建调色板图像

2. 分配颜色(白色自动成为背景)

3. 设置白色为透明色

4. 绘制红色矩形和绿色圆形

5. 输出PNG(背景透明)

6. 释放资源

注意事项

• 主要用于GIF等调色板图像

• 真彩色图像应使用alpha通道

• 只能设置一种颜色为透明

5、imagecolorat() - 获取某像素点的颜色索引

语法结构

int imagecolorat(resource $image, int $x, int $y)

参数说明

• $image: 图像资源

• $x: 像素点的x坐标

• $y: 像素点的y坐标

返回值

返回像素点的颜色索引值。

示例代码及解析

<?php
// 创建渐变图像
$image = imagecreatetruecolor(100, 100);
for ($y = 0; $y < 100; $y++) {for ($x = 0; $x < 100; $x++) {$color = imagecolorallocate($image, $x*2.55, $y*2.55, 0);imagesetpixel($image, $x, $y, $color);}
}
// 获取中心点颜色
$center_color = imagecolorat($image, 50, 50);
// 转换为RGB值
$rgb = imagecolorsforindex($image, $center_color);
echo "中心点颜色: R={$rgb['red']} G={$rgb['green']} B={$rgb['blue']}\n";
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建真彩色图像

2. 使用双重循环创建渐变效果

3. 获取中心点(50,50)颜色值

4. 转换为RGB数组并输出

5. 输出图像并释放资源

注意事项

• 对于真彩色图像，返回值包含RGB信息

• 需要配合imagecolorsforindex()解析颜色值

• 坐标必须在图像范围内

6、imagecolorsforindex() - 获取颜色索引的RGB值

语法结构

array imagecolorsforindex(resource $image, int $color)

参数说明

• $image: 图像资源

• $color: 颜色索引值

返回值

返回包含以下键的关联数组：

• red: 红色分量(0-255)

• green: 绿色分量(0-255)

• blue: 蓝色分量(0-255)

• alpha: 透明度(0-127)

示例代码及解析

<?php
// 创建图像并分配颜色
$image = imagecreatetruecolor(1, 1);
$purple = imagecolorallocate($image, 128, 0, 128);
imagesetpixel($image, 0, 0, $purple);
// 获取颜色信息
$pixel_color = imagecolorat($image, 0, 0);
$color_info = imagecolorsforindex($image, $pixel_color);
// 输出颜色信息
echo "颜色分解:\n";
echo "红色: {$color_info['red']}\n";
echo "绿色: {$color_info['green']}\n";
echo "蓝色: {$color_info['blue']}\n";
echo "透明度: {$color_info['alpha']}\n";
// 释放资源
imagedestroy($image);
?>

‌代码解析‌：

1. 创建1x1像素图像

2. 分配紫色并设置像素

3. 获取像素颜色值

4. 分解颜色分量并输出

5. 释放资源

注意事项

• 对于调色板图像，alpha值总是0

• 真彩色图像才能获取透明度信息

• 颜色索引必须有效

7、imagecolorset() - 修改调色板中的颜色

语法结构

void imagecolorset(resource $image, int $index, int $red, int $green, int $blue, int $alpha = 0
)

参数说明

• $image: 调色板图像资源

• $index: 要修改的颜色索引

• $red: 新的红色分量(0-255)

• $green: 新的绿色分量(0-255)

• $blue: 新的蓝色分量(0-255)

• $alpha: 新的透明度值(0-127)

返回值

无返回值。

示例代码及解析

<?php
// 创建调色板图像
$image = imagecreate(100, 100);
// 分配颜色
$bg = imagecolorallocate($image, 200, 200, 200);
$color1 = imagecolorallocate($image, 255, 0, 0);
// 填充背景
imagefill($image, 0, 0, $bg);
// 修改红色为绿色
imagecolorset($image, $color1, 0, 255, 0);
// 使用修改后的颜色
imagefilledrectangle($image, 20, 20, 80, 80, $color1);
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建调色板图像

2. 分配灰色背景和红色

3. 填充背景

4. 将红色修改为绿色

5. 绘制矩形(实际为绿色)

6. 输出图像并释放资源

注意事项

• 仅适用于调色板图像

• 修改立即影响所有使用该索引的像素

• 不能修改调色板大小

8、imagecolorstotal() - 返回调色板中的颜色数

语法结构

int imagecolorstotal(resource $image)

参数说明

• $image: 调色板图像资源

返回值

返回调色板中的颜色数量，真彩色图像返回0。

示例代码及解析

<?php
// 创建调色板图像
$palette_image = imagecreate(100, 100);
// 分配多个颜色
imagecolorallocate($palette_image, 255, 0, 0); // 索引0
imagecolorallocate($palette_image, 0, 255, 0); // 索引1
imagecolorallocate($palette_image, 0, 0, 255); // 索引2
// 创建真彩色图像对比
$truecolor_image = imagecreatetruecolor(100, 100);
// 获取颜色数
echo "调色板图像颜色数: " . imagecolorstotal($palette_image) . "\n";
echo "真彩色图像颜色数: " . imagecolorstotal($truecolor_image) . "\n";
// 释放资源
imagedestroy($palette_image);
imagedestroy($truecolor_image);
?>

‌代码解析‌：

1. 创建调色板图像并分配3种颜色

2. 创建真彩色图像作为对比

3. 分别获取两种图像的颜色数

4. 释放资源

注意事项

• 调色板图像最多256色

• 真彩色图像始终返回0

• 已释放的颜色不计入总数

GD库中颜色与透明度类8个函数综合比较表

七、GD库绘图与文本类函数用法详解（13个）

1、imageline() - 绘制直线

语法结构

bool imageline(resource $image, int $x1, int $y1, int $x2, int $y2, int $color
)

参数说明

• $image: 图像资源

• $x1: 起点x坐标

• $y1: 起点y坐标

• $x2: 终点x坐标

• $y2: 终点y坐标

• $color: 线条颜色索引

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建400x400图像
$image = imagecreatetruecolor(400, 400);
$white = imagecolorallocate($image, 255, 255, 255);
$red = imagecolorallocate($image, 255, 0, 0);
// 填充白色背景
imagefill($image, 0, 0, $white);
// 绘制十字线
imageline($image, 0, 200, 400, 200, $red);  // 水平线
imageline($image, 200, 0, 200, 400, $red);  // 垂直线
// 绘制对角线
imageline($image, 0, 0, 400, 400, $red);    // 主对角线
imageline($image, 400, 0, 0, 400, $red);    // 副对角线
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建400x400真彩色图像

2. 分配白色和红色

3. 填充白色背景

4. 绘制红色十字线(水平和垂直)

5. 绘制两条红色对角线

6. 输出PNG图像

7. 释放资源

注意事项

• 坐标超出图像范围会被自动裁剪

• 抗锯齿效果需要额外处理

• 线宽固定为1像素

2、imagerectangle() - 绘制矩形

语法结构

bool imagerectangle(resource $image, int $x1, int $y1, int $x2, int $y2, int $color
)

参数说明

• $image: 图像资源

• $x1: 左上角x坐标

• $y1: 左上角y坐标

• $x2: 右下角x坐标

• $y2: 右下角y坐标

• $color: 边框颜色索引

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建300x300图像
$image = imagecreatetruecolor(300, 300);
$white = imagecolorallocate($image, 255, 255, 255);
$blue = imagecolorallocate($image, 0, 0, 255);
// 填充白色背景
imagefill($image, 0, 0, $white);
// 绘制嵌套矩形
for ($i = 0; $i < 10; $i++) {$offset = $i * 15;imagerectangle($image, $offset, $offset, 300-$offset, 300-$offset, $blue);
}
// 输出
header('Content-Type: image/jpeg');
imagejpeg($image, null, 90);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建300x300图像

2. 分配白色和蓝色

3. 填充白色背景

4. 使用循环绘制10个嵌套蓝色矩形

5. 输出JPEG图像(质量90)

6. 释放资源

注意事项

• 矩形边框宽度固定为1像素

• (x1,y1)和(x2,y2)可以任意顺序指定

• 填充矩形应使用imagefilledrectangle()

3、imagefilledrectangle() - 绘制实心矩形

语法结构

bool imagefilledrectangle(resource $image, int $x1, int $y1, int $x2, int $y2, int $color
)

参数说明

参数同imagerectangle()

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建256x256图像(用于颜色渐变)
$image = imagecreatetruecolor(256, 256);
// 创建颜色渐变(红到绿)
for ($x = 0; $x < 256; $x++) {$color = imagecolorallocate($image, $x, 255-$x, 0);imagefilledrectangle($image, $x, 0, $x, 255, $color);
}
// 添加文字
$text_color = imagecolorallocate($image, 255, 255, 255);
imagestring($image, 5, 80, 120, "Color Gradient", $text_color);
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建256x256图像

2. 使用循环创建从左到右的红绿渐变

3. 每个垂直条1像素宽

4. 添加白色文字

5. 输出PNG图像

6. 释放资源

注意事项

• 比绘制多个像素点效率更高

• 适合创建色块和背景

• 可以用于快速填充大面积区域

4、imagepolygon() - 绘制多边形

语法结构

bool imagepolygon(resource $image, array $points, int $num_points, int $color
)

参数说明

• $image: 图像资源

• $points: 顶点坐标数组，格式为[x1,y1,x2,y2,...]

• $num_points: 顶点总数(必须≥3)

• $color: 边框颜色索引

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建400x400图像
$image = imagecreatetruecolor(400, 400);
$white = imagecolorallocate($image, 255, 255, 255);
$purple = imagecolorallocate($image, 128, 0, 128);
// 填充白色背景
imagefill($image, 0, 0, $white);
// 定义五边形顶点
$points = [200, 50,    // 顶点1350, 150,   // 顶点2300, 350,   // 顶点3100, 350,   // 顶点450, 150     // 顶点5
];
// 绘制紫色五边形
imagepolygon($image, $points, 5, $purple);
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建400x400图像

2. 分配白色和紫色

3. 填充白色背景

4. 定义五边形的5个顶点坐标

5. 绘制紫色五边形边框

6. 输出PNG图像

7. 释放资源

注意事项

• 顶点必须按顺序排列(顺时针或逆时针)

• 会自动闭合图形(连接首尾点)

• 填充多边形应使用imagefilledpolygon()

5、imagefilledpolygon() - 绘制实心多边形

语法结构

bool imagefilledpolygon(resource $image, array $points, int $num_points, int $color
)

参数说明

参数同imagepolygon()

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建500x500图像
$image = imagecreatetruecolor(500, 500);
$black = imagecolorallocate($image, 0, 0, 0);
$yellow = imagecolorallocate($image, 255, 255, 0);
// 填充黑色背景
imagefill($image, 0, 0, $black);
// 定义星形顶点(五角星)
$points = [250, 50,    // 顶点1294, 182,   // 顶点2430, 182,   // 顶点3318, 268,   // 顶点4360, 400,   // 顶点5250, 330,   // 顶点6140, 400,   // 顶点7182, 268,   // 顶点870, 182,    // 顶点9206, 182    // 顶点10
];
// 绘制黄色实心五角星
imagefilledpolygon($image, $points, 10, $yellow);
// 输出
header('Content-Type: image/jpeg');
imagejpeg($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建500x500图像

2. 分配黑色和黄色

3. 填充黑色背景

4. 定义五角星的10个顶点坐标

5. 绘制黄色实心五角星

6. 输出JPEG图像

7. 释放资源

注意事项

• 适合绘制复杂形状

• 奇偶填充规则决定重叠区域

• 顶点顺序影响填充效果

6、imagearc() - 绘制椭圆弧

语法结构

bool imagearc(resource $image, int $cx, int $cy, int $width, int $height, int $start, int $end, int $color
)

参数说明

• $image: 图像资源

• $cx: 中心点x坐标

• $cy: 中心点y坐标

• $width: 椭圆宽度

• $height: 椭圆高度

• $start: 起始角度(0-360)

• $end: 结束角度(0-360)

• $color: 弧线颜色索引

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建400x400图像
$image = imagecreatetruecolor(400, 400);
$white = imagecolorallocate($image, 255, 255, 255);
$colors = [imagecolorallocate($image, 255, 0, 0),imagecolorallocate($image, 0, 255, 0),imagecolorallocate($image, 0, 0, 255)
];
// 填充白色背景
imagefill($image, 0, 0, $white);
// 绘制彩色圆弧(类似饼图)
$start_angle = 0;
foreach ([60, 120, 180] as $i => $angle) {imagearc($image, 200, 200, 300, 300, $start_angle, $start_angle+$angle, $colors[$i]);$start_angle += $angle;
}
// 添加中心点
imagefilledellipse($image, 200, 200, 20, 20, $white);
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建400x400图像

2. 分配白色和红绿蓝三色

3. 填充白色背景

4. 绘制三个相连的彩色圆弧(60°,120°,180°)

5. 在中心添加白色小圆点

6. 输出PNG图像

7. 释放资源

注意事项

• 角度0表示3点钟方向

• 顺时针方向绘制

• 要画完整椭圆可设start=0,end=360

7、imageellipse() - 绘制椭圆

语法结构

bool imageellipse(resource $image, int $cx, int $cy, int $width, int $height, int $color
)

参数说明

• $image: 图像资源

• $cx: 中心点x坐标

• $cy: 中心点y坐标

• $width: 椭圆宽度

• $height: 椭圆高度

• $color: 边框颜色索引

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建500x300图像
$image = imagecreatetruecolor(500, 300);
$white = imagecolorallocate($image, 255, 255, 255);
$gray = imagecolorallocate($image, 128, 128, 128);
// 填充白色背景
imagefill($image, 0, 0, $white);
// 绘制同心椭圆
for ($i = 1; $i <= 5; $i++) {$size = $i * 50;imageellipse($image, 250, 150, $size+200, $size, $gray);
}
// 添加文字
imagestring($image, 5, 180, 280, "Ellipse Examples", $gray);
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建500x300图像

2. 分配白色和灰色

3. 填充白色背景

4. 绘制5个同心椭圆(逐渐增大)

5. 添加灰色文字

6. 输出PNG图像

7. 释放资源

注意事项

• width=height时为圆形

• 边框宽度固定为1像素

• 填充椭圆应使用imagefilledellipse()

8、imagefilledellipse() - 绘制实心椭圆

语法结构

bool imagefilledellipse(resource $image, int $cx, int $cy, int $width, int $height, int $color
)

参数说明

参数同imageellipse()

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建400x400图像
$image = imagecreatetruecolor(400, 400);
$black = imagecolorallocate($image, 0, 0, 0);
$colors = [imagecolorallocate($image, 255, 0, 0),imagecolorallocate($image, 0, 255, 0),imagecolorallocate($image, 0, 0, 255)
];
// 填充黑色背景
imagefill($image, 0, 0, $black);
// 绘制奥运五环
$positions = [[100, 100, 80],  // 蓝环[200, 100, 80],  // 黄环[300, 100, 80],  // 黑环[150, 170, 80],  // 绿环[250, 170, 80]   // 红环
];
foreach ($positions as $i => $pos) {imagefilledellipse($image, $pos[0], $pos[1], $pos[2], $pos[2], $colors[$i % 3]);
}
// 输出
header('Content-Type: image/jpeg');
imagejpeg($image, null, 95);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建400x400图像

2. 分配黑色和红绿蓝三色

3. 填充黑色背景

4. 定义五环位置和大小

5. 绘制彩色实心圆环(奥运五环样式)

6. 输出高质量JPEG

7. 释放资源

注意事项

• 适合绘制气泡、圆点等元素

• 比绘制多个像素点效率更高

• 抗锯齿效果需要额外处理

9、imagestring() - 绘制水平文本(内置字体)

语法结构

bool imagestring(resource $image, int $font, int $x, int $y, string $text, int $color
)

参数说明

• $image: 图像资源

• $font: 字体编号(1-5对应不同大小)

• $x: 文本左上角x坐标

• $y: 文本左上角y坐标

• $text: 要绘制的文本

• $color: 文本颜色索引

内置字体大小

• 1: 8x13像素

• 2: 6x13像素

• 3: 7x13像素(粗体)

• 4: 8x13像素(更大)

• 5: 9x15像素

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建400x200图像
$image = imagecreatetruecolor(400, 200);
$white = imagecolorallocate($image, 255, 255, 255);
$blue = imagecolorallocate($image, 0, 0, 255);
// 填充白色背景
imagefill($image, 0, 0, $white);
// 显示所有内置字体
$text = "Built-in Fonts";
$y = 20; // 起始Y坐标
for ($font = 1; $font <= 5; $font++) {// 使用5种不同的内置字体绘制文本imagestring($image, $font, 50, $y, "$font: $text", $blue);// 计算行高：当前字体高度 + 10像素间距$font_height = imagefontheight($font);$y += $font_height + 10;
}
// 绘制一段多行文本
$lines = ["This is the first line.","Second line with font 3","Third line using font 4"
];
$y = 120; // 新的起始Y坐标
foreach ($lines as $index => $line) {// 交替使用字体3、4、5$font = ($index % 3) + 3;// 绘制文本行imagestring($image, $font, 50, $y, $line, $blue);// 计算行高：当前字体高度 + 5像素间距$font_height = imagefontheight($font);$y += $font_height + 5;
}
// 添加版权信息到右下角
$copyright = "© " . date("Y") . " PHP GD Library";
$font_width = imagefontwidth(2);
$str_width = strlen($copyright) * $font_width;
$x_position = 400 - $str_width - 10; // 右边距10像素
imagestring($image, 2, $x_position, 180, $copyright, $blue);
// 输出PNG图像
header('Content-Type: image/png');
imagepng($image);
// 释放资源
imagedestroy($image);
?>

这个完整示例展示了如何：

1. 使用所有内置字体

2. 创建多行文本

3. 计算文本位置

4. 添加自动版权信息

5. 合理处理行间距

完整代码解析‌：

1. ‌图像初始化‌：

   • 创建400×200像素的真彩色图像资源

   • 分配白色和蓝色颜色资源

   • 填充整个图像背景为白色

2. ‌字体展示部分‌：

   • 定义文本内容"Built-in Fonts"

   • 使用循环展示5种内置字体(1-5)

   • $y变量控制每行的垂直位置

   • imagefontheight($font)获取每种字体的高度

   • 每行增加字体高度+10像素的间距

3. ‌多行文本绘制‌：

   • 定义三行文本内容

   • 交替使用字体3、4、5

   • foreach循环逐行绘制

   • 每行增加字体高度+5像素的间距

4. ‌版权信息‌：

   • 创建包含当前年份的版权文本

   • imagefontwidth(2)获取2号字体字符宽度

   • 计算文本总宽度：字符数×字符宽度

   • 计算右下角位置：图像宽度-文本宽度-右边距

   • 使用2号字体绘制版权信息

5. ‌输出与清理‌：

   • 设置Content-Type为image/png

   • 输出PNG格式图像

   • 销毁图像资源释放内存

注意事项：

1. ‌内置字体尺寸‌：

   • 1号：8×13像素

   • 2号：6×13像素

   • 3号：7×13像素(粗体)

   • 4号：8×13像素(更大)

   • 5号：9×15像素

2. ‌字体尺寸函数‌：

   • imagefontheight($font)：获取字体高度

   • imagefontwidth($font)：获取字符宽度

3. ‌文本位置计算‌：

   • 左上角定位：给定坐标是文本左上角位置

   • 垂直间距：建议使用字体高度+额外间距

   • 水平居中：(图像宽度 - 文本总宽度)/2

4. ‌局限性‌：

   • 不支持Unicode字符

   • 字体样式固定

   • 无法旋转文本

5. ‌性能考虑‌：

   • 比TrueType字体渲染更快

   • 适合简单标签和低资源环境

   • 多次调用效率高于单次长文本

10、imagestringup() - 绘制垂直文本（内置字体）

语法结构

bool imagestringup(resource $image, int $font, int $x, int $y, string $text, int $color
)

参数说明

• $image: 图像资源

• $font: 字体编号(1-5对应不同大小)

• $x: 文本左上角x坐标

• $y: 文本左上角y坐标

• $text: 要绘制的文本

• $color: 文本颜色索引

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建300x300图像
$image = imagecreatetruecolor(300, 300);
$white = imagecolorallocate($image, 255, 255, 255);
$purple = imagecolorallocate($image, 128, 0, 128);
// 填充白色背景
imagefill($image, 0, 0, $white);
// 绘制垂直文本标签
$labels = ['North', 'East', 'South', 'West'];
$positions = [[150, 50],  // 北[270, 150], // 东[150, 270], // 南[30, 150]   // 西
];
foreach ($positions as $i => $pos) {imagestringup($image, 4, $pos[0], $pos[1], $labels[$i], $purple);
}
// 添加中心点
imagefilledellipse($image, 150, 150, 20, 20, $purple);
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建300x300图像

2. 分配白色和紫色

3. 填充白色背景

4. 定义四个方向的标签位置

5. 使用4号字体绘制垂直文本

6. 在中心添加紫色圆点

7. 输出PNG图像

8. 释放资源

注意事项

• 文本从上往下垂直排列

• 适合创建图表标签和特殊效果

• 字体选择有限，不支持中文

11、imagettftext() - 用TrueType字体绘制文本

语法结构

array imagettftext(resource $image, float $size, float $angle, int $x, int $y, int $color, string $fontfile, string $text
)

参数说明

• $image: 图像资源

• $size: 字体大小(磅值)

• $angle: 文本角度(0-360度，0为水平)

• $x: 文本基线的x坐标

• $y: 文本基线的y坐标

• $color: 文本颜色索引

• $fontfile: TrueType字体文件路径

• $text: 要绘制的文本

返回值

返回包含8个元素的数组，表示文本边界框的四个角点坐标。

示例代码及解析

<?php
// 创建600x400图像
$image = imagecreatetruecolor(600, 400);
$white = imagecolorallocate($image, 255, 255, 255);
$black = imagecolorallocate($image, 0, 0, 0);
// 填充白色背景
imagefill($image, 0, 0, $white);
// 设置字体文件路径
$font = 'arial.ttf'; // 确保该字体文件存在
// 绘制各种角度的文本
$texts = [[30, "Welcome to PHP", 100, 100, 0],[24, "旋转的文字", 300, 150, 45],[20, "GD库功能强大", 200, 300, -15],[18, "图像处理示例", 500, 350, 90]
];
foreach ($texts as $item) {list($size, $text, $x, $y, $angle) = $item;imagettftext($image, $size, $angle, $x, $y, $black, $font, $text);
}
// 添加水印
$watermark = imagecolorallocatealpha($image, 128, 128, 128, 60);
imagettftext($image, 14, 0, 20, 390, $watermark, $font, "© 2023 GD Library Demo");
// 输出
header('Content-Type: image/jpeg');
imagejpeg($image, null, 95);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建600x400图像

2. 分配白色和黑色

3. 填充白色背景

4. 设置TrueType字体文件

5. 绘制不同大小、位置和角度的文本

6. 添加半透明灰色水印

7. 输出高质量JPEG

8. 释放资源

注意事项

• 字体文件路径可以是相对或绝对路径

• $x和$y是基线起点，不是左上角

• 支持UTF-8编码的多语言文本

• 需要FreeType库支持

12、imagechar() - 绘制单个水平字符

语法结构

bool imagechar(resource $image, int $font, int $x, int $y, string $char, int $color
)

参数说明

• $image: 图像资源

• $font: 字体编号(1-5)

• $x: 字符左上角x坐标

• $y: 字符左上角y坐标

• $char: 要绘制的单个字符

• $color: 字符颜色索引

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建400x200图像
$image = imagecreatetruecolor(400, 200);
$gray = imagecolorallocate($image, 200, 200, 200);
$dark_red = imagecolorallocate($image, 128, 0, 0);
// 填充灰色背景
imagefill($image, 0, 0, $gray);
// 绘制ASCII艺术字
$text = "PHP GD";
$char_width = imagefontwidth(5); // 9像素
$char_height = imagefontheight(5); // 15像素
$x_start = (400 - strlen($text) * $char_width) / 2;
$y_start = (200 - $char_height) / 2;
for ($i = 0; $i < strlen($text); $i++) {$x = $x_start + $i * $char_width;imagechar($image, 5, $x, $y_start, $text[$i], $dark_red);
}
// 添加装饰线
imageline($image, $x_start - 10, $y_start + 7, $x_start + strlen($text)*$char_width + 10, $y_start + 7, $dark_red);
// 输出
header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建400x200图像

2. 分配灰色和深红色

3. 填充灰色背景

4. 计算文本居中位置

5. 使用5号字体逐个字符绘制文本

6. 在文本下方添加装饰线

7. 输出PNG图像

8. 释放资源

注意事项

• 适合创建ASCII艺术效果

• 只能绘制单个字符

• 比绘制整个字符串更灵活

13、imagecharup() - 绘制单个垂直字符

语法结构

bool imagecharup(resource $image, int $font, int $x, int $y, string $char, int $color
)

参数说明

参数同imagechar()

返回值

成功返回true，失败返回false。

示例代码及解析

<?php
// 创建300x300图像
$image = imagecreatetruecolor(300, 300);
$light_blue = imagecolorallocate($image, 200, 230, 255);
$navy = imagecolorallocate($image, 0, 0, 128);
// 填充浅蓝色背景
imagefill($image, 0, 0, $light_blue);
// 绘制垂直条形码效果
$chars = '0123456789ABCDEF';
$x = 50;
for ($i = 0; $i < 15; $i++) {$char = $chars[rand(0, strlen($chars)-1)];$y = 50;for ($j = 0; $j < 8; $j++) {imagecharup($image, 3, $x, $y, $char, $navy);$y += imagefontheight(3) + 2;}$x += imagefontwidth(3) + 5;
}
// 添加标题
imagestring($image, 5, 100, 270, "Vertical Barcode", $navy);
// 输出
header('Content-Type: image/jpeg');
imagejpeg($image);
imagedestroy($image);
?>

‌代码解析‌：

1. 创建300x300图像

2. 分配浅蓝和深蓝色

3. 填充浅蓝色背景

4. 生成随机字符序列

5. 绘制8个垂直排列的字符组(模拟条形码)

6. 添加水平标题文本

7. 输出JPEG图像

8. 释放资源

注意事项

• 字符从上往下垂直排列

• 适合创建特殊视觉效果

• 比水平字符更节省水平空间

综合比较表：文本绘制函数

综合比较表：图形绘制函数

通用注意事项

1. ‌坐标系统‌：GD库使用左上角(0,0)坐标系

2. ‌颜色管理‌：确保颜色已分配后再使用

3. ‌资源释放‌：使用后及时调用imagedestroy()

4. ‌字体路径‌：使用TrueType字体时确保路径正确

5. ‌内存限制‌：大图像可能超出内存限制

6. ‌输出格式‌：输出前设置正确的Content-Type头

7. ‌错误处理‌：检查函数返回值避免静默失败

八、GD库图像处理类函数用法详解（10个）

1、imagecopy() - 复制图像部分区域

语法结构

bool imagecopy(resource $dst_im, resource $src_im, int $dst_x, int $dst_y, int $src_x, int $src_y, int $src_w, int $src_h
)

参数说明

示例代码及解析

<?php
// 创建目标图像(400x400)
$dst = imagecreatetruecolor(400, 400);
$white = imagecolorallocate($dst, 255, 255, 255);
imagefill($dst, 0, 0, $white);
// 加载源图像
$src = imagecreatefromjpeg('example.jpg'); // 假设是600x400的图像
// 复制中央区域(300x300)到目标图像中央
$src_w = 300;
$src_h = 300;
$src_x = (imagesx($src) - $src_w) / 2; // 水平居中
$src_y = (imagesy($src) - $src_h) / 2; // 垂直居中
imagecopy($dst, $src, 50, 50,        // 目标位置(50,50)$src_x, $src_y, // 源图起始点$src_w, $src_h  // 复制区域大小
);
// 输出
header('Content-Type: image/png');
imagepng($dst);
imagedestroy($dst);
imagedestroy($src);
?>

‌代码解析‌：

1. 创建400x400白色背景目标图像

2. 从JPEG文件加载源图像

3. 计算源图像中央300x300区域坐标

4. 将该区域复制到目标图像的(50,50)位置

5. 输出PNG格式结果

6. 销毁两个图像资源

注意事项

• 不执行缩放操作

• 适合精确区域复制

• 目标位置可以超出目标图像范围（会被裁剪）

2、imagecopyresized() - 复制并调整大小（低质量）

语法结构

bool imagecopyresized(resource $dst_im, resource $src_im, int $dst_x, int $dst_y, int $src_x, int $src_y, int $dst_w, int $dst_h, int $src_w, int $src_h
)

参数说明（新增）

示例代码及解析

<?php
// 创建目标图像(300x300)
$dst = imagecreatetruecolor(300, 300);
// 加载源图像(假设是600x400)
$src = imagecreatefrompng('source.png');
// 将整个源图像缩放到200x200放入目标图像
imagecopyresized($dst, $src,50, 50,       // 目标位置0, 0,         // 源图起点200, 200,     // 目标尺寸imagesx($src), imagesy($src) // 源图完整尺寸
);
// 添加缩略图边框
$black = imagecolorallocate($dst, 0, 0, 0);
imagerectangle($dst, 49, 49, 251, 251, $black);
// 输出
header('Content-Type: image/jpeg');
imagejpeg($dst);
imagedestroy($dst);
imagedestroy($src);
?>

‌代码解析‌：

1. 创建300x300目标图像

2. 从PNG加载源图像

3. 将完整源图像缩放到200x200

4. 放置在目标图像的(50,50)位置

5. 添加2像素黑色边框

6. 输出JPEG图像

注意事项

• 使用快速但低质量的算法

• 会产生锯齿和失真

• 适合不需要高质量的场景

3、imagecopyresampled() - 复制并调整大小（高质量）

语法结构

bool imagecopyresampled(resource $dst_image,resource $src_image,int $dst_x,int $dst_y,int $src_x,int $src_y,int $dst_w,int $dst_h,int $src_w,int $src_h
)

参数说明

• $dst_image：目标图像资源标识符

• $src_image：源图像资源标识符

• $dst_x/$dst_y：目标图像中的起始坐标(左上角)

• $src_x/$src_y：源图像中的起始坐标(左上角)

• $dst_w/$dst_h：目标区域的宽度和高度

• $src_w/$src_h：源图像中要复制的区域的宽度和高度

该函数会返回布尔值，成功时返回TRUE，失败时返回FALSE。

函数功能是将源图像的一部分复制到目标图像，并进行重新采样处理，特别适合用于生成缩略图等需要改变图像尺寸的场景。

示例代码及解析

<?php
// 创建高精度目标图像(800x600)
$dst = imagecreatetruecolor(800, 600);
// 加载小尺寸源图(200x150)
$src = imagecreatefromjpeg('small.jpg');
// 高质量放大4倍
imagecopyresampled($dst, $src,0, 0,        // 目标起点0, 0,        // 源图起点800, 600,    // 目标尺寸imagesx($src), imagesy($src) // 源图尺寸
);
// 保存高质量JPEG
imagejpeg($dst, 'enlarged.jpg', 95);
imagedestroy($dst);
imagedestroy($src);
echo "高质量放大图像已保存为enlarged.jpg";
?>

‌代码解析‌：

1. 创建800x600目标图像

2. 加载小尺寸JPEG源图

3. 使用resampled方法高质量放大

4. 保存为95质量的JPEG文件

5. 输出完成消息

与resized的区别

4、imagescale() - 缩放图像

语法结构

resource|false imagescale(resource $image, int $new_width, int $new_height = -1, int $mode = IMG_BILINEAR_FIXED
)

参数说明

缩放模式常量

• IMG_NEAREST_NEIGHBOUR: 最近邻插值

• IMG_BILINEAR_FIXED: 双线性插值

• IMG_BICUBIC: 双三次插值

• IMG_BICUBIC_FIXED: 快速双三次近似

示例代码及解析

<?php
// 加载原始图像
$src = imagecreatefrompng('original.png');
// 等比例缩放到宽度300
$scaled1 = imagescale($src, 300);
// 强制缩放到200x200
$scaled2 = imagescale($src, 200, 200);
// 高质量缩放到宽度500
$scaled3 = imagescale($src, 500, -1, IMG_BICUBIC);
// 保存结果
imagepng($scaled1, 'scaled_width.png');
imagepng($scaled2, 'scaled_square.jpg');
imagepng($scaled3, 'scaled_highquality.png');
// 释放资源
imagedestroy($src);
imagedestroy($scaled1);
imagedestroy($scaled2);
imagedestroy($scaled3);
?>

‌代码解析‌：

1. 加载原始PNG图像

2. 三种不同缩放方式：

   • 等比例宽度300

   • 强制200x200方形

   • 高质量宽度500

3. 分别保存结果

4. 清理所有资源

注意事项

• 返回新图像资源，不修改原图

• 默认保持宽高比

• PHP 5.5+版本支持

5、imagecrop() - 裁剪图像

语法结构

resource|false imagecrop(resource $image, array $rect
)

参数说明

裁剪区域数组

['x' => int, // 起点x'y' => int, // 起点y'width' => int, // 宽度'height' => int // 高度
]

示例代码及解析

<?php
// 加载全景图
$image = imagecreatefromjpeg('panorama.jpg');
// 定义中央区域(16:9比例)
$width = imagesx($image);
$height = imagesy($image);
$crop_height = $width * 9 / 16;
$rect = ['x' => 0,'y' => ($height - $crop_height) / 2,'width' => $width,'height' => $crop_height
];
// 执行裁剪
$cropped = imagecrop($image, $rect);
// 保存结果
imagejpeg($cropped, 'cropped_16_9.jpg', 90);
// 释放资源
imagedestroy($image);
imagedestroy($cropped);
?>

‌代码解析‌：

1. 加载全景图JPEG

2. 计算16:9比例的裁剪高度

3. 设置从水平中央裁剪的区域

4. 执行裁剪操作

5. 保存90质量JPEG

6. 清理资源

注意事项

• 返回新图像资源

• 裁剪区域不能超出原图范围

• PHP 5.5+版本支持

6、imagecropauto() - 自动裁剪

语法结构

resource|false imagecropauto(resource $image, int $mode = IMG_CROP_DEFAULT, float $threshold = 0.5, int $color = -1
)

裁剪模式常量

示例代码及解析

<?php
// 创建带透明背景的图像
$image = imagecreatetruecolor(500, 300);
$transparent = imagecolorallocatealpha($image, 0, 0, 0, 127);
$red = imagecolorallocate($image, 255, 0, 0);
imagefill($image, 0, 0, $transparent);
// 绘制非居中红色圆形
imagefilledellipse($image, 100, 100, 150, 150, $red);
// 自动裁剪透明区域
$cropped = imagecropauto($image, IMG_CROP_TRANSPARENT);
// 保存结果
imagesavealpha($cropped, true);
imagepng($cropped, 'auto_cropped.png');
// 释放资源
imagedestroy($image);
imagedestroy($cropped);
?>

‌代码解析‌：

1. 创建500x300透明背景图像

2. 在左上角绘制红色圆形

3. 自动裁剪掉透明区域

4. 保存PNG保留alpha通道

5. 清理资源

注意事项

• 对非透明图像使用IMG_CROP_BLACK/WHITE

• 阈值参数仅对IMG_CROP_THRESHOLD有效

• 可能需要多次尝试不同模式

7、imagerotate() - 旋转图像

语法结构

resource|false imagerotate(resource $image, float $angle, int $bgd_color, int $ignore_transparent = 0
)

参数说明

示例代码及解析

<?php
// 加载图像
$src = imagecreatefrompng('arrow.png');
// 旋转45度(红色背景)
$rotated = imagerotate($src, 45, imagecolorallocate($src, 255, 0, 0));
// 旋转30度(透明背景保持)
imagesavealpha($src, true);
$transparent = imagecolorallocatealpha($src, 0, 0, 0, 127);
$rotated_trans = imagerotate($src, 30, $transparent);
// 保存结果
imagepng($rotated, 'rotated_red.png');
imagepng($rotated_trans, 'rotated_trans.png');
// 释放资源
imagedestroy($src);
imagedestroy($rotated);
imagedestroy($rotated_trans);
?>

‌代码解析‌：

1. 加载PNG源图

2. 旋转45度用红色填充背景

3. 旋转30度保持透明背景

4. 分别保存两种结果

5. 清理所有资源

注意事项

• 角度为正数逆时针旋转

• 图像尺寸会改变以适应旋转

• 透明背景需要先设置imagesavealpha

8、imageflip() - 翻转图像

语法结构

bool imageflip(resource $image, int $mode
)

翻转模式常量

示例代码及解析

<?php
// 加载不对称图像
$image = imagecreatefromjpeg('asymmetrical.jpg');
// 创建三个副本
$hflip = imagecreatetruecolor(imagesx($image), imagesy($image));
$vflip = imagecreatetruecolor(imagesx($image), imagesy($image));
$bothflip = imagecreatetruecolor(imagesx($image), imagesy($image));
imagecopy($hflip, $image, 0, 0, 0, 0, imagesx($image), imagesy($image));
imagecopy($vflip, $image, 0, 0, 0, 0, imagesx($image), imagesy($image));
imagecopy($bothflip, $image, 0, 0, 0, 0, imagesx($image), imagesy($image));
// 执行不同翻转
imageflip($hflip, IMG_FLIP_HORIZONTAL);
imageflip($vflip, IMG_FLIP_VERTICAL);
imageflip($bothflip, IMG_FLIP_BOTH);
// 保存结果
imagejpeg($hflip, 'horizontal_flip.jpg');
imagejpeg($vflip, 'vertical_flip.jpg');
imagejpeg($bothflip, 'both_flip.jpg');
// 释放资源
imagedestroy($image);
imagedestroy($hflip);
imagedestroy($vflip);
imagedestroy($bothflip);
?>

‌代码解析‌：

1. 加载原始图像

2. 创建三个相同尺寸的副本

3. 分别执行水平、垂直和双向翻转

4. 保存所有结果

5. 清理资源

注意事项

• 直接修改原图资源

• 比手动复制像素效率高

• PHP 5.5+版本支持

9、imagefilter() - 应用滤镜

语法结构（完整参数）

bool imagefilter(resource $image, int $filtertype, [int $arg1], [int $arg2], [int $arg3], [int $arg4]
)

参数详解

支持的滤镜类型常量

完整示例代码

<?php
// 加载原始图像
$image = imagecreatefromjpeg('portrait.jpg');
// 创建滤镜演示网格(3x4)
$canvas = imagecreatetruecolor(imagesx($image)*3, imagesy($image)*4);
$white = imagecolorallocate($canvas, 255, 255, 255);
imagefill($canvas, 0, 0, $white);
// 定义所有滤镜及其参数
$filters = [['name' => 'Original', 'type' => null],['name' => 'Negate', 'type' => IMG_FILTER_NEGATE],['name' => 'Grayscale', 'type' => IMG_FILTER_GRAYSCALE],['name' => 'Brightness +50', 'type' => IMG_FILTER_BRIGHTNESS, 'args' => [50]],['name' => 'Contrast -30', 'type' => IMG_FILTER_CONTRAST, 'args' => [-30]],['name' => 'Colorize Blue', 'type' => IMG_FILTER_COLORIZE, 'args' => [0, 0, 255, 30]],['name' => 'Edge Detect', 'type' => IMG_FILTER_EDGEDETECT],['name' => 'Emboss', 'type' => IMG_FILTER_EMBOSS],['name' => 'Gaussian Blur', 'type' => IMG_FILTER_GAUSSIAN_BLUR],['name' => 'Mean Removal', 'type' => IMG_FILTER_MEAN_REMOVAL],['name' => 'Pixelate', 'type' => IMG_FILTER_PIXELATE, 'args' => [10, 1]],['name' => 'Smooth -5', 'type' => IMG_FILTER_SMOOTH, 'args' => [-5]]
];
// 应用滤镜并排列到网格
$cols = 3;
$index = 0;
foreach ($filters as $filter) {$col = $index % $cols;$row = floor($index / $cols);$x = $col * imagesx($image);$y = $row * imagesy($image);// 复制原始图像$copy = imagecreatetruecolor(imagesx($image), imagesy($image));imagecopy($copy, $image, 0, 0, 0, 0, imagesx($image), imagesy($image));// 应用滤镜if ($filter['type'] !== null) {$args = $filter['args'] ?? [];imagefilter($copy, $filter['type'], ...$args);}// 添加到画布imagecopy($canvas, $copy, $x, $y, 0, 0, imagesx($copy), imagesy($copy));// 添加标签$black = imagecolorallocate($canvas, 0, 0, 0);imagestring($canvas, 3, $x+10, $y+10, $filter['name'], $black);imagedestroy($copy);$index++;
}
// 输出结果
header('Content-Type: image/jpeg');
imagejpeg($canvas, null, 90);
// 释放资源
imagedestroy($image);
imagedestroy($canvas);
?>

‌代码解析‌：

1. 加载原始人像照片

2. 创建容纳12种滤镜效果的画布(3列×4行)

3. 定义包含所有滤镜类型的数组

4. 使用网格系统排列各种滤镜效果：

   • 第1列为原始图像

   • 第2-12列应用不同滤镜

5. 每个滤镜单元包含：

   • 图像副本

   • 滤镜应用

   • 文字标签

6. 输出高质量JPEG(90质量)

7. 清理所有图像资源

高级使用技巧

‌滤镜叠加‌：

// 先灰度化再浮雕
imagefilter($image, IMG_FILTER_GRAYSCALE);
imagefilter($image, IMG_FILTER_EMBOSS);

‌动态参数调节‌：

// 根据图像尺寸自动计算像素大小
$pixelSize = max(5, min(20, imagesx($image)/50));
imagefilter($image, IMG_FILTER_PIXELATE, $pixelSize, true);

‌选择性应用‌：

// 只对图像右半部分应用滤镜
$width = imagesx($image);
$cropped = imagecrop($image, ['x' => $width/2, 'y' => 0, 'width' => $width/2, 'height' => imagesy($image)]);
imagefilter($cropped, IMG_FILTER_COLORIZE, 100, 50, 0);
imagecopy($image, $cropped, $width/2, 0, 0, 0, $width/2, imagesy($image));

‌性能优化‌：

// 对缩略图应用滤镜更高效
$thumb = imagescale($image, 200);
imagefilter($thumb, IMG_FILTER_GAUSSIAN_BLUR);
$thumb = imagescale($thumb, imagesx($image), imagesy($image));

完整注意事项总结

1. ‌兼容性‌：

   • 部分滤镜需要GD库编译时支持

   • IMG_FILTER_PIXELATE需要PHP 5.3+

2. ‌资源消耗‌：

   • 高斯模糊最耗资源

   • 大图像建议先缩小处理

3. ‌透明度处理‌：

   • 多数滤镜会移除alpha通道

   • 处理透明图像需先保存alpha

4. ‌效果差异‌：

   • 不同GD版本效果可能不同

   • 建议实际测试验证

5. ‌错误处理‌：

   • 返回false表示失败

   • 可用imageistruecolor()检查兼容性

10、imagesavealpha() - 保存PNG图像的Alpha通道

语法结构

bool imagesavealpha(resource $image, bool $enable
)

参数说明

示例代码及解析

<?php
// 创建透明画布
$image = imagecreatetruecolor(400, 300);
imagealphablending($image, false); // 关闭混合模式
// 分配透明色(完全透明)
$transparent = imagecolorallocatealpha($image, 0, 0, 0, 127);
imagefill($image, 0, 0, $transparent);
// 绘制半透明圆形
$red = imagecolorallocatealpha($image, 255, 0, 0, 63);
imagefilledellipse($image, 200, 150, 200, 200, $red);
// 启用alpha通道保存
imagesavealpha($image, true);
// 输出PNG
header('Content-Type: image/png');
imagepng($image);
// 对比测试(不保存alpha)
/*
imagesavealpha($image, false);
imagepng($image, 'no_alpha.png');
*/
imagedestroy($image);
?>

‌代码解析‌：

1. 创建400x300真彩色图像

2. 关闭alpha混合以获得真实透明度

3. 分配完全透明背景色(alpha=127)

4. 绘制半透明红色圆形(alpha=63)

5. 启用alpha通道保存

6. 输出PNG图像

7. 注释部分展示不保存alpha的效果对比

关键注意事项

‌执行顺序‌：

• 必须在imagepng()之前调用

• 建议在绘制完成后调用

‌相关函数‌：

imagealphablending($image, false); // 必须关闭混合
imagesavealpha($image, true);      // 再启用保存

‌透明度级别‌：

• 0 = 不透明

• 127 = 完全透明

• 中间值 = 半透明

‌文件格式‌：

• 只对PNG格式有效

• JPEG不支持透明度

‌常见问题‌：

• 忘记关闭alphablending会导致透明度异常

• 多次调用以不同设置保存时需要注意状态

GD库中图像处理类10个函数综合比较表

关键维度对比说明

1. ‌质量与性能平衡‌

   • 优先选imagecopyresampled处理最终输出（高质量）1

   • 临时预览用imagecopyresized（速度快）1

2. ‌自动化能力‌

   • imagecropauto可智能去背景（如证件照白边消除）3

   • imagescale保持比例无需计算高度4

3. ‌特殊场景优化‌

   • 缩略图生成：imagescale + imagecrop组合5

   • 批量处理：禁用imagesavealpha提升速度（非透明图）1

4. ‌透明通道处理黄金步骤‌：

imagealphablending($img, false);  // 1.关闭混合模式
// ...绘制操作...
imagesavealpha($img, true);       // 2.启用通道保存
imagepng($img);                   // 3.输出PNG

注：实际选择需权衡质量需求（如印刷品选resampled）、实时性要求（如Web应用选resized）及功能特性（如透明处理必用imagesavealpha）。

九、GD库图像输出类函数用法详解（7个）

1、imagepng() - 输出PNG图像

语法结构

bool imagepng(resource $image, [mixed $to = null], [int $quality = -1], [int $filters = -1]
)

参数说明

示例代码

<?php
// 创建透明画布
$img = imagecreatetruecolor(300, 200);
$transparent = imagecolorallocatealpha($img, 0, 0, 0, 127);
imagefill($img, 0, 0, $transparent);
// 绘制半透明圆形
$red = imagecolorallocatealpha($img, 255, 0, 0, 63);
imagefilledellipse($img, 150, 100, 180, 180, $red);
// 输出PNG（启用alpha通道）
imagesavealpha($img, true);
imagepng($img, 'output.png', 6, PNG_FILTER_NONE); 
// 直接输出到浏览器
header('Content-Type: image/png');
imagepng($img, null, 9); // 最高质量
imagedestroy($img);
?>

‌代码解析‌：

1. 创建300x200透明画布（imagecolorallocatealpha设置透明度）

2. 绘制半透明红色圆形（alpha=63）

3. 保存为PNG文件（质量级别6，禁用过滤器）

4. 另输出到浏览器（质量级别9）

5. 必须调用imagesavealpha保持透明度

2、imagejpeg() - 输出JPEG图像

语法结构

bool imagejpeg(resource $image, [mixed $to = null], [int $quality = -1]
)

参数说明

示例代码

<?php
$img = imagecreatefrompng('source.png');
// 转换为JPEG背景
$bg = imagecreatetruecolor(imagesx($img), imagesy($img));
$white = imagecolorallocate($bg, 255, 255, 255);
imagefill($bg, 0, 0, $white);
imagecopy($bg, $img, 0, 0, 0, 0, imagesx($img), imagesy($img));
// 输出不同质量版本
imagejpeg($bg, 'high_quality.jpg', 90);  // 高质量
imagejpeg($bg, 'low_quality.jpg', 30);   // 低质量
imagedestroy($img);
?>

‌注意事项‌：

• JPEG不支持透明度，需手动填充背景

• 质量<60可能产生明显压缩伪影

• 默认输出Progressive JPEG（渐进式加载）

3、imagegif() - 输出GIF图像

语法结构

bool imagegif(resource $image, [mixed $to = null]
)

示例代码

<?php
// 创建动画GIF（多帧）
$frames = [];
for ($i = 0; $i < 5; $i++) {$frame = imagecreatetruecolor(100, 100);$color = imagecolorallocate($frame, rand(0,255), rand(0,255), rand(0,255));imagefill($frame, 0, 0, $color);$frames[] = $frame;
}
// 合并为GIF动画
$gif = new Imagick();
foreach ($frames as $frame) {$gif->addImage(new Imagick(imagegif($frame)));imagedestroy($frame);
}
$gif->writeImages('animation.gif', true);
?>

‌关键特性‌：

• 单帧GIF直接输出

• 多帧动画需配合Imagick扩展

• 仅支持256色索引颜色

4、imagewbmp() - 输出WBMP图像

语法结构

bool imagewbmp(resource $image, [mixed $to = null], [int $foreground = null]
)

参数说明

示例代码

<?php
$img = imagecreate(200, 200);
$white = imagecolorallocate($img, 255, 255, 255);
$black = imagecolorallocate($img, 0, 0, 0);
imagefilledrectangle($img, 50, 50, 150, 150, $black);
// 输出WBMP（黑白位图）
header('Content-Type: image/vnd.wap.wbmp');
imagewbmp($img, null, $black); // 显式指定前景色
imagedestroy($img);
?>

‌应用场景‌：

• 移动设备兼容图像

• 超低带宽传输

• 单色显示设备

5、imagegd() - 输出GD格式图像

语法结构

bool imagegd(resource $image, [mixed $to = null]
)

示例代码

<?php
$img = imagecreatefromjpeg('photo.jpg');
imagegd($img, 'output.gd'); // 保存为GD格式
$gd_data = file_get_contents('output.gd');
$reloaded = imagecreatefromstring($gd_data); // 重新加载
?>

‌格式特点‌：

• 无损原始数据

• 仅限PHP环境使用

• 文件体积大于PNG

6、imagegd2() - 输出GD2格式图像

语法结构

bool imagegd2(resource $image, [mixed $to = null], [int $chunk_size = 128], [int $type = IMG_GD2_RAW]
)

参数说明

示例代码

<?php
$img = imagecreatetruecolor(400, 300);
imagegd2($img, 'compressed.gd2', 64, IMG_GD2_COMPRESSED); // 分块压缩
?>

‌优化建议‌：

• 大图像使用分块（如512px）

• 网络传输用IMG_GD2_COMPRESSED

7、imagewebp() - 输出WebP图像

语法结构

bool imagewebp(resource $image, [mixed $to = null], [int $quality = 80]
)

示例代码

<?php
$img = imagecreatefrompng('transparent.png');
// 转换透明WebP
imagesavealpha($img, true);
imagewebp($img, 'output.webp', 85);
// 检测浏览器支持
if (strpos($_SERVER['HTTP_ACCEPT'], 'image/webp') !== false) {header('Content-Type: image/webp');imagewebp($img);
}
?>

‌现代Web优化‌：

• 平均比JPEG小25-35%

• 支持有损/无损压缩

• 透明度支持需PHP 7.0+

GD库中图像输出类7个函数综合比较表

关键特性补充说明

1. ‌压缩效率对比‌：

   • WebP > JPEG ≈ PNG > GIF > GD/GD2 > WBMP
   • WebP相比PNG平均节省26%体积，相比JPEG节省25-34%

2. ‌透明度实现差异‌：

   • PNG/WebP：支持半透明（Alpha混合）
   • GIF：仅支持完全透明/不透明
   • 其他格式：不支持透明度

3. ‌特殊功能支持‌：

   • 渐进式加载：JPEG/PNG/WebP支持
   • 分块处理：仅GD2格式原生支持
   • 元数据保留：PNG/JPEG/WebP支持EXIF等元数据

4. ‌PHP版本要求‌：

   • WebP支持需PHP 5.4+
   • 动画WebP需PHP 7.1+
   • GD2分块处理需PHP 4.3+

5. ‌内存消耗参考‌：

   真彩色图像 > 索引色图像
   PNG处理 > JPEG处理 > GIF处理
   分块GD2处理可降低大图内存占用
   

建议根据具体需求选择格式：需要透明选PNG/WebP，照片选JPEG/WebP，动画选GIF/WebP，内部处理选GD/GD2。

十、GD库其他功能类函数用法详解（7个）

1、imagealphablending() - 设置混色模式

语法结构

bool imagealphablending(resource $image, bool $blend_mode
)

参数说明

示例代码

<?php
// 创建透明画布
$img = imagecreatetruecolor(300, 200);
$transparent = imagecolorallocatealpha($img, 0, 0, 0, 127);
// 情况1：启用混色（默认）
imagealphablending($img, true);
imagefill($img, 0, 0, $transparent); // 实际显示灰色（混合背景）
// 情况2：禁用混色
imagealphablending($img, false);
imagefill($img, 0, 0, $transparent); // 显示完全透明
imagesavealpha($img, true);
imagepng($img, 'output.png');
?>

‌关键点解析‌：

• 第4行：混色模式下，透明色会与默认黑色背景混合

• 第8行：禁用后才能真正保留alpha通道数据

2、imageantialias() - 启用抗锯齿

语法结构

bool imageantialias(resource $image, bool $enabled
)

示例代码

<?php
$img = imagecreatetruecolor(400, 200);
$white = imagecolorallocate($img, 255, 255, 255);
imagefill($img, 0, 0, $white);
// 无抗锯齿
imageline($img, 50, 50, 350, 50, imagecolorallocate($img, 0, 0, 0));
// 启用抗锯齿
imageantialias($img, true);
imageline($img, 50, 150, 350, 150, imagecolorallocate($img, 0, 0, 0));
imagepng($img);
imagedestroy($img);
?>

‌效果对比‌：

• 第7行：产生锯齿明显的直线

• 第11行：生成平滑的消锯齿线条

3、imageinterlace() - 设置隔行扫描

语法结构

bool imageinterlace(resource $image, [int $interlace = 0]
)

参数说明

示例代码

<?php
$img = imagecreatefromjpeg('large_photo.jpg');
imageinterlace($img, 1); // 启用渐进式JPEG
imagejpeg($img, 'progressive.jpg', 85);
?>

‌浏览器表现‌：

• 普通JPEG：从上到下逐行加载

• 渐进式JPEG：先显示模糊全景再逐渐清晰

4、imagesetthickness() - 设置线条宽度

语法结构

bool imagesetthickness(resource $image, int $thickness
)

示例代码

<?php
$img = imagecreatetruecolor(300, 150);
$white = imagecolorallocate($img, 255, 255, 255);
imagefill($img, 0, 0, $white);
imagesetthickness($img, 1);
imagerectangle($img, 50, 30, 250, 70, imagecolorallocate($img, 255, 0, 0));
imagesetthickness($img, 5);
imagerectangle($img, 50, 80, 250, 120, imagecolorallocate($img, 0, 0, 255));
imagepng($img);
?>

‌注意事项‌：

• 仅影响imageline()、imagerectangle()等函数

• 不支持imagepolygon()的边线设置

5、imagesetpixel() - 绘制像素点

语法结构

bool imagesetpixel(resource $image, int $x, int $y, int $color
)

示例代码（生成随机噪点）

<?php
$img = imagecreatetruecolor(200, 200);
for ($i = 0; $i < 5000; $i++) {$x = rand(0, 199);$y = rand(0, 199);$color = imagecolorallocate($img, rand(0,255), rand(0,255), rand(0,255));imagesetpixel($img, $x, $y, $color);
}
imagepng($img, 'noise.png');
?>

‌性能优化‌：

• 批量操作建议使用imagefilledrectangle()替代

• 真彩色图像每个像素占4字节内存

6、iptcembed() - 嵌入IPTC数据

语法结构

mixed iptcembed(string $iptcdata, string $jpeg_file_name, [int $spool = 0]
)

IPTC标签示例

<?php
$iptc = ["2#120" => "这是图片描述","2#116" => "© 2025 Baidu","2#025" => ["关键词1", "关键词2"]
];
$data = "";
foreach ($iptc as $tag => $value) {$tag_parts = explode('#', $tag);$data .= iptc_maketag($tag_parts[0], $tag_parts[1], $value);
}
$jpg = imagecreatefromjpeg('photo.jpg');
imagejpeg($jpg, 'with_iptc.jpg'); // 必须先保存原始图像
iptcembed($data, 'with_iptc.jpg'); 
?>

‌常用标签代码‌：

• 2#005 文档标题

• 2#025 关键词

• 2#055 创建日期

• 2#080 作者

7、iptcparse() - 解析IPTC数据

语法结构

array iptcparse(string $iptcblock
)

示例代码

<?php
getimagesize('photo.jpg', $info);
if(isset($info['APP13'])) {$iptc = iptcparse($info['APP13']);echo "作者: ".$iptc['2#080'][0]."\n";print_r($iptc);
}
?>

‌输出结构‌：

Array
([2#080] => Array( [0] => "摄影师姓名" )[2#120] => Array( [0] => "图片描述文本" )
)

GD库中其他功能类7个函数综合比较表

‌建议‌：

处理透明图像时必须按顺序执行：

imagealphablending($img, false);
// ...绘图操作...
imagesavealpha($img, true);

抗锯齿对以下图形有效：

• 直线、矩形、椭圆

• 多边形（需配合imageantialias()）

IPTC数据最大限制为65535字节