Php/docs/function.imagejpeg
imagejpeg
(PHP 4, PHP 5, PHP 7)
imagejpeg — 输出图象到浏览器或文件。
说明
imagejpeg
( resource $image
[, string $filename
[, int $quality
]] ) : bool
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/jpegheader('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/jpegheader('Content-Type: image/jpeg');// 使用 NULL 跳过 filename 参数,并设置图像质量为 75%imagejpeg($im, NULL, 75);// 释放内存imagedestroy($im);?>
注释
Note:
如果想输出渐进式 JPEG,需要用 imageinterlace() 函数将隔行扫描比特置位。
参见
- imagepng() - 以 PNG 格式将图像输出到浏览器或文件
- imagegif() - 输出图象到浏览器或文件。
- imagewbmp() - 以 WBMP 格式将图像输出到浏览器或文件
- imageinterlace() - 激活或禁止隔行扫描
- imagetypes() - 返回当前 PHP 版本所支持的图像类型