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

XSetClipRectangles - установка маски вывода графического контекста

СИНТАКСИС
    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;

АРГУМЕНТЫ

ОПИСАНИЕ

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

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

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

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

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

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

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

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


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