.de TQ
.br
.ns
.TP \\$1
..
.TH XRANDR-UTILS __libmansuffix__ __vendorversion__

.SH NAME
 XrandrUtils \- Wrapper library for libXrandr.
.SH SYNTAX
\&#include <X11/extensions/XrandrUtils.h>
.nf
.sp

.SH DATATYPES

.PP
.B Relations and Geometries
.PP
.nf
typedef enum {
  relation_left_of,
  relation_right_of,
  relation_above,
  relation_below,
  relation_same_as,
} XRURelation;

typedef struct {
  int     x1, y1, x2, y2;
} XRUBox;

typedef struct {
  int     x, y;
} XRUPoint;

typedef enum {
  name_none = 0,
  name_string = (1 << 0),
  name_xid = (1 << 1),
  name_index = (1 << 2),
  name_preferred = (1 << 3),
} XRUNameKind;

typedef struct {
  XRUNameKind     kind;
  char            *string;
  XID             xid;
  int             index;
} XRUName;

/**
 * Return string name for the given rotation,
 * or "invalid rotation" on error.
 */
const char * XRURotationName(Rotation rotation);

/**
 * Look up rotation name and return an index number,
 * or -1 if name could not be found.
 */
int XRUGetRotationIndex(char * rotation_name);

/**
 * Return the Rotation matching the given index,
 * or 0 if not valid.
 */
Rotation XRUGetRotation(int dirind);

/**
 * Return string name for the given rotation,
 * or "invalid reflection" on error.
 */
const char * XRUReflectionName(Rotation rotation);

/**
 * Look up reflection name and return an index number,
 * or -1 if name could not be found.
 */
int XRUGetReflectionIndex(char * reflection_name);

/**
 * Return the reflection matching the given index as
 * a Rotation, or 0 if not valid.
 */
Rotation XRUGetReflection(int dirind);

.sp
.fi

.SH DESCRIPTION
.B XrandrUtils
is a high level library designed to wrapper the Xrandr library with
a more convenient API for doing common screen configuration operations.

.SH FUNCTIONS
.PP

.SH RESTRICTIONS
.B XrandrUtils
will remain upward compatible after the current 1.0 release.
.SH AUTHOR
Keith Packard, Intel; Bryce Harrington, Canonical.