imagejpeg

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

imagejpeg — 輸出圖象到瀏覽器或文件。

說(shuō)明

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

imagejpeg() 從 image 圖像以 filename 為文件名創(chuàng)建一個(gè) JPEG 圖像。

參數(shù)

image

由圖象創(chuàng)建函數(shù)(例如imagecreatetruecolor())返回的 GdImage 對(duì)象。

filename

文件保存的路徑或者已打開(kāi)的流資源（此方法返回后自動(dòng)關(guān)閉該流資源），如果未設(shè)置或?yàn)?null，將會(huì)直接輸出原始圖象流。

如果要省略這個(gè)參數(shù)而提供 quality 參數(shù)，使用NULL。

quality

quality 為可選項(xiàng)，范圍從 0（最差質(zhì)量，文件更小）到 100（最佳質(zhì)量，文件最大）。默認(rèn)為 IJG 默認(rèn)的質(zhì)量值（大約 75）。

返回值

成功時(shí)返回 true， 或者在失敗時(shí)返回 false。

范例

示例 #1 輸出 JPEG 圖像

<?php
// 創(chuàng)鍵空白圖像并添加一些文本
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

// 設(shè)置內(nèi)容類(lèi)型標(biāo)頭 —— 這個(gè)例子里是 image/jpeg
header('Content-Type: image/jpeg');

// 輸出圖像
imagejpeg($im);

// 釋放內(nèi)存
imagedestroy($im);
?>

以上例程的輸出類(lèi)似于：

例子的輸出：輸出 JPEG 圖像

示例 #2 保存一副 JPEG 圖像

<?php
// 創(chuàng)鍵空白圖像并添加一些文本
$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');

// 釋放內(nèi)存
imagedestroy($im);
?>

示例 #3 以 75% 的圖像質(zhì)量輸出圖像

<?php
// 創(chuàng)鍵空白圖像并添加一些文本
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

// 設(shè)置內(nèi)容類(lèi)型標(biāo)頭 —— 這個(gè)例子里是 image/jpeg
header('Content-Type: image/jpeg');

// 使用 NULL 跳過(guò) filename 參數(shù)，并設(shè)置圖像質(zhì)量為 75%
imagejpeg($im, NULL, 75);

// 釋放內(nèi)存
imagedestroy($im);
?>

注釋

注意:

如果想輸出漸進(jìn)式 JPEG，需要用 imageinterlace() 函數(shù)將隔行掃描比特置位。

參見(jiàn)

  • imagepng() - 以 PNG 格式將圖像輸出到瀏覽器或文件
  • imagegif() - 輸出圖象到瀏覽器或文件。
  • imagewbmp() - 以 WBMP 格式將圖像輸出到瀏覽器或文件
  • imageinterlace() - 啟用或禁用隔行掃描
  • imagetypes() - 返回當(dāng)前 PHP 版本所支持的圖像類(lèi)型