imagexbm

(PHP 5, PHP 7)

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