Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xpolygonregion(3) [hpux man page]

XPolygonRegion()														  XPolygonRegion()

Name
  XPolygonRegion - generate a region from points in a polygon.

Synopsis
  Region XPolygonRegion(points, n, fill_rule)
	XPoint points[];
	int n;
	int fill_rule;

Arguments
  points    Specifies a pointer to an array of points.

  n	    Specifies the number of points in the polygon.

  fill_rule Specifies  whether	areas overlapping an odd number of times should be part of the region (WindingRule) or not part of the region
	    (EvenOddRule).  See Volume One, Chapter 5, The Graphics Context, for a description of the fill rule.

Returns
  The created region.

Description
  XPolygonRegion() creates a region defined by connecting the specified points, and returns a pointer to be used to refer to the region.

  Regions are located relative to a point (the region origin) which is common to all regions.  In XPolygonRegion(), the coordinates specified
  in points are relative to the region origin.	By specifying all points relative to the drawable in which they will be used, the region ori-
  gin can be coincident with the drawable origin.  It is up to the application whether to interpret the location of the region relative to  a
  drawable or not.

  If  the  region  is to be used as a clip_mask by calling XSetRegion(), the upper-left corner of the region relative to the drawable used in
  the graphics request will be at (xoffset + clip_x_origin, yoffset + clip_y_origin), where xoffset and yoffset are the offset of the  region
  (if  any)  and  clip_x_origin  and clip_y_origin are elements of the GC used in the graphics request.  The fill_rule can be either of these
  values:

  EvenOddRule	 Areas overlapping an odd number of times are not part of the region.

  WindingRule	 Overlapping areas are always filled.

  For more information on structures, see Volume One, Chapter 6, Drawing Graphics and Text.

Structures
  Region is a pointer to an opaque structure type.

See Also
  XClipBox(), XCreateRegion(),	XDestroyRegion(),  XEmptyRegion(),  XEqualRegion(),  XIntersectRegion(),  XOffsetRegion(),  XPointInRegion(),
  XRectInRegion(), XSetRegion(), XShrinkRegion(), XSubtractRegion(), XUnionRectWithRegion(), XUnionRegion(), XXorRegion().

Xlib - Regions															  XPolygonRegion()

Check Out this Related Man Page

XIntersectRegion(3)						  XLIB FUNCTIONS					       XIntersectRegion(3)

NAME
XIntersectRegion, XUnionRegion, XUnionRectWithRegion, XSubtractRegion, XXorRegion, XOffsetRegion, XShrinkRegion - region arithmetic SYNTAX
int XIntersectRegion(Region sra, Region srb, Region dr_return); int XUnionRegion(Region sra, Region srb, Region dr_return); int XUnionRectWithRegion(XRectangle *rectangle, Region src_region, Region dest_region_return); int XSubtractRegion(Region sra, Region srb, Region dr_return); int XXorRegion(Region sra, Region srb, Region dr_return); int XOffsetRegion(Region r, int dx, int dy); int XShrinkRegion(Region r, int dx, int 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(3), XDrawRectangle(3), XEmptyRegion(3) Xlib - C Language X Interface X Version 11 libX11 1.5.0 XIntersectRegion(3)
Man Page