Last updated: Mon, 29 Oct 2007

LXV. Image 图像函数

简介

PHP 不仅限于只产生 HTML 的输出。还可以创建及操作多种不同图像格式的图像文件，包括 gif，png，jpg，wbmp 和 xpm。更方便的是，PHP 可以直接将图像流输出到浏览器。要处理图像，需要在编译 PHP 时加上图像函数的 GD 库。GD 和 PHP 还可能需要其它的库，视乎需要支持哪些图像格式而定。

可以在 PHP 中使用图像函数来得到 JPEG，GIF，PNG，SWF，TIFF 和 JPEG2000 图像的大小。

注意: 阅读需求一节以了解怎样扩展图像能力来读取，写入和修改图像以及读取数码相机拍摄的照片中的元数据。

需求

如果有 GD 库（在 » http://www.libgd.org/），可以创建及操作图像。

所能处理的图像格式取决于所安装的 GD 版本，以及其它 GD 可能用到的来访问这些图像格式的库。低于 gd-1.6 版本的 GD 支持 GIF 图像格式，不支持 PNG，高于 gd-1.6 低于 gd-2.0.28 的版本支持 PNG，不支持 GIF。在 gd-2.0.28 中又重新支持 GIF 了。

注意: 自 PHP 4.3 起绑定了一个 GD 库的版本。这个绑定的版本具有一些附加的特色例如透明混色，应优先使用此版本，因为它的代码维护得更好以及更加稳定。

可能想要增加 GD 处理的图像格式。

表120.所支持的图像格式

图像格式	要下载的库	注解
`gif`		仅在低于 gd-1.6 与高于 gd-2.0.28 的 GD 版本中支持。PHP 4.3.0 以及绑定的 GD 库中支持只读的 GIF。PHP 4.3.9 和 PHP 5.0.1 起支持写入。
`jpeg-6b`	» ftp://ftp.uu.net/graphics/jpeg/
`png`	» http://www.libpng.org/pub/png/libpng.html	仅在高于 gd-1.6 的 GD 版本中支持。
`xpm`	» ftp://metalab.unc.edu/pub/Linux/libs/X/!INDEX.html	如果系统中安装了 X 环境，则很可能已经有了这个库。

可能想要增强 GD 处理不同字体的能力。支持下列字库：

表121.所支持的字库

字库	下载位置	注解
`FreeType 1.x`	» http://www.freetype.org/
`FreeType 2`	» http://www.freetype.org/
`T1lib`	» ftp://sunsite.unc.edu/pub/Linux/libs/graphics/)	支持 Type 1 字体。

如果 PHP 编译时指定了 --enable-exif，就可以操作存储于 JPEG 和 TIFF 图像文件头中的信息。这样就可以读取上面提到的数码相机生成的照片中的元数据。这些函数不需要 GD 库。

安装

要激活 GD 支持，配置 PHP 时加上 --with-gd[=DIR]，DIR 是 GD 的基本安装目录。要使用推荐的绑定的 GD 库版本（首次绑定于 PHP 4.3.0），使用 --with-gd。要编译 GD 库，需要libpng 和 libjpeg。

在 Windows 中，需要将 GD2 的 DLL 文件 php_gd2.dll 作为一个扩展包含在 php.ini 中。GD1 的 DLL 文件 php_gd.dll 在 PHP 4.3.2 中被删除了。此外要注意首选的真彩色图像函数，例如 imagecreatetruecolor()，需要 GD2。

注意: 要在 Windows 下启用 exif，在 php.ini 中 php_mbstring.dll 必须在 php_exif.dll 之前加载。

要在 PHP 3 中禁止 GD 支持，在配置时加上 --without-gd。

要增强 GD 的能力以处理更多的图像格式，在配置 PHP 时指定 --with-XXXX 的配置开关。

表122.所支持的图像格式

图像格式	配置开关
`jpeg-6b`	要激活 jpeg-6b 的支持，加上 `--with-jpeg-dir=DIR`.
`png`	要激活 png 的支持，加上 `--with-png-dir=DIR`。注意，libpng 需要 zlib library，因此配置中还要加上 `--with-zlib-dir[=DIR]`。
`xpm`	要激活 xpm 的支持，加上 `--with-xpm-dir=DIR`。如果配置时提示找不到所需要的库，可以加上到 X11 库的路径。

注意: 当把 PHP 和 libpng 一起编译时，必须使用和 GD 库连接的同一个版本。

要增强 GD 的能力以处理更多的字体，在配置 PHP 时指定 --with-XXXX 的配置开关。

表123.所支持的字库

字库	配置开关
`FreeType 1.x`	要激活 FreeType 1.x 的支持，加上 `--with-ttf[=DIR]`。
`FreeType 2`	要激活 FreeType 2 的支持，加上 `--with-freetype-dir=DIR`。
`T1lib`	要激活 T1lib（Type 1 字体），加上 `--with-t1lib[=DIR]`。
`本地 TrueType 字符串函数`	要激活本地 TrueType 字符串函数的支持，加上 `--enable-gd-native-ttf`。

运行时配置

没有 image 特定的配置选项。不过可以参考 exif 扩展库配置指令。

资源类型

本扩展模块未定义任何资源类型。

预定义常量

以下常量由本扩展模块定义，因此只有在本扩展模块被编译到 PHP 中，或者在运行时被动态加载后才有效。

IMG_GIF (integer)
IMG_JPG (integer)
IMG_JPEG (integer)
IMG_PNG (integer)
IMG_WBMP (integer)
IMG_XPM (integer)
IMG_COLOR_TILED (integer)
IMG_COLOR_STYLED (integer)
IMG_COLOR_BRUSHED (integer)
IMG_COLOR_STYLEDBRUSHED (integer)
IMG_COLOR_TRANSPARENT (integer)
IMG_ARC_ROUNDED (integer)
IMG_ARC_PIE (integer)
IMG_ARC_CHORD (integer)
IMG_ARC_NOFILL (integer)
IMG_ARC_EDGED (integer)
IMAGETYPE_GIF (integer)
IMAGETYPE_JPEG (integer)
IMAGETYPE_PNG (integer)
IMAGETYPE_SWF (integer)
IMAGETYPE_PSD (integer)
IMAGETYPE_BMP (integer)
IMAGETYPE_WBMP (integer)
IMAGETYPE_XBM (integer)
IMAGETYPE_TIFF_II (integer)
IMAGETYPE_TIFF_MM (integer)
IMAGETYPE_IFF (integer)
IMAGETYPE_JB2 (integer)
IMAGETYPE_JPC (integer)
IMAGETYPE_JP2 (integer)
IMAGETYPE_JPX (integer)
IMAGETYPE_SWC (integer)

范例

例905.用 PHP 创建 PNG 图像


<?php



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

$string = $_GET['text'];

$im   = imagecreatefrompng("images/button1.png");

$orange = imagecolorallocate($im, 220, 210, 60);

$px   = (imagesx($im) - 7.5 * strlen($string)) / 2;

imagestring($im, 3, $px, 9, $string, $orange);

imagepng($im);

imagedestroy($im);



?>

本例应该在一个具有类似：<img src="button.php?text=text"> 标记的页面中被调用。上述的 button.php 脚本会取得 "text" 字符串将其覆盖在原图上（本例中的 "images/button1.png"）并输出作为结果的图像。用此方法可以很方便地修改按钮上的文字从而避免了每次都要新画一个按钮的图像。用此方法就可以动态生成了。

gd_info 取得当前安装的 GD 库的信息
getimagesize 取得图像大小
image_type_to_extension 取得图像类型的文件后缀
image_type_to_mime_type 取得 getimagesize，exif_read_data，exif_thumbnail，exif_imagetype 所返回的图像类型的 MIME 类型
image2wbmp 以 WBMP 格式将图像输出到浏览器或文件
imagealphablending 设定图像的混色模式
imageantialias 是否使用抗锯齿（antialias）功能
imagearc 画椭圆弧
imagechar 水平地画一个字符
imagecharup 垂直地画一个字符
imagecolorallocate 为一幅图像分配颜色
imagecolorallocatealpha 为一幅图像分配颜色 + alpha
imagecolorat 取得某像素的颜色索引值
imagecolorclosest 取得与指定的颜色最接近的颜色的索引值
imagecolorclosestalpha 取得与指定的颜色加透明度最接近的颜色
imagecolorclosesthwb 取得与给定颜色最接近的色度的黑白色的索引
imagecolordeallocate 取消图像颜色的分配
imagecolorexact 取得指定颜色的索引值
imagecolorexactalpha 取得指定的颜色加透明度的索引值
imagecolormatch 使一个图像中调色板版本的颜色与真彩色版本更能匹配
imagecolorresolve 取得指定颜色的索引值或有可能得到的最接近的替代值
imagecolorresolvealpha 取得指定颜色 + alpha 的索引值或有可能得到的最接近的替代值
imagecolorset 给指定调色板索引设定颜色
imagecolorsforindex 取得某索引的颜色
imagecolorstotal 取得一幅图像的调色板中颜色的数目
imagecolortransparent 将某个颜色定义为透明色
imageconvolution 用系数 div 和 offset 申请一个 3x3 的卷积矩阵
imagecopy 拷贝图像的一部分
imagecopymerge 拷贝并合并图像的一部分
imagecopymergegray 用灰度拷贝并合并图像的一部分
imagecopyresampled 重采样拷贝部分图像并调整大小
imagecopyresized 拷贝部分图像并调整大小
imagecreate 新建一个基于调色板的图像
imagecreatefromgd2 从 GD2 文件或 URL 新建一图像
imagecreatefromgd2part 从给定的 GD2 文件或 URL 中的部分新建一图像
imagecreatefromgd 从 GD 文件或 URL 新建一图像
imagecreatefromgif 从 GIF 文件或 URL 新建一图像
imagecreatefromjpeg 从 JPEG 文件或 URL 新建一图像
imagecreatefrompng 从 PNG 文件或 URL 新建一图像
imagecreatefromstring 从字符串中的图像流新建一图像
imagecreatefromwbmp 从 WBMP 文件或 URL 新建一图像
imagecreatefromxbm 从 XBM 文件或 URL 新建一图像
imagecreatefromxpm 从 XPM 文件或 URL 新建一图像
imagecreatetruecolor 新建一个真彩色图像
imagedashedline 画一虚线
imagedestroy 销毁一图像
imageellipse 画一个椭圆
imagefill 区域填充
imagefilledarc 画一椭圆弧且填充
imagefilledellipse 画一椭圆并填充
imagefilledpolygon 画一多边形并填充
imagefilledrectangle 画一矩形并填充
imagefilltoborder 区域填充到指定颜色的边界为止
imagefilter 对图像使用过滤器
imagefontheight 取得字体高度
imagefontwidth 取得字体宽度
imageftbbox 给出一个使用 FreeType 2 字体的文本框
imagefttext 使用 FreeType 2 字体将文本写入图像
imagegammacorrect 对 GD 图像应用 gamma 修正
imagegd2 将 GD2 图像输出到浏览器或文件
imagegd 将 GD 图像输出到浏览器或文件
imagegif 以 GIF 格式将图像输出到浏览器或文件
imageinterlace 激活或禁止隔行扫描
imageistruecolor 检查图像是否为真彩色图像
imagejpeg 以 JPEG 格式将图像输出到浏览器或文件
imagelayereffect 设定 alpha 混色标志以使用绑定的 libgd 分层效果
imageline 画一条线段
imageloadfont 载入一新字体
imagepalettecopy 将调色板从一幅图像拷贝到另一幅
imagepng 以 PNG 格式将图像输出到浏览器或文件
imagepolygon 画一个多边形
imagepsbbox 给出一个使用 PostScript Type1 字体的文本方框
imagepsencodefont 改变字体中的字符编码矢量
imagepsextendfont 扩充或精简字体
imagepsfreefont 释放一个 PostScript Type 1 字体所占用的内存
imagepsloadfont 从文件中加载一个 PostScript Type 1 字体
imagepsslantfont 倾斜某字体
imagepstext 用 PostScript Type1 字体把文本字符串画在图像上
imagerectangle 画一个矩形
imagerotate 用给定角度旋转图像
imagesavealpha 设置标记以在保存 PNG 图像时保存完整的 alpha 通道信息（与单一透明色相反）
imagesetbrush 设定画线用的画笔图像
imagesetpixel 画一个单一像素
imagesetstyle 设定画线的风格
imagesetthickness 设定画线的宽度
imagesettile 设定用于填充的贴图
imagestring 水平地画一行字符串
imagestringup 垂直地画一行字符串
imagesx 取得图像宽度
imagesy 取得图像高度
imagetruecolortopalette 将真彩色图像转换为调色板图像
imagettfbbox 取得使用 TrueType 字体的文本的范围
imagettftext 用 TrueType 字体向图像写入文本
imagetypes 返回当前 PHP 版本所支持的图像类型
imagewbmp 以 WBMP 格式将图像输出到浏览器或文件
imagexbm 将 XBM 图像输出到浏览器或文件
iptcembed 将二进制 IPTC 数据嵌入到一幅 JPEG 图像中
iptcparse 将二进制 IPTC » http://www.iptc.org/ 块解析为单个标记
jpeg2wbmp 将 JPEG 图像文件转换为 WBMP 图像文件
png2wbmp 将 PNG 图像文件转换为 WBMP 图像文件

add a note User Contributed Notes
Image 图像函数

There are no user contributed notes for this page.

gd_info

iis_stop_service

Last updated: Mon, 29 Oct 2007