imagejpeg
(PHP 4, PHP 5, PHP 7, PHP 8)
imagejpeg — 輸出圖像到瀏覽器或檔案。
說明
imagejpeg(resource
$image, string $filename = ?, int $quality = ?): bool
imagejpeg() 從 image
影象以 filename 為檔名建立一個
JPEG 影象。
參數
-
image -
由圖像建立函式(例如imagecreatetruecolor())返回的 GdImage 對象。
-
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/jpeg
header('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/jpeg
header('Content-Type: image/jpeg');
// 使用 NULL 跳過 filename 參數，並設定影象質量為 75%
imagejpeg($im, NULL, 75);
// 釋放記憶體
imagedestroy($im);
?>
註釋
注意:
如果想輸出漸進式 JPEG，需要用 imageinterlace() 函式將隔行掃瞄位元置位。
參見
- imagepng() - 以 PNG 格式將影象輸出到瀏覽器或檔案
- imagegif() - 輸出圖像到瀏覽器或檔案。
- imagewbmp() - 以 WBMP 格式將影象輸出到瀏覽器或檔案
- imageinterlace() - 啟用或禁用隔行掃瞄
- imagetypes() - 返回目前 PHP 版本所支援的影象型別