Descrição

imagebmp(GdImage $image, resource|string|null $file = null, bool $compressed = true): bool

Mostra ou grava uma versão BMP 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 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.

Nota:
null é inválido se o parâmetro compressed não for usado.
compressed: Define se o BMP deve ser comprimido com codificação run-length (RLE), ou não.

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.

Registro de Alterações

Versão	Descrição
8.0.0	O parâmetro `image` agora espera uma instância de GdImage; anteriormente, um resource `gd` válido era esperado.
8.0.0	O tipo de `compressed` agora é bool; anteriormente era int.

Exemplos

Exemplo #1 Gravando um arquivo BMP

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

imagestring($im, 1, 5, 5,  'BMP com PHP', $text_color);

// Grava a imagem
imagebmp($im, 'php.bmp');
?>