(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);
?>