# imagewebp

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

imagewebp — Affiche une image WebP vers un navigateur ou un fichier

### Description

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

Affiche ou sauvegarde une version WebP de 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` plage de 0 (la pire qualité, plus petit fichier) à 100 (meilleure qualité, plus grand fichier). Si la valeur `-1` est fournie, la valeur par défaut `80` est 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` est invalide.

### Historique

Version | Description
--- | ---
8.4.0 | Lève désormais une ValueError si `quality` est invalide.
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.

### Exemples

Exemple #1 Sauvegarde d'un fichier WebP

`<?php
// Crée une image vide et on y ajoute du texte
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'WebP avec PHP', $text_color);
// Sauvegarde de l'image
imagewebp($im, 'php.webp');
?>`