ConFoo 2025

imageavif

(PHP 8 >= 8.1.0)

imageavifEnvia a imagem para o navegador ou para um arquivo

Descrição

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

Mostra ou grava uma imagem rasterizada AVIF a partir da imagem fornecida 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 stream 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 stream da imagem bruta será enviado diretamente.

quality

quality é opcional, e varia de 0 (pior qualidade, arquivo menor) a 100 (melhor qualidade, arquivo maior). Se -1 for fornecido, o valor padrão de 30 será usado.

speed

speed é opcional, e varia de 0 (lento, arquivo menor) a 10 (rápido, arquivo maior). Se -1 for fornecido, o valor padrão 6 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 ou speed forem inválidos.

Registro de Alterações

Versão Descrição
8.4.0 Agora lança um ValueError se quality ou speed forem inválidos.

Veja Também

  • imagepng() - Envia uma imagem PNG para o navegador ou arquivo
  • imagewbmp() - Envia a imagem para o navegador ou para um arquivo
  • imagejpeg() - Envia a imagem para o navegador ou para um arquivo
  • imagetypes() - Retorna os tipos de imagens suportados pela instalação do PHP
adicione uma nota

Notas Enviadas por Usuários (em inglês) 1 note

up
0
avi at orons dot pro
2 years ago
Usage example:
$image = imagecreatefromjpeg('test.jpg'); //read a jpg file
imageavif($image, 'test.avif'); //save an avif file
To Top