1.0;lcm (load_color_map), revision 3.0, 89/09/11
lcm (load_color_map) - load a color map.
usage: lcm [-p pathname] [-r] [-l] [-s <i> <r> <g> <b>] [-rbg444]
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 pseudo
color map from the file in `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 16 colors (that
is, color entries for color slots 0-15) are reloaded. If you specify a
pathname, lcm reads the given file and tries to load the colors
associated with the indexes.
NOTE
If there are direct mode graphics programs running that have changed the
color values for color slots 0-15, the execution changes the colors in
these windows as well as resetting the DM's colors.
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
This option loads the true color map. If the -p option is not
used, lcm loads the true color map from the file in
`node_data/etc/dm_display/color_map.rgb. This option is supported
on all true color nodes. The default true color map is a linear ramp
that goes from 0 to 255 (0 0 0, 1 1 1, 2 2 2, etc.).
-l Lists the contents of the display's color map. The output has
the same format as the color map in
`node_data/etc/dm_display/color_map. The display's color map
is not changed if you use this option.
-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.
-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 in
`node_data/etc/dm_display/color_map.rgb444. This option is supported
on the DN10000VS. 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).
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