[ Содержание ][ Перечень функций ]

XCopyColormapAndFree - создание копии палитры с освобождением старой

СИНТАКСИС
    Colormap XCopyColormapAndFree(display, colormap)
	Display *display;
	Colormap colormap;

АРГУМЕНТЫ

ОПИСАНИЕ

    Эта функция создаёт новую цветовую палитру и возвращает её идентификатор. Новая палитра создаётся того же визуального типа и принадлежит тому же экрану, что и указанная цветовая палитра colormap.

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

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

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

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

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


[ Содержание ][ Перечень функций ]