Output a WebP image to browser or file

# imagewebp

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

imagewebp — Output a WebP image to browser or file

### Beschreibung

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

Outputs or saves a WebP version of the given `image`.

### Parameter-Liste

`image`

  Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.

`file`

  Der Pfad oder eine offene Stream-Ressource (die nach der Beendigung dieser Funktion automatisch geschlossen wird), in dem bzw. der die Datei gespeichert werden soll. Falls nicht gesetzt oder `null`, wird der rohe Bilddatenstrom direkt ausgegeben.

`quality`

  `quality` ranges from 0 (worst quality, smaller file) to 100 (best quality, biggest file). If `-1` is provided, the default value `80` is used.

### Rückgabewerte

Gibt bei Erfolg `true` zurück. Bei einem Fehler wird `false` zurückgegeben.

Achtung

Wenn libgd das Bild nicht ausgeben kann, gibt diese Funktion `true` zurück.

### Fehler/Exceptions

Throws a ValueError if `quality` is invalid.

### Changelog

Version | Beschreibung
--- | ---
8.4.0 | Now throws a ValueError if `quality` is invalid.
8.0.0 | `image` erwartet nun eine GdImage-Instanz; vorher wurde eine gültige `gd`-Ressource erwartet.

### Beispiele

Beispiel #1 Saving an WebP file

    <?php
    // Create a blank image and add some text
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);

    imagestring($im, 1, 5, 5,  'WebP with PHP', $text_color);

    // Save the image
    imagewebp($im, 'php.webp');
    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open