PHP Conference Japan 2024

imageavif

(PHP 8 >= 8.1.0)

imageavif將影像輸出到瀏覽器或檔案

描述

imageavif(
    GdImage $image,
    資源|字串|null $file = null,
    int $quality = -1,
    int $speed = -1
): bool

從指定的 image 輸出或儲存 AVIF 點陣圖影像。

參數

image

一個 GdImage 物件,由其中一個影像建立函式(例如 imagecreatetruecolor())所回傳。

檔案

要儲存檔案的路徑或開啟的串流資源(此函式回傳後會自動關閉)。如果未設定或為 null,則會直接輸出原始影像串流。

品質

quality 是可選的,範圍從 0(品質最差,檔案較小)到 100(品質最佳,檔案較大)。如果提供 -1,則會使用預設值 30

速度

speed 是可選的,範圍從 0(慢,檔案較小)到 10(快,檔案較大)。如果提供 -1,則會使用預設值 6

回傳值

成功時回傳 true,失敗時回傳 false

注意

然而,如果 libgd 無法輸出影像,此函式會回傳 true

錯誤/例外

如果 qualityspeed 無效,則會拋出 ValueError

更新日誌

版本 描述
8.4.0 現在,如果 qualityspeed 無效,則會拋出 ValueError

另請參閱

新增註解

使用者貢獻的註解 1 則註解

avi at orons dot pro
2 年前
使用範例
$image = imagecreatefromjpeg('test.jpg'); //讀取 jpg 檔案
imageavif($image, 'test.avif'); //儲存 avif 檔案
To Top