(PHP 4, PHP 5)
imagejpeg — 輸出圖象到瀏覽器或文件。
說明
bool imagejpeg ( resource$image
[, string $filename
[, int $quality
]] )
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/jpeg
header('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/jpeg
header('Content-Type: image/jpeg');
// 使用 NULL 跳過 filename 參數,并設置圖像質量為 75%
imagejpeg($im, NULL, 75);
// 釋放內存
imagedestroy($im);
?>
注釋
Note: JPEG 支持僅在 PHP 與 GD-1.8 或更高版本一起編譯時可用。
Note:
如果想輸出漸進式 JPEG,需要用 imageinterlace() 函數將隔行掃描比特置位。
參見
imagepng() - 以 PNG 格式將圖像輸出到瀏覽器或文件 imagegif() - 輸出圖象到瀏覽器或文件。 imagewbmp() - 以 WBMP 格式將圖像輸出到瀏覽器或文件 imageinterlace() - 激活或禁止隔行掃描 imagetypes() - 返回當前 PHP 版本所支持的圖像類型