XSetClipRectangles(display, gc, clip_x_origin, clip_y_origin,
		 rectangles, n, ordering)
	Display *display;
	GC gc;
	int clip_x_origin, clip_y_origin;
	XRectangle rectangles[];
	int n;
	int ordering;

АРГУМЕНТЫ

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

     Функция XSetClipRectangles устанавливает список прямоугольников rectangles как маску вывода clip_mask в графическом контексте gc. Одновременно с этим устанавливаются координаты маски вывода через аргументы clip_x_origin и clip_y_origin.

     Маска из прямоугольников работает таким образом, что вывод будет осуществляться только в тех точках объекта назначения, которые находятся внутри прямоугольников, составляющих маску. Начальные координаты маски указываются в координатах объекта назначения, а координаты прямоугольников указываются относительно начальных координат маски.

     Требуется, чтобы прямоугольники маски не пересекались друг с другом, иначе результат работы маски будет непредсказуемым. Если указать пустой список прямоугольников, произойдет выключение маски в графическом контексте, что будет эквивалентом установки значения None в качестве маски при вызове функций XChangeGC и XSetClipMask.

     Также можно указать способ упорядочивания прямоугольников в аргументе ordering. Это может обеспечить более высокую скорость вывода при работе с маской из прямоугольников. Определены следующие способы упорядочивания:

• Unsorted - Прямоугольники располагаются в произвольном порядке;

• YSorted - Прямоугольники сортируются в порядке увеличения координаты Y верхней стороны прямоугольника;

• YXSorted - Аналогично YSorted, но если есть прямоугольники с равными координатами Y, то они располоагаются в порядке увеличения координаты X левой стороны прямоугольника;

• YXBanded - Аналогично YXSorted, но с ограничением, что если у каких-либо прямоугольников есть общий диапазон координаты Y, то эти прямоугольники должны иметь одинаковую координату Y верхней стороны и одинаковую высоту.

     Если указать неправильное значение способа сортировки, X-сервер может сгенерировать ошибку BadMatch, однако это не является обязательным. Если ошибка не появится, то неизвестно, как будет работать маска.

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

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

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

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