Colormap XCreateColormap(display, w, visual, alloc)
	Display *display;
	Window w;
	Visual *visual;
	int alloc;

АРГУМЕНТЫ

• display - указатель на структуру, описывающую соединение с X-сервером;
• w - идентификатор окна, для экрана которого создаётся палитра;
• visual - визуальный тип для создаваемой палитры;
• alloc - сколько ячеек палитры зарезервировать при её создании.

    Эта функция создаёт палитру указанного визуального типа для экрана, на котором расположено окно w и возвращает идентификатор созданной палитры. Обратите внимание, что указание окна в данном случае служит лишь для определения экрана. Назначение палитры окну производится функциями XCreateWindow, XSetWindowColormap или XChangeWindowAttributes

    Аргумент alloc указывает, сколько ячеек палитры необходимо выделить после создания палитры. В качестве значения для этого аргумента можно указать AllocAll, чтобы выделить память сразу под все ячейки палитры или AllocNone, чтобы не выделять ячеек и оставить возможность выделить ячейки на будущее. Для визуальных классов StaticGray, StaticColor и TrueColor значение alloc в любом случае должно быть AllocNone, иначе появится ошибка BadMatch.

    При выделении ячеек палитры, когда в аргументе alloc указывается значение AllocAll, все ячейки палитры создаются доступными для записи, но их первоначальные значения для визуальных классов GrayScale, PseudoColor и DirectColor не будут определены. К тому же, ячейки палитры, созданные таким образом не могут быть освобождены при помощи XFreeColors.

     Для визуальных классов StaticGray, StaticColor и TrueColor значения ячеек палитры будут определены, но их значения будут специфичны для визуального класса и строгого соглашения по их значениям в системе X-Window нет.

    Описание визуальных классов Вы можете прочесть в описании структуры XVisualInfo.

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

• BadAlloc - X-сервер не может выделить запрошенный ресурс или память;
• BadMatch - несоотвествие одного или нескольких аргуметов допустимым значениям;
• BadPixmap - ошибка указания графического образа;
• BadWindow - ошибка указания идентификатора окна.

Cм. также: XCopyColormapAndFree, XFreeColormap, XInstallColormap, XUninstallColormap, XAllocColor, XAllocNamedColor, XQueryColor, XStoreColors, XSetWindowColormap, XFreeColors, XAllocColorCells.