该函数将符号 bitmap 定义为新的侧边栏位图, 或替换同名的已有位图。
参数 bits 指定要使用的图像, 可以是字符串或整数向量,其中每个元素(整数)对应位图的一行。 整数的每一位对应位图的一个像素,最低位对应位图最右侧的像素。 (注意:该位序与 XBM 图像相反;see XBM 图像。)
高度通常为 bits 的长度,
但可通过非 nil 的 height 指定其他高度。
宽度默认为 8,可通过非 nil 的 width 指定其他宽度,
宽度必须为 1 到 16 之间的整数。
参数 align 指定位图相对于其使用行范围的定位方式,
默认为居中。允许的值为 top、center 或 bottom。
align 也可以是列表 (align periodic),
其中 align 含义如上。若 periodic 为非 nil,
表示 bits 中的行将重复直至达到指定高度。
该函数销毁由 bitmap 标识的侧边栏位图。 若 bitmap 为标准侧边栏位图, 则实际会恢复其标准定义而非完全删除。
将侧边栏位图 bitmap 的文本的视觉样式设为 face。
若 face 为 nil,则选用 fringe 文本的视觉样式。
位图的文本的视觉样式控制其绘制颜色。
face 会与 fringe 文本的视觉样式合并,
因此通常 face 只需指定前景色。