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

Если ваша сборка Emacs имеет поддержку ImageMagick, вы можете использовать библиотеку ImageMagick для загрузки многих форматов изображений (см. Свойства файлов в Руководстве GNU Emacs). Символ типа изображения для изображений, загруженных через ImageMagick, — imagemagick, независимо от фактического базового формата изображения.

Для проверки поддержки ImageMagick используйте следующее:

(image-type-available-p 'imagemagick)

Функция: imagemagick-types

Эта функция возвращает список расширений файлов изображений, поддерживаемых текущей установкой ImageMagick. Каждый элемент списка — символ, представляющий внутреннее имя ImageMagick для типа изображения, например, BMP для изображений .bmp.

Пользовательская опция: imagemagick-enabled-types

Значение этой переменной — список типов изображений ImageMagick, которые Emacs может попытаться отобразить с помощью ImageMagick. Каждый элемент списка должен быть одним из символов в списке, возвращаемом imagemagick-types, или эквивалентной строкой. В качестве альтернативы, значение t включает ImageMagick для всех возможных типов изображений. Независимо от значения этой переменной, imagemagick-types-inhibit (см. ниже) имеет приоритет.

Пользовательская опция: imagemagick-types-inhibit

Значение этой переменной содержит список типов изображений ImageMagick, которые никогда не должны отображаться с помощью ImageMagick, независимо от значения imagemagick-enabled-types. Значение t полностью отключает ImageMagick.

Переменная: image-format-suffixes

Эта переменная представляет собой список ассоциаций, сопоставляющий типы изображений с расширениями имен файлов. Emacs использует это в сочетании со свойством изображения :format (см. ниже), чтобы дать библиотеке ImageMagick подсказку о типе изображения. Каждый элемент имеет вид (type extension), где type — символ, определяющий тип содержимого изображения, а extension — строка, определяющая соответствующее расширение имени файла.

Изображения, загруженные с поддержкой ImageMagick, поддерживают следующие дополнительные свойства описания изображения:

:background background

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

:format type

Значение type должно быть символом, определяющим тип данных изображения, как указано в image-format-suffixes. Это используется, когда у изображения нет связанного имени файла, чтобы дать ImageMagick подсказку для определения типа изображения.

:crop geometry

Значение geometry должно быть списком вида (width height x y). width и height задают ширину и высоту обрезки изображения. Если x — положительное число, оно задаёт смещение обрезки от левого края исходного изображения; если отрицательное — от правого. Если y — положительное число, оно задаёт смещение от верхней границы исходного изображения; если отрицательное — от нижней. Если x или y являются nil или не указаны, область обрезки будет центрирована на исходном изображении.

Если область обрезки выходит за пределы или перекрывает края изображения, она будет уменьшена, чтобы исключить любые области, выходящие за пределы изображения. Это означает, что невозможно использовать :crop для увеличения размера изображения, вводя большие значения width или height.

Обрезка выполняется после масштабирования, но перед поворотом.