Тестирование функций отображения

Функции в этом разделе описывают базовые возможности конкретного дисплея. Программы Lisp могут использовать их для адаптации своего поведения к возможностям дисплея. Например, программа, которая обычно использует всплывающее меню, может использовать минибуфер, если всплывающие меню не поддерживаются.

Необязательный аргумент display в этих функциях указывает, о каком дисплее задавать вопрос. Он может быть именем дисплея, фреймом (который указывает на дисплей, на котором находится фрейм) или nil (который относится к дисплею выбранного фрейма, см. Фокус ввода).

См. Имена цветов, Цвета текстовых терминалов, для получения дополнительной информации о дисплеях.

Функция: display-popup-menus-p &optional display

Эта функция возвращает t , если всплывающие меню поддерживаются на display, и nil , если нет. Поддержка всплывающих меню требует наличия мыши, поскольку меню вызывается щелчком мыши по некоторой части дисплея Emacs.

Функция: display-graphic-p &optional display

Эта функция возвращает t , если display является графическим дисплеем, способным отображать несколько фреймов и нескольких различных шрифтов одновременно. Это верно для дисплеев, использующих систему окон, такую как X, и ложно для текстовых терминалов.

Функция: display-mouse-p &optional display

Эта функция возвращает t , если на display доступна мышь, и nil , если нет.

Функция: display-color-p &optional display

Эта функция возвращает t , если экран цветной. Раньше она называлась x-display-color-p, и это имя по-прежнему поддерживается как псевдоним.

Функция: display-grayscale-p &optional display

Эта функция возвращает t , если экран может отображать оттенки серого. (Все цветные дисплеи могут это делать.)

Функция: display-supports-face-attributes-p attributes &optional display

Эта функция возвращает не-nil , если все атрибуты стиля текста в attributes поддерживаются (см. Атрибуты стиля текста).

Определение «поддерживается» несколько приблизительное, но в основном означает, что стиль текста, содержащий все атрибуты из attributes, при слиянии с базовым стилем текста для дисплея может быть представлен таким образом, который

1. отличается по внешнему виду от базового стиля текста, и
2. соответствует духу заданных атрибутов, если не точно.

Пункт (2) подразумевает, что атрибут :weight black будет удовлетворён любым дисплеем, который может отображать полужирный шрифт, как и :foreground "yellow", до тех пор, пока может быть отображён какой-то жёлтоватый цвет, но :slant italic не будет удовлетворён кодом отображения tty для автоматической замены курсива тёмным стилем текста.

Функция: display-selections-p &optional display

Эта функция возвращает t , если display поддерживает выделения. Оконные дисплеи обычно поддерживают выделения, но они также могут поддерживаться и в некоторых других случаях.

Функция: display-images-p &optional display

Эта функция возвращает t , если display может отображать изображения. В теории оконные дисплеи должны обрабатывать изображения, но некоторые системы не поддерживают это. На дисплее, который не поддерживает изображения, Emacs не может отобразить панель инструментов.

Функция: display-screens &optional display

Эта функция возвращает количество экранов, связанных с дисплеем.

Функция: display-pixel-height &optional display

Эта функция возвращает высоту экрана в пикселях. В случае текстового терминала она возвращает высоту в символах.

Для графических терминалов обратите внимание, что в конфигурациях с несколькими мониторами это относится к высоте в пикселях для всех физических мониторов, связанных с display. См. Несколько терминалов.

Функция: display-pixel-width &optional display

Эта функция возвращает ширину экрана в пикселях. В случае текстового терминала она возвращает ширину в символах.

Для графических терминалов обратите внимание, что в конфигурациях с несколькими мониторами это относится к ширине в пикселях для всех физических мониторов, связанных с display. См. Несколько терминалов.

Функция: display-mm-height &optional display

Эта функция возвращает высоту экрана в миллиметрах или nil , если Emacs не может получить эту информацию.

Для графических терминалов обратите внимание, что в конфигурациях с несколькими мониторами это относится к высоте для всех физических мониторов, связанных с display. См. Несколько терминалов.

Функция: display-mm-width &optional display

Эта функция возвращает ширину экрана в миллиметрах или nil , если Emacs не может получить эту информацию.

Для графических терминалов обратите внимание, что в конфигурациях с несколькими мониторами это относится к ширине для всех физических мониторов, связанных с display. См. Несколько терминалов.

Пользовательский параметр: display-mm-dimensions-alist

Эта переменная позволяет пользователю указать размеры графических дисплеев, возвращаемые функциями display-mm-height и display-mm-width в случае, если система предоставляет некорректные значения.

Функция: display-backing-store &optional display

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

Значения могут быть символами always, when-mapped, или not-useful. Функция также может вернуть nil , когда вопрос неприменим к определенному типу дисплея.

Функция: display-save-under &optional display

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

Функция: display-planes &optional display

Эта функция возвращает количество плоскостей, поддерживаемых дисплеем. Как правило, это количество бит на пиксель. Для tty-дисплея это логарифм по основанию два от количества поддерживаемых цветов.

Функция: display-visual-class &optional display

Эта функция возвращает класс визуализации для экрана. Значение — один из символов static-gray (ограниченное, неизменяемое число оттенков серого), gray-scale (полный диапазон оттенков серого), static-color (ограниченное, неизменяемое число цветов), pseudo-color (ограниченное число цветов), true-color (полный диапазон цветов) и direct-color (полный диапазон цветов).

Функция: display-color-cells &optional display

Эта функция возвращает количество цветовых ячеек, поддерживаемых экраном.

Эти функции получают дополнительную информацию о используемой системе окон, где Emacs отображает указанный display. (Их имена начинаются с x- по историческим причинам.)

Функция: x-server-version &optional display

Эта функция возвращает список версий номера GUI-системы окон, работающей на display, такой как сервер X в системах GNU и Unix. Значение — список из трёх целых чисел: основных и второстепенных номеров версии протокола и номера дистрибутива, относящегося к самой системе программного обеспечения окон. В системах GNU и Unix это обычно версия протокола X и номер дистрибутива, относящегося к самой программной оболочке сервера X. В системах MS-Windows это версия операционной системы Windows.

Функция: x-server-vendor &optional display

Эта функция возвращает поставщика программного обеспечения системы окон (в виде строки). В системах GNU и Unix это действительно означает компанию, которая распространяет сервер X. В MS-Windows это строка идентификатора поставщика операционной системы Windows (Microsoft).

Когда разработчики X классифицировали поставщиков программного обеспечения как «поставщиков», они продемонстрировали ошибочное предположение, что никакая система не может быть разработана и распространена в некоммерческих целях.