*** UNIX MANUAL PAGE BROWSER ***

XGetVisualInfo(3X11) XGetVisualInfo(3X11) NAME XGetVisualInfo, XMatchVisualInfo, XVisualIDFromVisual, XVisualInfo - obtain visual information and visual structure SYNOPSIS 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 Specifies the class of the screen. Specifies the depth of the screen. Specifies the connection to the X server. Returns the number of match- ing visual structures. Specifies the screen. Specifies the visual type. Specifies the visual mask value. Returns the matched visual in- formation. 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 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. The XMatchVisualInfo function returns the visual information for a vi- sual 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, XMatchVisu- alInfo returns nonzero and the information on the visual to vinfo_re- turn. Otherwise, when a visual is not found, XMatchVisualInfo returns zero. The XVisualIDFromVisual function returns the visual ID for the speci- fied visual type. STRUCTURES The XVisualInfo structure contains: /* Visual information mask bits */ l l l. #define VisualNoMask 0x0 #define VisualIDMask 0x1 #de- fine VisualScreenMask 0x2 #define VisualDepthMask 0x4 #de- fine VisualClassMask 0x8 #define VisualRedMaskMask 0x10 #de- fine VisualGreenMaskMask 0x20 #define VisualBlueMaskMask 0x40 #de- fine VisualColormapSizeMask 0x80 #define VisualBitsPerRGB- Mask 0x100 #define VisualAllMask 0x1FF /* Values */ typedef struct { Visual *visual; VisualID visualid; int screen; unsigned int depth; int class; unsigned long red_mask; unsigned long green_mask; unsigned long blue_mask; int colormap_size; int bits_per_rgb; } XVisualInfo; SEE ALSO XFree(3X11) Xlib -- C Language X Interface XGetVisualInfo(3X11)