Manual Pages for UNIX Operating System command usage for man XSolarisCheckColormapEquivalence

XLIB FUNCTIONS             XSolarisCheckColormapEquivalence(3Xmu)



NAME
     XSolarisCheckColormapEquivalence - determines if two visuals
     are colormap equivalent

SYNOPSIS
     cc [ flag ... ] file ... -lXmu  [ library ... ]
     #include 

     Bool XSolarisCheckColormapEquivalence(
           Display *display,
           int screen,
           Visual *visual1,
           Visual *visual2);

ARGUMENTS
     display   Specifies the connection to the X server.

     screen    An integer specifying  the  screen  on  which  the
               visuals are to be searched.

     visual1   Specifies the first visual type supported  on  the
               screen.   If  the visual type is not one supported
               by the screen, a BadMatch error results.

     visual2   Specifies the second visual type supported on  the
               screen.   If  the visual type is not one supported
               by the screen, a BadMatch error results.

DESCRIPTION
     This function returns True if the two Visuals  are  Colormap
     Equivalent, otherwise it returns False.

     Colormap Equivalence is a minor relaxation of the X protocol
     supported  by the Solaris X server Xsun(1).  Two Visuals are
     Colormap Equivalent if it is  possible  to  use  a  Colormap
     created  with one of the Visuals as the Colormap of a Window
     in the other Visual. This is useful on a  system  that  sup-
     ports  Visuals that differ only in their OpenGL (GLX) Attri-
     butes.

     For example, to avoid colormap  flashing,  when  creating  a
     window  with  a  Visual  that  is  in  the same depth as the
     RootWindow, use the Default Colormap.  In standard  X,  this
     is  only  possible  if the Visual is the DefaultVisual. With
     Colormap Equivalence the requirement is relaxed.

     To use  this  function,  an  application  should  link  with
     libXmu.

EXAMPLES
     You may be able to avoid creating a new  colormap  by  using
     the following code:



X Version 11        Last change: 11 Jan 2008                    1






XLIB FUNCTIONS             XSolarisCheckColormapEquivalence(3Xmu)



                  if (!XSolarisCheckColormapEquivalence(dpy, screen,
                                     vi->visual, DefaultVisual(dpy, screen)) {
                      attributes.colormap = XCreateColormap(dpy, root,
                                          vi->visual, AllocNone);
                      valuemask = CWColormap;
                  }
                  window = XCreateWindow(dpy, root, 0, 0, 500, 500, 0,
                                  vi->depth, CopyFromParent, vi->visual,
                                  valuemask, &attributes);

SEE ALSO
     XCreateWindow(3X11), glXGetConfig(3gl).











































X Version 11        Last change: 11 Jan 2008                    2