(PHP 5, PHP 7, PHP 8)
imagexbm — 将XBM图像输出到浏览器或文件
输出或保存给定image的XBM版本。
注意: imagexbm()不应用任何填充，因此图像宽度必须是8的倍数。从PHP 7.0.9开始，此限制不再适用。
image一个GdImage对象，由一个图像创建函数返回，例如imagecreatetruecolor()。
filename保存文件的路径，以string形式给出。如果为null，则将直接输出原始图像流。
filename（不包括.xbm扩展名）也用于XBM的C标识符，其中当前区域设置的非字母数字字符将被下划线替换。如果filename设置为null，则使用image来构建C标识符。
foreground_color可以通过此参数设置前景色，方法是设置从imagecolorallocate()获得的标识符。默认前景色为黑色。所有其他颜色都被视为背景。
| 版本 | 描述 |
|---|---|
| 8.0.0 |
image现在需要一个GdImage实例；以前，需要一个有效的gd resource。 |
| 8.0.0 |
foreground_color现在可以为空。 |
| 8.0.0 | 已删除第四个未使用的参数。 |
示例 #1 保存XBM文件
<?php
// 创建一个空白图像并添加一些文本
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);
// 保存图像
imagexbm($im, 'simpletext.xbm');
// 释放内存
imagedestroy($im);
?>
示例 #2 使用不同的前景色保存XBM文件
<?php
// 创建一个空白图像并添加一些文本
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);
// 设置替换前景色
$foreground_color = imagecolorallocate($im, 255, 0, 0);
// 保存图像
imagexbm($im, NULL, $foreground_color);
// 释放内存
imagedestroy($im);
?>