X Version 11 (1 September 1988) XGetVisualInfo(XS)
NAME
XGetVisualInfo, XMatchVisualInfo, XVisualIDFromVisual -
obtain visual information
SYNTAX
XVisualInfo *XGetVisualInfo(display, vinfo_mask,
vinfo_template, nitems_return)
Display *display;
long vinfo_mask;
XVisualInfo *vinfo_template;
int *nitems_return;
Status XMatchVisualInfo(display, screen, depth, class,
vinfo_return)
Display *display;
int screen;
int depth;
int class;
XVisualInfo *vinfo_return;
VisualID XVisualIDFromVisual(visual)
Visual *visual;
ARGUMENTS
class Specifies the class of the screen.
depth Specifies the depth of the screen.
display Specifies the connection to the X server.
nitems_return
Returns the number of matching visual structures.
screen Specifies the screen.
visual Specifies the visual type.
vinfo_mask
Specifies the visual mask value.
vinfo_return
Returns the matched visual information.
vinfo_template
Specifies the visual attributes that are to be
used in matching the visual structures.
DESCRIPTION
The XGetVisualInfo function returns a list of visual
structures that match 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.
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.
The XVisualIDFromVisual function returns the visual ID for
the specified visual type.
SEE ALSO
Xlib - C Language X Interface
(printed 2/12/90) (1 September 1988) XGetVisualInfo(XS)