imagejpeg
(PHP 4, PHP 5)
imagejpeg — 输出图象到浏览器或文件。
说明
bool imagejpeg
( resource $image
[, string $filename
[, int $quality
]] )
imagejpeg() 从 image
图像以 filename
为文件名创建一个
JPEG 图像。
参数
image
由图象创建函数(例如imagecreatetruecolor())返回的图象资源。
filename
文件保存的路径,如果未设置或为 NULL
,将会直接输出原始图象流。
如果要省略这个参数而提供
quality
参数,使用NULL。
quality
quality
为可选项,范围从
0(最差质量,文件更小)到 100(最佳质量,文件最大)。默认为
IJG 默认的质量值(大约 75)。
返回值
成功时返回 TRUE
, 或者在失败时返回 FALSE
。
范例
Example #1 输出 JPEG 图像
<?php
// 创键空白图像并添加一些文本
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);
// 设置内容类型标头 —— 这个例子里是 image/jpeg
header('Content-Type: image/jpeg');
// 输出图像
imagejpeg($im);
// 释放内存
imagedestroy($im);
?>
以上例程的输出类似于:
Example #2 保存一副 JPEG 图像
<?php
// 创键空白图像并添加一些文本
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);
// 保存图像为 'simpletext.jpg'
imagejpeg($im, 'simpletext.jpg');
// 释放内存
imagedestroy($im);
?>
Example #3 以 75% 的图像质量输出图像
<?php
// 创键空白图像并添加一些文本
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);
// 设置内容类型标头 —— 这个例子里是 image/jpeg
header('Content-Type: image/jpeg');
// 使用 NULL 跳过 filename 参数,并设置图像质量为 75%
imagejpeg($im, NULL, 75);
// 释放内存
imagedestroy($im);
?>
注释
Note: JPEG 支持仅在 PHP 与 GD-1.8 或更高版本一起编译时可用。
Note:
如果想输出渐进式 JPEG,需要用 imageinterlace() 函数将隔行扫描比特置位。
参见
imagepng() - 以 PNG 格式将图像输出到浏览器或文件 imagegif() - 输出图象到浏览器或文件。 imagewbmp() - 以 WBMP 格式将图像输出到浏览器或文件 imageinterlace() - 激活或禁止隔行扫描 imagetypes() - 返回当前 PHP 版本所支持的图像类型