(PHP 4, PHP 5)
imagejpeg — 输出图象到浏览器或文件
$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().