XStoreNamedColor(display, colormap, color, pixel, flags)
	Display *display;
	Colormap colormap;
	char *color;
	unsigned long pixel;
	int flags;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• colormap - идентификатор палитры, в которой необходимо изменить данные ячейки;
• color - название цвета;
• pixel - индексный номер ячейки палитры;
• flags - маска, показывающая, какие соствляющие цвета необходимо изменить.

    Эта функция изменяет значения RGB в ячейке палитры colormap. Индекс ячейки указывается в аргументе pixel. Данные RGB берутся из текстовой базы данный цветов X-сервера по названию, указанному в аргументе color. Данные изменяются только для тех составляющих цвета, для которых установлены соответствующие разряды в маске flags. Для каждой составляющей цвета определены соответствующие разряды: DoRed для красной составляющей, DoGreen для зеленой и DoBlue для синей. Комбинируются разряды маски при помощи операции "логическое ИЛИ".

    Ячейка, которая указывается в pixel должна присутствовать в палитре и быть доступна для записи.

    Если палитра, в которую вносятся изменения, установлена на экран, изменения станут видны незамедлительно.

    Регистр символов в названии цвета роли не играет. В случае, если название цвета найдено и значения RGB были получены, возвращается ненулевой статус, иначе статус будет нулевым.

    Вместо указания имени цвета, в аргументе color_name можно указать значения RGB. Формат строки в этом случае будет выглядеть следующим образом:

rgb:<red>/<green>/<blue>

 где <red>, <green>, <blue> - одно из (h или hh или hhh или hhhh).
 h - это одна шестнадцатеричная цифра (четыре разряда).

     Для обратной совместимости поддерживается старый формат представления значений RGB в названии цвета:

#RGB              (4 разряда на канал)
#RRGGBB           (8 рарядов на канал)
#RRRGGGBBB        (12 разрядов на канал)
#RRRRGGGGBBBB     (16 разрядов на канал)

    Наличие символа '#' в названии цвета указывает на то, что дальше будут идти значения RGB. Символы R, G и B представляют собой шестнадцатеричные цифры. Все значения приводятся к формату 16 разрядов на канал путем перевода указанных цифр в старшие разряды 16-разрядного слова. Таким образом #3a7 будет эквивалентом #3000a0007000. Такой формат представления цвета и названия цветов из текстовой базы X-сервера были использованы для обозначения цветов в HTML. Однако, такое представление значений RGB в названии цвета не рекомендуется к дальнейшему использованию в приложениях X Window.

    Также поддерживается яркостное представление RGB:

rgbi:<red>/<green>/<blue>

    Где <red>, <green> и <blue> - вещественные числа в диапазоне от 0.0 до 1.0 включительно. Допустимо использование экспоненциальной формы записи (пример: 1.2E-1).

     Функция XStoreNamedColor может генерировать следующие ошибки:

• BadAccess - попытка записи в ячейку с атрибутом "только для чтения";
• BadColor - ошибка указания цветовой палитры;
• BadName - цвет с указанным именем не найден;
• BadValue - какое-то из числовых значений выходит за допустимый диапазон.

См. также: XAllocColor, XAllocNamedColor, XAllocColorCells, XAllocColorPlanes, XQueryColors, XFreeColors, XStoreColor, XStoreColors, XCreateColormap.