XSetClipMask(display, gc, pixmap)
	Display *display;
	GC gc;
	Pixmap pixmap;

АРГУМЕНТЫ

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

     Функция XSetClipMask устанавливает графический образ pixmap как маску вывода clip_mask в графическом контексте gc.

     Графический образ pixmap должен иметь глубину цветности, равную единице и он должен принадлежать тому же корневому окну, что и графический контекст gc, иначе появится ошибка BadMatch. Если в pixmap указано значение None, то происходит выключение маски в графическом контексте.

     В дальнейшием, при выводе через графический контекст gc вывод графической информации будет производиться только в тех точках, где соответствующие точки маски имеют значения, равные единице. Графический вывод полностью блокируется за пределами области, покрываемой маской.

     Маска вывода действует на все запросы вывода графики. По-умолчанию, маска располагается в нулевых координатах, однако её положение можно изменить при помощи функций XSetClipOrigin и XChangeGC.

     Маску вывода в графическом контексте также можно установить функциями XSetClipRectangles и XSetRegion.

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

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

Cм. также: XChangeGC, XSetSubwindowMode, XSetArcMode, XSetGraphicsExposures, XSetTile, XSetStipple, XSetTSOrigin, XSetLineAttributes, XSetDashes, XSetClipOrigin, XSetClipRectangles, XSetFillStyle, XSetFillRule, XSetForeground, XSetBackground, XSetFont, XSetFunction, XSetPlaneMask, XSetState, XSetRegion.