imageavif

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

説明

bool imageavif(
    GdImage $image,
    resourcestringnull $file = null,
    int $quality = -1,
    int $speed = -1
)

指定された 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
  • imagewbmp
  • imagejpeg
  • imagetypes