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

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

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

:foreground foreground

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

:background background

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

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

:data data

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

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

:width width

Значение width определяет ширину изображения в пикселях.

:height height

Значение height определяет высоту изображения в пикселях.

Обратите внимание, что :width и :height могут быть использованы только при передаче данных, которые не определяют ширину и высоту (например, строка или вектор, содержащий биты изображения). Файлы XBM обычно сами определяют это, и использование этих двух свойств для таких файлов является ошибкой. Также обратите внимание, что :width и :height используются большинством других форматов изображений для указания, что отображаемое изображение должно быть, что обычно означает выполнение некоторого масштабирования. Это не поддерживается для изображений XBM.

:stride stride

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