XGetVisualInfo

Syntax

XVisualInfo *XGetVisualInfo(display, vinfo_mask, vinfo_template, nitems_return)
      Display *display;
      long vinfo_mask;
      XVisualInfo *vinfo_template;
      int *nitems_return;

Arguments

display Specifies the connection to the X server.
vinfo_mask Specifies the visual mask value.
vinfo_template Specifies the visual attributes that are to be used in matching the visual structures.
nitems_return Returns the number of matching visual structures.

Description

The XGetVisualInfo() function returns a list of visual structures that have attributes equal to the attributes specified by vinfo_template. If no visual structures match the template using the specified vinfo_mask, XGetVisualInfo() returns a NULL. To free the data returned by this function, use XFree().

See also

XFree(), XMatchVisualInfo(), XVisualIDFromVisual(), "Determining the Appropriate Visual Type".
Christophe Tronche, ch@tronche.com