imagejpeg

(PHP 4, PHP 5)

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

说明

bool imagejpeg ( resource $image [, string $filename [, int $quality ]] )

imagejpeg() 从 image 图像以 filename 为文件名创建一个 JPEG 图像。image 参数是 imagecreatetruecolor() 函数的返回值。

filename 参数为可选，如果省略，则原始图像流将被直接输出。要省略 filename 参数而提供 quality 参数，使用空字符串（''）。通过 header() 发送 Content-type: image/jpeg 可以使 PHP 脚本直接输出 JPEG 图像。

Note: JPEG 支持仅在 PHP 与 GD-1.8 或更高版本一起编译时可用.

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

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

参见 imagepng()， imagegif()， imagewbmp()， imageinterlace() 和 imagetypes()。

参数

image

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

filename

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

To skip this argument in order to provide the quality parameter, use NULL.

quality

quality is optional, and ranges from 0 (worst quality, smaller file) to 100 (best quality, biggest file). The default is the default IJG quality value (about 75).

返回值

成功时返回 TRUE，或者在失败时返回 FALSE.

范例

Example #1 Outputting a JPEG image


<?php
// Create a blank image and add some text
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

// Set the content type header - in this case image/jpeg
header('Content-Type: image/jpeg');

// Output the image
imagejpeg($im);

// Free up memory
imagedestroy($im);
?>

以上例程的输出类似于：

Example #2 Saving a JPEG image


<?php
// Create a blank image and add some text
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

// Save the image as 'simpletext.jpg'
imagejpeg($im, 'simpletext.jpg');

// Free up memory
imagedestroy($im);
?>

Example #3 Outputting the image at 75% quality


<?php
// Create a blank image and add some text
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

// Set the content type header - in this case image/jpeg
header('Content-Type: image/jpeg');

// Skip the filename parameter using NULL, then set the quality to 75%
imagejpeg($im, NULL, 75);

// Free up memory
imagedestroy($im);
?>

注释

Note: JPEG 支持仅在 PHP 与 GD-1.8 或更高版本一起编译时可用.

Note:
If you want to output Progressive JPEGs, you need to set interlacing on with imageinterlace().

参见

imagepng() - 以 PNG 格式将图像输出到浏览器或文件
imagegif() - 输出图象到浏览器或文件
imagewbmp() - 以 WBMP 格式将图像输出到浏览器或文件
imageinterlace() - 激活或禁止隔行扫描
imagetypes() - 返回当前 PHP 版本所支持的图像类型