# imageavif

(PHP 8 >= 8.1.0)

imageavif — Affichage de l'image vers le navigateur ou dans un fichier

### Description

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

Affiche ou sauvegarde une image au format AVIF en utilisant l'`image` fournie.

### Liste de paramètres

`image`

  Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

`file`

  Le chemin ou un flux de ressource ouvert (qui sera automatiquement fermé après le retour de cette fonction) vers lequel le fichier sera sauvegardé. Si non-défini ou `null`, le flux brute de l'image sera affiché directement.

`quality`

  `quality` est un paramètre optionnel dont la plage varie de 0 (pire qualité, plus petit fichier) à 100 (meilleure qualité, plus grand fichier). Si `-1` est passé en paramètre, la valeur par défaut `52` sera utilisée.

`speed`

  `speed` est un paramètre optionnel dont la plage varie de 0 (encodage lent, plus petit fichier) à 10 (encodage rapide, plus grand fichier). Si `-1` est passé en paramètre, la valeur par défaut `6` sera utilisée.

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

Attention

Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne `true`.

### Erreurs / Exceptions

Lève une ValueError si `quality` ou `speed` est invalide.

### Historique

Version | Description
--- | ---
8.4.0 | Lève désormais une ValueError si `quality` ou `speed` est invalide.

### Voir aussi

- imagepng() - Envoie une image PNG vers un navigateur ou un fichier
- imagewbmp() - Affichage de l'image vers le navigateur ou dans un fichier
- imagejpeg() - Affichage de l'image vers le navigateur ou dans un fichier
- imagetypes() - Retourne les types d'images supportés par la version courante de PHP