Next: XPM 图像, Previous: 图像描述符, Up: 图像   [Contents][Index]

---

42.17.3 XBM 图像 ¶

要使用 XBM 格式，需指定 xbm 作为图像类型。该图像格式无需外部库，因此此类图像始终受支持。

xbm 图像类型支持的附加图像属性如下：

:foreground foreground

取值 foreground 应为字符串，用于指定图像前景色；若为 nil 则使用默认颜色。该颜色用于 XBM 中值为 1 的每个像素。默认值为框架的前景色。

:background background

取值 background 应为字符串，用于指定图像背景色；若为 nil 则使用默认颜色。该颜色用于 XBM 中值为 0 的每个像素。默认值为框架的背景色。

若你使用 Emacs 内部数据而非外部文件指定 XBM 图像，可使用以下三个属性：

:data data

取值 data 用于指定图像内容。 data 支持三种格式：

• 字符串或布尔向量构成的向量，每一项对应图像的一行。必须同时指定 :data-height 与 :data-width。
• 包含与 XBM 文件完全相同字节序列的字符串。
• 包含图像位数据的字符串或布尔向量（末尾可包含未使用的多余位）。其长度应至少包含 stride * height 位，其中 stride 是大于或等于图像宽度的最小 8 的倍数。这种情况下，你需要指定 :data-height、:data-width 与 :stride，既用于表明该字符串仅包含位数据而非完整 XBM 文件，也用于指定图像尺寸。

:stride stride

每行存储的布尔向量条目数；即大于或等于 width 的最小 8 的倍数。