imagewbmp

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

imagewbmpEnvia a imagem para o navegador ou para um arquivo

Descrição

imagewbmp(GdImage$image, resource|string|null$file = null, ?int$foreground_color = null): bool

imagewbmp() mostra ou grava uma versão WBMP 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 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.

foreground_color

Pode-se definir a cor de primeiro plano com este parâmetro, configurando-se um identificador obtido a partir da função imagecolorallocate(). A cor de primeiro plano padrão é preta.

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ãoDescrição
8.0.0 O parâmetro image agora espera uma instância de GdImage; anteriormente, um resourcegd válido era esperado.
8.0.0foreground_color agora pode ser nulo.

Exemplos

Exemplo #1 Mostrando uma imagem WBMP

<?php
// Cria uma imagem vazia e adiciona texto
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Define o cabeçalho de tipo de conteúdo - neste caso image/vnd.wap.wbmp
// Dica: veja image_type_to_mime_type() para tipos de conteúdo
header('Content-Type: image/vnd.wap.wbmp');

// Mostra a imagem
imagewbmp($im);

// Libera a memória
imagedestroy($im);
?>

Exemplo #2 Gravando a imagem WBMP

<?php
// Cria uma imagem vazia e adiciona texto
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Grava a imagem
imagewbmp($im, 'simpletext.wbmp');

// Libera a memória
imagedestroy($im);
?>

Exemplo #3 Mostrando a imagem com primeiro plano diferente

<?php
// Cria uma imagem vazia e adiciona texto
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Define o cabeçalho de tipo de conteúdo - neste caso image/vnd.wap.wbmp
// Dica: veja image_type_to_mime_type() para tipos de conteúdo
header('Content-Type: image/vnd.wap.wbmp');

// Define uma cor substituta para primeiro plano
$foreground_color = imagecolorallocate($im, 255, 0, 0);

imagewbmp($im, NULL, $foreground_color);

// Libera a memória
imagedestroy($im);
?>

Veja Também

  • image2wbmp() - Envia a imagem para o navegador ou para um arquivo
  • imagepng() - Envia uma imagem PNG para o navegador ou arquivo
  • imagegif() - 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
To Top