imagejpeg

(PHP 4, PHP 5, PHP 7, PHP 8)

imagejpeg — 输出图象到浏览器或文件。

说明

imagejpeg(resource $image, string $filename = ?, int $quality = ?): bool

imagejpeg() 从 image   图像以 filename 为文件名创建一个图像。

参数

• image

• 由图象创建函数(例如imagecreatetruecolor())返回的图象资源。

• filename

• 文件保存的路径，如果未设置或为 null，将会直接输出原始图象流。

  如果要省略这个参数而提供       quality 参数，使用NULL。

• quality

• quality 为可选项，范围从       0（最差质量，文件更小）到 100（最佳质量，文件最大）。默认为       IJG 默认的质量值（大约 75）。

返回值

成功时返回 true， 或者在失败时返回 false。

范例

示例 #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);
?>

以上例程的输出类似于：

示例 #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/jpegheader('Content-Type: image/jpeg');
// 使用 NULL 跳过 filename 参数，并设置图像质量为 75%imagejpeg($im, NULL, 75);
// 释放内存imagedestroy($im);
?>

注释

注意:

如果想输出渐进式 JPEG，需要用imageinterlace() 函数将隔行扫描比特置位。

参见

• imagepng() - 以 PNG 格式将图像输出到浏览器或文件

• imagegif() - 输出图象到浏览器或文件。

• imagewbmp() - 以 WBMP 格式将图像输出到浏览器或文件

• imageinterlace() - 启用或禁用隔行扫描

• imagetypes() - 返回当前 PHP 版本所支持的图像类型