---

42.17.3 Изображения XBM

Для использования формата XBM укажите xbm в качестве типа изображения. Этот формат изображения не требует внешней библиотеки, поэтому изображения этого типа всегда поддерживаются.

Дополнительные свойства изображений, поддерживаемые для типа изображения xbm, следующие:

:foreground foreground

Значение foreground должно быть строкой, указывающей цвет переднего плана изображения, или nil для цвета по умолчанию. Этот цвет используется для каждого пикселя в XBM, который равен 1. По умолчанию используется цвет переднего плана рамки.

:background background

Значение background должно быть строкой, указывающей цвет фона изображения, или nil для цвета по умолчанию. Этот цвет используется для каждого пикселя в XBM, который равен 0. По умолчанию используется цвет фона рамки.

Если вы указываете изображение XBM, используя данные внутри Emacs вместо внешнего файла, используйте следующие три свойства:

:data data

Значение data указывает содержимое изображения. Для data можно использовать три формата:

• Вектор строк или булевых векторов, каждый из которых указывает одну строку изображения. Обязательно укажите :data-height и :data-width.
• Строка, содержащая ту же последовательность байтов, которую содержал бы файл XBM.
• Строка или булевый вектор, содержащие биты изображения (а возможно, и несколько дополнительных битов в конце, которые не будут использоваться). Он должен содержать как минимум stride * height битов, где stride — это наименьшее кратное 8, большее или равное ширине изображения. В этом случае вы должны указать :data-height, :data-width и :stride, чтобы указать, что строка содержит только биты, а не целый файл XBM, и указать размер изображения.

:stride stride

Количество записей булевого вектора, хранящихся для каждой строки; наименьшее кратное 8, большее или равное width.