LCM(1) Domain/OS BSD LCM(1)
NAME
lcm - load a color map
SYNOPSIS
lcm [options]
DESCRIPTION
lcm loads a color map from a file that specifies a set of color map
entries. Each entry establishes an association between an index and a
color value. When the DM is initially loaded, it sets the node's color
map from the file `node_data/etc/dm_display/color_map.
If no pathname is given, lcm loads the color map from
`node_data/etc/dm_display/color_map. In this case, all 256 colors (that
is, color entries for color slots 0-255) are reloaded. If you specify a
pathname, lcm reads the given file and tries to load the colors
associated with the indexes.
NOTE
In a DM environment, if there are direct mode graphics programs running
that change the color values for any of the color slots 0-255, the
changes affect other windows and may also reset the DM's colors. For more
information, refer to the help file for the DM rs command.
OPTIONS
-p pathname
Specify the file that contains the color values for red, green,
and blue. The format of this file should be identical to the
DM's color map file, `node_data/etc/dm_display/color_map. For
more information about the format of this file, please refer to
the manual Programming with Domain Graphics Primitives.
-r pathname
This option loads the true color map. If no pathname is given,
lcm loads the true color map from the file
`node_data/etc/dm_display/color_map.rgb. This option is
currently available only on the DN10000VS. The default color
map is a linear ramp that goes from 0 to 255 (0 0 0, 1 1 1, 2 2
2, etc.).
-l pathname
List the whole content of the display's color map to the file
specified by pathname. The output has the same format as a
`node_data/etc/dm_display/color_map file. The display's color
map is not changed when you use only this option.
If pathname is not supplied, this option writes to the standard
output file.
-s i r g b
Sets the color slot i to the rgb value specified. i is a
decimal integer, from 0 through 15 on 4-plane displays, and
from 0 through 255 on displays with 8 or more planes. r, g,
and b are integers ranging from 0 to 255 that represent the
brightness of the red, green, and blue components of the color
value at slot i. You may use more than one "-s" option if you
want to set more than one color slot.
-rgb332 This option loads the 8-plane color map required for hardware
dithering support of true color emulation (available only on
some graphics devices). If the -p option is not used, lcm loads
this color map from the file
`node_data/etc/dm_display/color_map.rgb332.
-rgb444 This option loads the 12-plane true color map. If the -p
option is not used, lcm loads the 12-plane true color map from
the file `node_data/etc/dm_display/color_map.rgb444. This
option is supported on the Series 10000VS. The default 12-
plane true color map is a 16-entry linear ramp. The color
values in these slots go from 0 0 0 to 255 255 255 in
increments of 17 (0 0 0 in color slot 0, 17 17 17 in color slot
1, 34 34 34 in color slot 2, etc).
-x This option restores the colors that the X client programs have
allocated in the default color map. Use this option when a GPR
program has overwritten the colors being used by the X Window
System. This option takes precedence over all other options;
if it is used with other options, the other options will be
ignored.
EXAMPLES
Load the DM's color map found in the file
`node_data/etc/dm_display/color_map.
$ lcm
Load the color map specified in the file my_colormap.
$ lcm -p my_colormap
Load the true color map.
$ lcm -r
Set color slot 0 to red.
$ lcm -s 0 255 0 0