# imagexbm

(PHP 5, PHP 7, PHP 8)

imagexbm — Imprimir una imagen XBM en el navegador o en un fichero

### Descripción

imagexbm(resource `$image`, string `$filename`, int `$foreground` = ?): bool

Imprime o guarda una versión XBM de la imagen `image`.

> Nota: imagexbm() no aplica ningún relleno, por lo que el ancho de la image ha de ser múltiplo de 8.

### Parámetros

`image`

  Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

`filename`

  La ruta o un recurso de flujo de apertura (el cual se cierra automáticamente después de que devuelva esta función) donde guardar el fichero. Si no se establece, o su valor es `null`, se mostrará directamente en la salida el flujo de imagen sin tratar.

`foreground`

  Se puede establecer el color de primer plano con este parámetro estableciendo un identificador obtenido de imagecolorallocate(). El color de primer plano por defecto es negro. Todos los demás colores son tratados como fondo.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Ejemplos

Ejemplo #1 Guardar un fichero XBM

`<?php
// Crear una imagen en blanco y añadir algún texto
$im = imagecreatetruecolor(120, 20);
$color_texto = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $color_texto);
// Guardar la imagen
imagexbm($im, 'simpletext.xbm');
// Liberar memoria
imagedestroy($im);
?>`

Ejemplo #2 Guardar un fichero XBM con un color de primer plano diferente

`<?php
// Crear una imagen en blanco y añadir algún texto
$im = imagecreatetruecolor(120, 20);
$color_texto = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $color_texto);
// Esteblecer un color de primer plano sustituto
$color_primer_plano = imagecolorallocate($im, 255, 0, 0);
// Guardar la imagen
imagexbm($im, NULL, $color_primer_plano);
// Liberar memoria
imagedestroy($im);
?>`

### Notas