Имена цветов

Имя цвета — это текст (обычно строка), который определяет цвет. Разрешены символьные имена, такие как ‘черный’, ‘белый’, ‘красный’ и т. д.; используйте 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 (см. ниже).

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

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

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

Эта функция ранее называлась x-defined-colors, и это имя по-прежнему поддерживается как псевдоним.

Функция: 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.

Эта функция ранее называлась x-color-values, и это имя по-прежнему поддерживается как псевдоним.