xunionrectwithregion(3) [hpux man page]
XUnionRectWithRegion() XUnionRectWithRegion() Name XUnionRectWithRegion - add a rectangle to a region. Synopsis XUnionRectWithRegion(rectangle, src_region, dest_region_return) XRectangle *rectangle; Region src_region; Region dest_region_return; Arguments rectangle Specifies the rectangle to add to the region. src_region Specifies the source region to be used. dest_region_return Specifies the resulting region. May be the same as src_region. Description XUnionRectWithRegion() computes the destination region from a union of the specified rectangle and the specified source region. The source and destination regions may be the same. One common application of this function is to simplify the combining of the rectangles specified in contiguous Expose events into a clip_mask in the GC, thus restricting the redrawn areas to the exposed rectangles. Use XUnionRectWithRegion() to combine the rectangle in each Expose event into a region, then call XSetRegion(). XSetRegion() sets the clip_mask in a GC to the region. In this case, src_region and dest_region_return would be the same region. If src_region and dest_region_return are not the same region, src_region is copied to dest_region_return before the rectangle is added to dest_region_return. For more information on regions, see Volume One, Chapter 6, Drawing Graphics and Text. Structures typedef struct { short x, y; unsigned short width, height; } XRectangle; Region is a pointer to an opaque data type. See Also XClipBox(), XDestroyRegion(), XEmptyRegion(), XEqualRegion(), XIntersectRegion(), XOffsetRegion(), XPointInRegion(), XPolygonRegion(), XRectInRegion(), XSetRegion(), XShrinkRegion(), XSubtractRegion(), XUnionRegion(), XXorRegion(). Xlib - Resource Manager XUnionRectWithRegion()
Check Out this Related Man Page
XIntersectRegion(3X11) XLIB FUNCTIONS XIntersectRegion(3X11) NAME
XIntersectRegion, XUnionRegion, XUnionRectWithRegion, XSubtractRegion, XXorRegion, XOffsetRegion, XShrinkRegion - region arithmetic SYNTAX
XIntersectRegion(sra, srb, dr_return) Region sra, srb, dr_return; XUnionRegion(sra, srb, dr_return) Region sra, srb, dr_return; XUnionRectWithRegion(rectangle, src_region, dest_region_return) XRectangle *rectangle; Region src_region; Region dest_region_return; XSubtractRegion(sra, srb, dr_return) Region sra, srb, dr_return; XXorRegion(sra, srb, dr_return) Region sra, srb, dr_return; XOffsetRegion(r, dx, dy) Region r; int dx, dy; XShrinkRegion(r, dx, dy) Region r; int dx, dy; ARGUMENTS
dest_region_return Returns the destination region. dr_return Returns the result of the computation. ds Dy move or shrink dx dy Specify the x and y coordinates, which define the amount you want to the specified region. r Specifies the region. rectangle Specifies the rectangle. sra srb Specify the two regions with which you want to perform the computation. src_region Specifies the source region to be used. DESCRIPTION
The XIntersectRegion function computes the intersection of two regions. The XUnionRegion function computes the union of two regions. The XUnionRectWithRegion function updates the destination region from a union of the specified rectangle and the specified source region. The XSubtractRegion function subtracts srb from sra and stores the results in dr_return. The XXorRegion function calculates the difference between the union and intersection of two regions. The XOffsetRegion function moves the specified region by a specified amount. The XShrinkRegion function reduces the specified region by a specified amount. Positive values shrink the size of the region, and negative values expand the region. SEE ALSO
XCreateRegion(3X11), XDrawRectangle(3X11), XEmptyRegion(3X11) Xlib - C Language X Interface X Version 11 Release 6.6 XIntersectRegion(3X11)