[ Содержание ] | [ Перечень функций ] |
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.
[ Содержание ] | [ Перечень функций ] |