MirOS Manual: XGetVisualInfo(3), XMatchVisualInfo(3), XVisualIDFromVisual(3), XVisualInfo(3)


XGetVisualInfo(3X11)     XLIB FUNCTIONS      XGetVisualInfo(3X11)

NAME

     XGetVisualInfo, XMatchVisualInfo, XVisualIDFromVisual,
     XVisualInfo - obtain visual information and visual structure

SYNTAX

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

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

     VisualID XVisualIDFromVisual(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 struc-
     tures that have attributes equal to the attributes specified
     by vinfo_template. If no visual structures match the tem-
     plate 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 unde-
     fined. If a visual is found, XMatchVisualInfo returns
     nonzero and the information on the visual to vinfo_return.

XFree86                   Version 4.5.0                         1

XGetVisualInfo(3X11)     XLIB FUNCTIONS      XGetVisualInfo(3X11)

     Otherwise, when a visual is not found, XMatchVisualInfo
     returns zero.

     The XVisualIDFromVisual function returns the visual ID for
     the specified visual type.

STRUCTURES

     The XVisualInfo structure contains:

     /* Visual information mask bits */
     #define   VisualNoMask                0x0
     #define   VisualIDMask                0x1
     #define   VisualScreenMask            0x2
     #define   VisualDepthMask             0x4
     #define   VisualClassMask             0x8
     #define   VisualRedMaskMask           0x10
     #define   VisualGreenMaskMask         0x20
     #define   VisualBlueMaskMask          0x40
     #define   VisualColormapSizeMask      0x80
     #define   VisualBitsPerRGBMask        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

XFree86                   Version 4.5.0                         2

Generated on 2017-04-03 16:26:17 by $MirOS: src/scripts/roff2htm,v 1.88 2017/01/29 00:51:06 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002–2017 The MirOS Project, Germany.
This product includes material provided by mirabilos.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.