XCreateRegion(3) XLIB FUNCTIONS XCreateRegion(3)

# [NAME](#NAME)

XCreateRegion, XSetRegion, XDestroyRegion - create or destroy regions

# [SYNTAX](#SYNTAX)

Region XCreateRegion(void);

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

int XDestroyRegion(Region *r*);

# [ARGUMENTS](#ARGUMENTS)

[*display*](#display)

Specifies the connection to the X server.

[*gc*](#gc)

Specifies the GC.

[*r*](#r)

Specifies the region.

# [DESCRIPTION](#DESCRIPTION)

The **XCreateRegion** function creates a new empty region.

The **XSetRegion** function sets the clip-mask in the GC to the specified region. The region is specified relative to the drawable's origin. The resulting GC clip origin is implementation-dependent. Once it is set in the GC, the region can be destroyed.

The **XDestroyRegion** function deallocates the storage associated with a specified region.

# [SEE ALSO](#SEE_ALSO)

[**XEmptyRegion**(3)](/man/os/libx11/XEmptyRegion.3), [**XIntersectRegion**(3)](/man/os/libx11/XIntersectRegion.3)  
*Xlib - C Language X Interface*

libX11 1.8.14 X Version 11

---

Document: XSetRegion(3) from libx11 1.8.14-r3 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libx11.git