图形处理函数库

使用本功能需要在编译 PHP 前先安装 GD library，可到 http://www.boutell.com/gd 下载。在 1.6.2 版以前的 GD library 有支持 GIF 格式的功能，但因为 GIF 格式使用的 LZW 演算法牵涉到 Unisys 的专利权，因此在 GD library 1.6.2 版之后不支持 GIF 的格式。在安装 1.6.2 版时系统必须要有 libpng 及 zlib 二个动态链接函数库。前者可在 http://www.cdrom.com/pub/png 下载；后者可在 http://www.cdrom.com/pub/infozip/zlib 下载。而 GD library 也支持 TrueType 字型，请先到 http://www.freetype.org 下载动态链接程序库。 PHP 在 3.0.13 版之后，终于支持了 PNG 的图型格式，使用 PNG 就不怕会有版权的问题了，而且在 PHP 这个版本以后，安装编译时会检查 GD library 支持的是旧的 GIF 格式还是新的 PNG 格式来决定是否使用 GIF 或 PNG 的专用函数。 若真的需要使用 GD Library 中有关 GIF 的部份，不妨找较旧的 FreeBSD 或者 Linux 版本，里面可能会有这些函数，但可能会因为侵犯到 Unisys 的专利权，而引发法律问题。同时请注意旧版的 TTF 字型相关函数可能不能用。 以下是简单的例子 <?php Header ( "Content-type: image/gif" ); $im = imagecreate ( 400 , 30 ); $black = ImageColorAllocate ( $im , 0 , 0 , 0 ); $white = ImageColorAllocate ( $im , 255 , 255 , 255 ); imageline ( $im , 1 , 1 , 350 , 25 , $black ); imagearc ( $im , 200 , 15 , 20 , 20 , 35 , 190 , $white ); imagestring ( $im , 5 , 4 , 10 , "Graph TEST!!" , $white ); ImageGif ( $im ); ImageDestroy ( $im ); ?>

GetImageSize :	取得图片的长宽。
ImageArc :	画弧线。
ImageChar :	写出横向字符。
ImageCharUp :	写出直式字符。
ImageColorAllocate :	匹配颜色。
ImageColorTransparent :	指定透明背景色。
ImageCopyResized :	复制新图并调整大小。
ImageCreate :	建立新图。
ImageDashedLine :	绘虚线。
ImageDestroy :	结束图形。
ImageFill :	图形着色。
ImageFilledPolygon :	多边形区域着色。
ImageFilledRectangle :	矩形区域着色。
ImageFillToBorder :	指定颜色区域内着色。
ImageFontHeight :	取得字型的高度。
ImageFontWidth :	取得字型的宽度。
ImageInterlace :	使用交错式显示与否。
ImageLine :	绘实线。
ImageLoadFont :	载入点阵字型。
ImagePolygon :	绘多边形。
ImageRectangle :	绘矩形。
ImageSetPixel :	绘点。
ImageString :	绘横式字符串。
ImageStringUp :	绘直式字符串。
ImageSX :	取得图片的宽度。
ImageSY :	取得图片的高度。
ImageTTFBBox :	计算 TTF 文字所占区域。
ImageTTFText :	写 TTF 文字到图中。
ImageColorAt :	取得图中指定点颜色的索引值。
ImageColorClosest :	计算色表中与指定颜色最接近者。
ImageColorExact :	计算色表上指定颜色索引值。
ImageColorResolve :	计算色表上指定或最接近颜色的索引值。
ImageColorSet :	配置色表上指定索引的颜色。
ImageColorsForIndex :	取得色表上指定索引的颜色。
ImageColorsTotal :	计算图的颜色数。
ImagePSLoadFont :	载入 PostScript 字型。
ImagePSFreeFont :	卸下 PostScript 字型。
ImagePSEncodeFont :	PostScript 字型转成向量字。
ImagePSText :	写 PostScript 文字到图中。
ImagePSBBox :	计算 PostScript 文字所占区域。
ImageCreateFromPNG :	取出 PNG 图型。
ImagePNG :	建立 PNG 图型。
ImageCreateFromGIF :	取出 GIF 图型。
ImageGIF :	建立 GIF 图型。

GetImageSize
取得图片的长宽。
语法: array getimagesize(string filename, array [imageinfo]);
返回值: 数组
函数种类: 图形处理

内容说明: 本函数可用来取得 GIF、JPEG 及 PNG 三种 WWW 上图片的高与宽，不需要安装 GD library 就可以使用本函数。返回的数组有四个元素。返回数组的第一个元素 (索引值 0) 是图片的高度，单位是像素 (pixel)。第二个元素 (索引值 1) 是图片的宽度。第三个元素 (索引值 2) 是图片的文件格式，其值 1 为 GIF 格式、 2 为 JPEG/JPG 格式、3 为 PNG 格式。第四个元素 (索引值 3) 为图片的高与宽字符串，height=xxx width=yyy。可省略的参数 imageinfo 用来取得一些图片的相关信息，例如 IPTC (http://www.xe.net/iptc) 的 APP13 标记，就可以加在图片中，可利用 iptcparse() 来解析。

使用范例
<?php
function MyImg($imgfile) {
$size = GetImageSize($imgfile);
echo "<img src=\"$imgfile\" $size[3]>";
}
MyImg("img/img1.gif");
MyImg("img/img2.png");
?>

ImageArc
画弧线。
语法: int imagearc(int im, int cx, int cy, int w, int h, int s, int e, int col);
返回值: 整数
函数种类: 图形处理

内容说明: 本函数用来画弧线。原点坐标 (0,0) 为图片的左上角，参数 cx、cy 为椭圆心坐标，参数 w 为水平轴长，参数 h 为垂直轴长，参数 s 及 e 分别为起始角与结束角，参数 col 为弧线的颜色。参数 im 表示图形的 handle。

ImageCharUp
写出直式字符。
语法: int imagecharup(int im, int font, int x, int y, string c, int col);
返回值: 整数
函数种类: 图形处理

内容说明: 本函数用来书写直式的字符。原点坐标 (0,0) 为图片的左上角，参数 font 表示字体的大小，从最小的 1 起，参数 x、y 是写入字符的坐标值，参数 c 为欲写出的字符，参数 col 为字的颜色。参数 im 表示图形的 handle。
参考: ImageLoadFont()

ImageColorAllocate
匹配颜色。
语法: int imagecolorallocate(int im, int red, int green, int blue);
返回值: 整数
函数种类: 图形处理

内容说明: 本函数用来匹配图形的颜色，供其它绘图函数使用。参数 im 表示图形的 handle。参数 red、green、blue 是色彩三原色，其值从 0 至 255。

使用范例
<?
$white = ImageColorAllocate($im, 255,255,255);
$black = ImageColorAllocate($im, 0,0,0);
?>

ImageCopyResized
复制新图并调整大小。
语法: int imagecopyresized(int dst_im, int src_im, int dstX, int dstY, int srcX, int srcY, int dstW, int dstH, int srcW, int srcH);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数可复制新图，并重新调整图片的大小尺寸。参数都是目的在前，来源在后。参数 dst_im 及 src_im 为图片的 handle。参数 dstX、dstY、srcX、srcY 分别为目的及来源的坐标。参数 dstW、dstH、srcW、srcH 分别为来源及目的的宽及高，若欲调整新图的尺寸就在这儿配置。

ImageCopyResized
复制新图并调整大小。
语法: int imagecopyresized(int dst_im, int src_im, int dstX, int dstY, int srcX, int srcY, int dstW, int dstH, int srcW, int srcH);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数可复制新图，并重新调整图片的大小尺寸。参数都是目的在前，来源在后。参数 dst_im 及 src_im 为图片的 handle。参数 dstX、dstY、srcX、srcY 分别为目的及来源的坐标。参数 dstW、dstH、srcW、srcH 分别为来源及目的的宽及高，若欲调整新图的尺寸就在这儿配置。

ImageDashedLine
绘虚线。
语法: int imagedashedline(int im, int x1, int y1, int x2, int y2, int col);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数将在图形上画出一条虚线。从 x1、y1 连接到 x2、y2，原点 (0,0) 为图形的左上角。参数 col 为虚线的颜色。
参考: ImageLine()

ImageDestroy
结束图形。
语法: int imagedestroy(int im);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数将图片 handle 解构，释于内存空间。参数 im 为 ImageCreate() 所建立的图片 handle。

ImageFilledPolygon
多边形区域着色。
语法: int imagefilledpolygon(int im, array points, int num_points, int col);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数将图片的封闭多边形区域着色。参数 points 为数组，代表多边形区域，数组的偶数元素为 X 坐标，奇数元素为 Y 坐标，例如 points[0] = x0、points[1] = y0、points[2] = x1、points[3] = y1。参数 num_points 为多边形的转折点数目。参数 col 表示欲涂上的颜色。

ImageFilledRectangle
矩形区域着色。
语法: int imagefilledrectangle(int im, int x1, int y1, int x2, int y2, int col);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数将图片的封闭长方形区域着色。参数 x1、y1 及 x2、y2 分别为矩形对角线的坐标。参数 col 表示欲涂上的颜色。

ImageFillToBorder
指定颜色区域内着色。
语法: int imagefilltoborder(int im, int x, int y, int border, int col);
返回值: 整数
函数种类: 图形处理
内容说明
本函数将图片中指定的颜色做为边界，着色在其中的封闭区域之中。参数 x、y 为着色区内的坐标，原点 (0,0) 为图形的左上角。参数 border 为颜色值，表填入颜色的边界范围。参数 col 表示欲涂上的颜色。

ImageFontHeight
取得字型的高度。
语法: int imagefontheight(int font);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数用来取得指定字型的高度，单位为像素 (pixel)。
参考 ImageFontWidth() ImageLoadFont()

ImageFontWidth
取得字型的宽度。
语法: int imagefontwidth(int font);
返回值: 整数
函数种类: 图形处理
内容说明
本函数用来取得指定字型的宽度，单位为像素 (pixel)。
参考 ImageFontHeight() ImageLoadFont()

ImageInterlace
使用交错式显示与否。
语法: int imageinterlace(int im, int [interlace]);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数用来决定图片是否使用交错式显示 (interlace)。欲使用交错式显示，则将参数 interlace 值设为 1。不想使用交错式显示图形则将之设为 0。返回值 1 表示已配置成交错式、0 表示已设成非交错式。

ImageLine
绘实线。
语法: int imageline(int im, int x1, int y1, int x2, int y2, int col);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数将在图形上画出一条实线。从 x1、y1 连接到 x2、y2，原点 (0,0) 为图形的左上角。参数 col 为实线的颜色。
参考 ImageDashedLine()

ImageLoadFont
载入点阵字型。
语法: int imageloadfont(string file);
返回值: 整数
函数种类: 图形处理
内容说明
本函数用来载入用户自订的点阵字型。返回值为字型的代号，此值为大于 5 的整数。字型文件的格式如表

byte偏移	类型	说明
0-3	int	文件中字符的数目
4-7	int	字型的启始 ASCII 字符，例如从 ASCII 32 的空白开始
8-11	int	字符的宽度
12-15	int	字符的高度
16以后	char	字符的位值，也就是点阵的内容

参考 ImageFontHeight() ImageFontWidth()

ImagePolygon
绘多边形。
语法: int imagepolygon(int im, array points, int num_points, int col);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数可在图片上绘出多边形。参数 points 为数组，代表多边形区域，数组的偶数元素为 X 坐标，奇数元素为 Y 坐标，例如 points[0] = x0、points[1] = y0、points[2] = x1、points[3] = y1。参数 num_points 为多边形的转折点数目。参数 col 表示多边形线的颜色。

ImageRectangle
绘矩形。
语法: int imagerectangle(int im, int x1, int y1, int x2, int y2, int col);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数可在图片上绘出长方形。参数 x1、y1 及 x2、y2 分别为矩形对角线的坐标。参数 col 表示矩形边框的颜色。

ImageSetPixel
绘点。
语法: int imagesetpixel(int im, int x, int y, int col);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数可在图片上绘出一点。参数 x、y 为欲绘点的坐标，参数 col 表示该点的颜色。

ImageString
绘横式字符串。
语法: int imagestring(int im, int font, int x, int y, string s, int col);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数在图片上绘出水平的横式字符串。参数 font 为字形，设为 1 到 5 表示使用默认字形。参数 x、y 为字符串起点坐标。字符串的内容放在参数 s 上。参数 col 表示字符串的颜色。
参考 ImageLoadFont()

ImageStringUp
绘直式字符串。
语法: int imagestringup(int im, int font, int x, int y, string s, int col);
返回值: 整数
函数种类: 图形处理
内容说明
本函数在图片上绘出铅直的直式字符串。参数 font 为字形，设为 1 到 5 表示使用默认字形。参数 x、y 为字符串起点坐标。字符串的内容放在参数 s 上。参数 col 表示字符串的颜色。
参考 ImageLoadFont()

ImageSX
取得图片的宽度。
语法: int imagesx(int im);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数用来取得图片的宽度数值。

ImageSY
取得图片的高度。
语法: int imagesy(int im);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数用来取得图片的高度数值。

ImageTTFBBox
计算 TTF 文字所占区域。
语法: array ImageTTFBBox(int size, int angle, string fontfile, string text);
返回值: 数组
函数种类: 图形处理
内容说明: 本函数用来计算并返回 TTF 文字区域框 (bounding box) 大小。参数 size 为字形的尺寸；angle 为字型的角度；fontfile 为字型文件名称，亦可是远端的文件；text 当然就是字符串内容了。返回值为数组，包括了八个元素，头二个分别为左下的 x、y 坐标，第三、四个为右下角的 x、y 坐标，第五、六及七、八二组分别为右上及左上的 x、y 坐标。治募?注意的是欲使用本函数，系统要装妥 GD 及 Freetype 二个函数库。

ImageTTFText
写 TTF 文字到图中。
语法: array ImageTTFText(int im, int size, int angle, int x, int y, int col, string fontfile, string text);
返回值: 数组
函数种类: 图形处理
内容说明: 本函数将 TTF (TrueType Fonts) 字型文字写入图片。参数 size 为字形的尺寸；angle 为字型的角度，顺时针计算，0 度为水平，也就是三点钟的方向 (由左到右)，90 度则为由下到上的文字；x,y 二参数为文字的坐标值 (原点为左上角)；参数 col 为字的颜色；fontfile 为字型文件名称，亦可是远端的文件；text 当然就是字符串内容了。返回值为数组，包括了八个元素，头二个分别为左下的 x、y 坐标，第三、四个为右下角的 x、y 坐标，第五、六及七、八二组分别为右上及左上的 x、y 坐标。治募?注意的是欲使用本函数，系统要装妥 GD 及 Freetype 二个函数库。
使用范例
本例建立一个 400x30 pixel 大小的黑底图，并用 Arial 向量字体写出 I am NUMBER ONE !! 的白字。
<?php
Header("Content-type: image/gif");
$im = imagecreate(400,30);
$black = ImageColorAllocate($im, 0,0,0);
$white = ImageColorAllocate($im, 255,255,255);
ImageTTFText($im, 20, 0, 10, 20, $white, "/somewhere/arial.ttf", "I am NUMBER ONE !!");
ImageGif($im);
ImageDestroy($im);
?>
参考 ImageTTFBBox()

ImageColorAt
取得图中指定点颜色的索引值。
语法: int imagecolorat(int im, int x, int y);
返回值: 整数
函数种类: 图形处理
内容说明
本函数可取得图形中某指定点的颜色索引值 (index)。
参考 ImageColorSet() ImageColorsForIndex()

ImageColorClosest
计算色表中与指定颜色最接近者
语法: int imagecolorclosest(int im, int red, int green, int blue);
返回值: 整数
函数种类: 图形处理
内容说明
本函数用来计算调色盘中与指定 RGB 颜色最接近的颜色。参数 red、green、blue 分别为红、绿、蓝三原色，也就是所谓的 RGB 值。
参考 ImageColorExact()

ImageColorExact
计算色表上指定颜色索引值。
语法: int imagecolorexact(int im, int red, int green, int blue);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数用来计算调色盘中指定 RGB 颜色的色素索引值。参数 red、green、blue 分别为红、绿、蓝三原色，也就是所谓的 RGB 值。若调色盘中没有指定的颜色，则返回 -1。
参考 ImageColorClosest()

ImageColorResolve
计算色表上指定或最接近颜色的索引值。
语法: int imagecolorresolve(int im, int red, int green, int blue);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数用来计算调色盘中指定 RGB 颜色的色素索引值。参数 red、green、blue 分别为红、绿、蓝三原色，也就是所谓的 RGB 值。若无指定颜色则取得最接近的颜色。无论如何本函数都会有索引值返回。
参考 ImageColorClosest() ImageColorExact()

ImageColorSet
配置色表上指定索引的颜色。
语法: boolean imagecolorset(int im, int index, int red, int green, int blue);
返回值: 布尔值
函数种类: 图形处理
内容说明: 本函数用来配置调色盘上指定索引的颜色值。参数 index 为索引值。参数 red、green、blue 分别为红、绿、蓝三原色，也就是所谓的 RGB 值。此函数适合将图片上某颜色改掉，即利用索引的颜色更改图片颜色。
参考 ImageColorAt()

ImageColorsForIndex
取得色表上指定索引的颜色。
语法: array imagecolorsforindex(int im, int index);
返回值: 数组
函数种类: 图形处理
内容说明: 本函数用来取得调色盘上指定索引的颜色值。参数 index 为索引值。数组返回值分别为红、绿、蓝三原色的值。
参考 ImageColorAt() ImageColorSet()

ImageColorsTotal
计算图的颜色数。
语法: int imagecolorstotal(int im);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数用来计算图片的调色盘有几种不同的颜色。
参考 ImageColorAt() ImageColorsForIndex()

ImagePSLoadFont
载入 PostScript 字型。
语法: int imagepsloadfont(string filename);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数用来载入 PostScript Type1 字型。参数 filename 为 PostScript Type1 字型的名称。
参考 ImagePSFreeFont()

ImagePSFreeFont
卸下 PostScript 字型。
语法: void imagepsfreefont(int fontindex);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数将已载入 PostScript Type1 字型卸下。参数 fontindex 为载入 PostScript Type1 字型的 handle。
参考 ImagePSLoadFont()

ImagePSEncodeFont
PostScript 字型转成向量字。
语法: int imagepsencodefont(string encodingfile);
返回值: 整数
函数种类: 图形处理
内容说明: 本函数将 PostScript Type1 字型转换成向量字。若需要西方语衔募?特殊文字则要 T1lib 函数库。目前 T1lib 提供 IsoLatin1.enc 和 IsoLatin2.enc 二套字。若常要使用向量字，可以在 php3.ini/php.ini 中配置 ps.default_encoding，PHP 系统会自动载入转换。
参考 ImagePSLoadFont()

ImagePSText
写 PostScript 文字到图中。
语法: array imagepstext(int image, string text, int font, int size, int foreground, int background, int x, int y, int space, int tightness, float angle, int antialias_steps);
返回值: 数组
函数种类: 图形处理
内容说明
本函数将 PostScript Type1 字型文字写入图片。参数 image 为图形。text 参数为要写入的字符串。参数 font 则为指定的字型。参数 size 为字的大小，单位为像素 (pixel)。参数 foreground 及 background 分别为前景及背景色，程序会依这二色来修正文字边晕募?锯齿。参数 x,y 为文字的坐标，以左下角开始计算。space 参数为文字间的空隔大小。参数 tightness 为单字间的紧密度。angle 为角度。最后一个参数 antialias_steps 为边缘锯齿状修正的等级，范围为 4 至 16。返回数组有四个元素，第一、二个分别为左下角的 x,y 值，第三、四个元素为右上角的 x,y 值。
参考 ImagePSBBox()

ImagePSBBox
计算 PostScript 文字所占区域。
语法: array imagepsbbox(string text, int font, int size, int space, int width, float angle);
返回值: 数组
函数种类: 图形处理
内容说明: 本函数用来计算并返回 PostScript 文字区域框 (bounding box) 大小。参数 text 为要写入的字符串。参数 font 则为指定的字型。参数 size 为字的大小，单位为像素 (pixel)。参数 width 为的宽度。angle 为角度。返回数组有四个元素，第一、二个分别为左下角的 x,y 值，第三、四个元素为右上角的 x,y 值。
参考 ImagePSText()

原文转自：http://www.ltesting.net