XSetRegion(display, gc, r)
	Display *display;
	GC gc;
	Region r;

АРГУМЕНТЫ

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

     Функция XSetRegion устанавливает регион r как маску вывода clip_mask в графическом контексте gc. Координаты, хранящиеся в регионе интерпретируются относительно нулевых координат объекта назначения. Значения clip_x_origin и clip_y_origin в различных реализациях могут интерпретироваться по-разному, поэтому для обеспечения лучшей совместимости необходимо хранить в них нулевые значения.

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

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

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

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

Cм. также: XChangeGC, XSetClipRectangles, XSetClipMask, XCreateRegion, XDestroyRegion, XEmptyRegion, XEqualRegion, XIntersectRegion, XOffsetRegion, XPointInRegion, XPolygonRegion, XRectInRegion, XShapeCombineRegion, XShrinkRegion, XSubtractRegion, XUnionRectWithRegion, XUnionRegion, XXorRegion.