Mostra uma imagem WebP no navegador ou grava em arquivo

# imagewebp

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

imagewebp — Mostra uma imagem WebP no navegador ou grava em arquivo

### Descrição

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

Mostra ou grava uma versão WebP da imagem informada em `image`.

### Parâmetros

`image`
  Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
`file`

  O caminho ou um recurso de fluxo aberto (que será fechado automaticamente após o retorno desta função) para salvar o arquivo. Se não for definido ou for `null`, o fluxo da imagem bruta será enviado diretamente.

`quality`

  `quality` varia de 0 (pior qualidade, arquivo menor) a 100 (melhor qualidade, arquivo maior). Se `-1` for informado, o valor padrão de `80` será usado.

### Valor Retornado

Retorna `true` em caso de sucesso ou `false` em caso de falha.

Cuidado

Entretanto, se a biblioteca libgd falhar ao gerar a imagem, esta função retornará `true`.

### Erros/Exceções

Lança um ValueError se `quality` for inválido.

### Registro de Alterações

Versão | Descrição
--- | ---
8.4.0 | Agora lança um ValueError se `quality` for inválido.
8.0.0 | O parâmetro `image` agora espera uma instância de GdImage; anteriormente, um resource `gd` válido era esperado.

### Exemplos

Exemplo #1 Gravando um arquivo WebP

    <?php
    // Cria uma imagem vazia e adiciona texto
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);

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

    // Grava a imagem
    imagewebp($im, 'php.webp');
    ?>

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