imagejpeg
(PHP 4, PHP 5, PHP 7, PHP 8)
imagejpeg — 输出图象到浏览器或文件。
说明
imagejpeg() 从指定 image 图像创建 JPEG 文件。
参数
-
image -
由图象创建函数(例如imagecreatetruecolor())返回的 GdImage 对象。
-
file -
文件保存的路径或者已打开的流资源（此方法返回后自动关闭该流资源），如果未设置或为
null，将会直接输出原始图象流。 -
quality -
quality为可选项，范围从 0（最差质量，文件最小）到 100（最佳质量，文件最大）。默认值（-1）使用 IJG 默认的质量值（大约 75）。
返回值
成功时返回 true， 或者在失败时返回 false。
警告
如果 libgd 输出图像失败，函数会返回 true。
更新日志
| 版本 | 说明 |
|---|---|
| 8.0.0 |
image 现在需要 GdImage 实例；之前需要有效的 gd resource。
|
范例
示例 #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);
?>
以上例程的输出类似于：
示例 #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);
?>
示例 #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 跳过 file 参数，并设置图像质量为 75%
imagejpeg($im, NULL, 75);
// 释放内存
imagedestroy($im);
?>
注释
注意:
如果想输出渐进式 JPEG，需要使用 imageinterlace() 设置隔行扫描。
参见
- imagepng() - 将 PNG 图像输出到浏览器或文件
- imagegif() - 输出图象到浏览器或文件。
- imagewbmp() - 输出图象到浏览器或文件。
- imageinterlace() - 启用或禁用隔行扫描
- imagetypes() - 返回 PHP 内置支持的图像类型
＋add a note
User Contributed Notes
There are no user contributed notes for this page.
