XMatchVisualInfo

Syntax

Status XMatchVisualInfo(display, screen, depth, class, vinfo_return)
      Display *display;
      int screen;
      int depth;
      int class;
      XVisualInfo *vinfo_return;

Arguments

display Specifies the connection to the X server.
screen Specifies the screen.
depth Specifies the depth of the screen.
class Specifies the class of the screen.
vinfo_return Returns the matched visual information.

Description

The XMatchVisualInfo() function returns the visual information for a visual that matches the specified depth and class for a screen. Because multiple visuals that match the specified depth and class can exist, the exact visual chosen is undefined. If a visual is found, XMatchVisualInfo() returns nonzero and the information on the visual to vinfo_return. Otherwise, when a visual is not found, XMatchVisualInfo() returns zero.

See also

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