cmap_alloc - default visuals
cmap_alloc [ -display display:n.screen ] [ -force ] [ -allscreens ] [ -depth n ] [ -visual class ] [ -verbose ] [ -help ]
cmap_alloc(1) General Commands Manual cmap_alloc(1)
NAME
cmap_alloc - allocate default colormaps for non-default visuals
SYNOPSIS
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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------------+
|Availability | x11/colormap-utilities |
+---------------+------------------------+
|Stability | Volatile |
+---------------+------------------------+
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
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://www.x.org/releases/individ-
ual/app/xstdcmap-1.0.4.tar.bz2.
Further information about this software can be found on the open source
community website at https://www.x.org.
2 May 2014 cmap_alloc(1)