---
name: "XSetArcMode"
section: "3"
platform: "linux"
package: "libx11"
version: "1.8.14-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XSetArcMode"
---

# XSetArcMode(3)

GC convenience routines

## NAME

XSetArcMode, XSetSubwindowMode, XSetGraphicsExposure - GC convenience routines

## SYNTAX

int XSetArcMode(Display \**display*, GC *gc*, int *arc\_mode*);

int XSetSubwindowMode(Display \**display*, GC *gc*, int *subwindow\_mode*);

int XSetGraphicsExposures(Display \**display*, GC *gc*, Bool *graphics\_exposures*);

## ARGUMENTS

- *arc\_mode*

  Specifies the arc mode. You can pass **ArcChord** or **ArcPieSlice**.

- *display*

  Specifies the connection to the X server.

- *gc*

  Specifies the GC.

- *graphics\_exposures*

  Specifies a Boolean value that indicates whether you want **GraphicsExpose** and **NoExpose** events to be reported when calling **XCopyArea** and **XCopyPlane** with this GC.

- *subwindow\_mode*

  Specifies the subwindow mode. You can pass **ClipByChildren** or **IncludeInferiors**.

## DESCRIPTION

The **XSetArcMode** function sets the arc mode in the specified GC.

**XSetArcMode** can generate **BadAlloc**, **BadGC**, and **BadValue** errors.

The **XSetSubwindowMode** function sets the subwindow mode in the specified GC.

**XSetSubwindowMode** can generate **BadAlloc**, **BadGC**, and **BadValue** errors.

The **XSetGraphicsExposures** function sets the graphics-exposures flag in the specified GC.

**XSetGraphicsExposures** can generate **BadAlloc**, **BadGC**, and **BadValue** errors.

## DIAGNOSTICS

- **BadAlloc**

  The server failed to allocate the requested resource or server memory.

- **BadGC**

  A value for a GContext argument does not name a defined GContext.

- **BadValue**

  Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error.

## SEE ALSO

[**XCopyArea**(3)](/XCopyArea/3.md), [**XCreateGC**(3)](/XCreateGC/3.md), [**XQueryBestSize**(3)](/XQueryBestSize/3.md), [**XSetClipOrigin**(3)](/XSetClipOrigin/3.md), [**XSetFillStyle**(3)](/XSetFillStyle/3.md), [**XSetFont**(3)](/XSetFont/3.md), [**XSetLineAttributes**(3)](/XSetLineAttributes/3.md), [**XSetState**(3)](/XSetState/3.md), [**XSetTile**(3)](/XSetTile/3.md)\
 *Xlib - C Language X Interface*