Названия цветов

Название цвета — это текст (обычно в строке), задающий цвет. Допускаются символические названия, такие как ‘black’, ‘white’, ‘red’ и т. д.; чтобы просмотреть список заданных названий, используйте M-x list-colors-display. Цвета также можно задавать численно в таких формах, как ‘#rgb’ и ‘RGB:r/g/b’, где r задаёт уровень красного, g — уровень зелёного, а b — уровень синего. Для r можно использовать одну, две, три или четыре шестнадцатеричные цифры; затем для g и b нужно использовать столько же шестнадцатеричных цифр, чтобы общее число цифр составляло 3, 6, 9 или 12. (Дополнительные сведения о числовом задании цветов в формате RGB см. в документации X Window System.)

Эти функции позволяют определить, какие названия цветов допустимы и как они выглядят. В некоторых случаях значение зависит от выбранного фрейма, как описано ниже; см. Фокус ввода, где объясняется значение термина «выбранный фрейм».

Чтобы считывать названия цветов, введённые пользователем, с автодополнением, используйте read-color (см. read-color).

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

Эта функция сообщает, имеет ли название цвета смысл. Если да, она возвращает t; в противном случае — nil. Аргумент frame указывает, о дисплее какого фрейма нужно запросить сведения; если frame опущен или равен nil, используется выбранный фрейм.

Обратите внимание: это не сообщает, действительно ли используемый дисплей поддерживает данный цвет. При использовании X можно запросить любой заданный цвет на дисплее любого типа, и будет получен результат — обычно максимально близкий из возможных. Чтобы определить, может ли фрейм действительно отображать определённый цвет, используйте color-supported-p (см. ниже).

Функция: defined-colors &optional frame

Эта функция возвращает список названий цветов, заданных и поддерживаемых на фрейме frame (по умолчанию — на выбранном фрейме). Если frame не поддерживает цвета, возвращается nil.

Функция: color-supported-p color &optional frame background-p

Функция возвращает t, если frame действительно может отображать цвет color (или хотя бы что-то близкое к нему). Если frame опущен или равен nil, вопрос относится к выбранному фрейму.

Некоторые терминалы поддерживают разные наборы цветов для переднего плана и фона. Если background-p не равно nil, это означает, что вы спрашиваете, можно ли использовать color в качестве цвета фона; в противном случае — можно ли использовать его в качестве цвета переднего плана.

Аргумент color должен быть допустимым названием цвета.

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

Функция возвращает t, если color является оттенком серого согласно дисплею фрейма frame. Если frame опущен или равен nil, вопрос относится к выбранному фрейму. Если color не является допустимым названием цвета, функция возвращает nil.

Функция: color-values color &optional frame

Эта функция возвращает значение, описывающее, как в идеале должен выглядеть color на фрейме frame. Если color задан, значением будет список из трёх целых чисел, задающих интенсивность красного, зелёного и синего. Теоретически каждое целое число находится в диапазоне от 0 до 65535, но некоторые дисплеи могут использовать не весь диапазон. Этот список из трёх элементов называется значениями RGB цвета.

Если color не задан, возвращается nil.

(color-values "black")
     ⇒ (0 0 0)
(color-values "white")
     ⇒ (65535 65535 65535)
(color-values "red")
     ⇒ (65535 0 0)
(color-values "pink")
     ⇒ (65535 49344 52171)
(color-values "hungry")
     ⇒ nil

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

Функция: color-name-to-rgb color &optional frame

Эта функция выполняет то же, что и color-values, но возвращает значения цвета в виде чисел с плавающей точкой в диапазоне от 0.0 до 1.0 включительно.

Функция: color-dark-p rgb

Эта функция возвращает значение, отличное от nil, если цвет, заданный триплетом RGB rgb, лучше читается на белом фоне, чем на тёмном. Аргумент rgb должен быть списком вида (r g b), где каждый компонент — число с плавающей точкой в диапазоне от 0.0 до 1.0 включительно. Для преобразования названия цвета в такой список можно использовать color-name-to-rgb.