Go to main content

man pages section 1: User Commands

Exit Print View

Updated: July 2017
 
 

cmap_alloc (1)

Name

cmap_alloc - default visuals

Synopsis

/usr/bin/cmap_alloc   [  -display  display:n.screen  ]  [  -force  ]  [
-allscreens ] [ -depth n ] [ -visual class ] [ -verbose ] [ -help ]

Description

cmap_alloc(1)               General Commands Manual              cmap_alloc(1)



NAME
       cmap_alloc - allocate default colormaps for non-default visuals

SYNOPSIS
       /usr/bin/cmap_alloc   [  -display  display:n.screen  ]  [  -force  ]  [
       -allscreens ] [ -depth n ] [ -visual class ] [ -verbose ] [ -help ]

DESCRIPTION
       cmap_alloc creates empty colormaps for non-default dynamic visuals that
       are  suitable for use as default colormaps.  An X11 server has only one
       default colormap,  and  it  is  associated  with  the  default  visual.
       Clients  that  need  to access non-default visuals have to create their
       own colormaps.  This can lead to gratuitous colormap flashing if a  lot
       of  applications  are  running in non-default visuals.  cmap_alloc will
       create colormaps that can be used by such applications as  the  default
       colormap  for the given visual.  Once the colormap has been created for
       a  given  visual,  it  will  place  the   colormap's   XID   into   the
       RGB_DEFAULT_MAP  property  on  the root window of the display.  Clients
       that need to access non-default  dynamic  visuals  should  search  this
       property using XGetRGBColormaps(3x11) for a suitable colormap to use.

OPTIONS
       -display display:n.screen
                 Indicates which X11 server to use.  The default is to use the
                 value set in the DISPLAY environment variable.

       -force    Create a colormap even if  a  suitable  colormap  is  already
                 listed in the RGB_DEFAULT_MAP property.

       -allscreens
                 Create  default  colormaps  for  all  screens of the display.
                 Without this option, colormaps will only be created  for  the
                 default screen.

       -depth n  Create  default  colormaps  only  for those visuals that have
                 depth n.  The default is to create colormaps for  visuals  of
                 all depths

       -visual class
                 Create  default  colormaps only for those visuals that are of
                 class class.  Where class is one of the following: GrayScale,
                 PsuedoColor, DirectColor

       -verbose  Print out diagnostic messages useful for debugging.

       -help     Print out a short usage message and exit.

SEE ALSO
       XGetRGBColormaps(3x11), xstdcmap(1), cmap_compact(1)


DIAGNOSTICS
       can't open display ...
                           Error  in connecting to the X11 server.  Check DIS-
                           PLAY environment variable.

       unknown depth       Invalid depth specified for the -depth command line
                           option

       unknown visual class
                           Invalid visual class specified for the -visual com-
                           mand line option


ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |x11/colormap-utilities       |
       +-----------------------------+-----------------------------+
       |Interface Stability          |Committed                    |
       +-----------------------------+-----------------------------+



                                  2 May 2014                     cmap_alloc(1)