XFreeColors(display, colormap, pixels, npixels, planes)
	Display *display;
	Colormap colormap;
	unsigned long pixels[];
	int npixels;
	unsigned long planes;

АРГУМЕНТЫ

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

    Эта функция освобождает те ячейки палитры colormap, которые перечислены в списке pixels, а также все ячейки, принадлежащие цветовым плоскостям, указанным в planes. Аргумент planes не должен иметь общих, установленных в единицу разрядов со значениями индексов. Полный список ячеек, которые необходимо освободить формируется путем поочередного логического сложения групп разрядов аргумента planes, принадлежащих разным плоскостям и индексов, перечисленных в pixels. Т.е. аргумент planes должен формироваться путем логического сложения масок плоскостей палитры, в которых необходимо освободить ячейки.

    Освобождению подлежат только те ячейки, которые были выделены самой программой при помощи функций XAllocColor, XAllocNamedColor, XAllocColorCells и XAllocColorPlanes. Т.е. те ячейки, которые были созданы функцией XCreateColormap с указанным аргументом alloc, равным AllocAll освобождению не подлежат.

    Cледует обратить внимание на то, что освобождение отдельной ячейки, полученной при помощи функции XAllocColorPlanes, может не привести к освобождению индекса до тех пор, пока все совместные с ней ячейки не будут освобождены.

    Ячейка с атрибутом "только для чтения" не будет освобождена до тех пор, пока её не освободят все программы. Если одна программа выделила одну ячейку несколько раз, то такое же количество раз она должна быть освобождена для окончательного освобождения ячейки палитры.

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

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

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

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