Status XAllocColorCells(display, colormap, contig, plane_masks_return,
			    nplanes, pixels_return, npixels)
	Display *display;
	Colormap colormap;
	Bool contig;
	unsigned long plane_masks_return[];
	unsigned int nplanes;
	unsigned long pixels_return[];
	unsigned int npixels;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• colormap - идентификатор палитры, в которой следует выделять ячейки;
• contig - рекомендация о непрерывности маски плоскостей;
• plane_masks_return - возвращаемый список значений масок цветовых плоскостей;
• nplanes - запрашиваемое количество цветовых плоскостей;
• pixels_return - возвращаемый список со значениями индексов выделенных ячеек;
• npixels - запрашиваемое количество индексов в цветовой палитре;

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

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

    Обращения к разным плоскостям в палитре происходит путем просто указания индекса в палитре (обращение к нулевой плоскости) или логического сложения индекса в палитре и одной или несколькими масками плоскостей.

    Таким образом при выделении ненулевого количества плоскостей, реальное количество выделямых ячеек памяти вычисляется следующим образом: ncolors*2^nplanes.

    Для визуальных классов Grayscale Pseudocolor маска плоскости имеет как правило один разряд, установленный в единицу, а для класса DirectColor маска имеет три установленных разряда. Установленные в единицу разряды масок никогда не пересекаются с установленными в единицу разрядами индексов. Т.е. установленные в единицу разряды маски в индексах всегда будут сброшены в ноль.

     Эта функция возвращает ненулевое значение статуса в случае успешного своего выполнения, или нулевое значение, если возникла какая-то проблема.

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

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

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