PHP 8.4.1 Released!

imageavif

(PHP 8 >= 8.1.0)

imageavif画像をブラウザあるいはファイルに出力する

説明

imageavif(
    GdImage $image,
    resource|string|null $file = null,
    int $quality = -1,
    int $speed = -1
): bool

指定された image から、 AVIF ラスタ画像を出力、または保存します。

パラメータ

image

imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。

file

ファイル保存先のパスあるいはオープン中のリソース (この関数が値を戻した後で自動的にクローズされます)。省略したり null を設定したりした場合は、画像ストリームを直接出力します。

quality

quality はオプションで、 0 (画質は最悪、小さなファイル) から 100 (最高画質、大きなファイル) までの値を取ります。 -1 を指定した場合、 デフォルト値 30 を使います。

speed

speed はオプションで、 0 (ゆっくり、小さなファイル) から 10 (速い、大きなファイル) までの値を取ります。 -1 を指定した場合、 デフォルト値 6 を使います。

戻り値

成功した場合に true を、失敗した場合に false を返します。

警告

しかしながら、libgd がイメージの出力に失敗した場合、この関数は true を返します。

エラー / 例外

quality または、speed が不正の場合、 ValueError をスローします。

変更履歴

バージョン 説明
8.4.0 quality または、speed が不正の場合、 ValueError をスローするようになりました。

参考

  • imagepng() - PNG イメージをブラウザまたはファイルに出力する
  • imagewbmp() - 画像をブラウザあるいはファイルに出力する
  • imagejpeg() - 画像をブラウザあるいはファイルに出力する
  • imagetypes() - この PHP がサポートしている画像形式を返す
add a note

User Contributed Notes 1 note

up
0
avi at orons dot pro
2 years ago
Usage example:
$image = imagecreatefromjpeg('test.jpg'); //read a jpg file
imageavif($image, 'test.avif'); //save an avif file
To Top