Status XAllocColor(display, colormap, screen_in_out)
	Display *display;
	Colormap colormap;
	XColor *screen_in_out;

АРГУМЕНТЫ

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

    Эта функция выделяет память под ячейку палитры colormap и заносит в неё то значение цвета, которое поддерживается аппаратным обеспечением и которое ближе всего к цвету, указанному в screen_in_out. Новая ячейка получает признак "только для чтения".

    Через screen_in_out также возвращается значение индекса в цветовой палитре и те значения яркости каналов RGB, которые были использованы на самом деле.

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

    Несколько программ могут запрашивать создание в одной палитре записи с одинаковыми значениями RGB и они могут получать одну и ту же ячейку палитры. Это позволяет разделять ячейки палитры между несколькими приложениями. Когда ячейка выделяется повторно, в ней это отмечается. Когда приложение хочет освободить память от ячейки, реально память освободится только тогда, когда ячейку освободит последнее приложение.

    XAllocColor не использует никаких флагов в структуре XColor.

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

• BadColor - ошибка указания цветовой палитры.

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