<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS: d.colors</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>d.colors</b></em> - Allows the user to interactively change the color table of a raster map layer displayed on the graphics monitor.
<h2>KEYWORDS</h2>
display
<h2>SYNOPSIS</h2>
<b>d.colors</b><br>
<b>d.colors help</b><br>
<b>d.colors</b> <b>map</b>=<em>string</em> [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Parameters:</h3>
<DL>
<DT><b>map</b>=<em>string</em></DT>
<DD>Name of raster map</DD>
</DL>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>d.colors</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>d.colors</b></em> - Allows the user to interactively change the
color table of a raster map layer displayed on the graphics monitor.
<h2>KEYWORDS</h2>
display
<h2>SYNOPSIS</h2>
<b>d.colors</b><br>
<b>d.colors help</b><br>
<b>d.colors</b> <b>map</b>=<em>string</em>
<h3>Parameters:</h3>
<DL>
<DT><b>map</b>=<em>string</em>
<DD>Name of raster map</DD>
</DL>
<H2>DESCRIPTION</H2>
A color table file associates specific colors with the categories of a
raster map layer. The user can change these map category color assignments
(i.e., change the map's color table) interactively, by first displaying the
raster map to the graphics monitor and then running the program
<EM>d.colors</EM>.
<P>
Any color changes made using <EM>d.colors</EM> will not immediately be
shown on the graphics display; however, any color changes saved will
still alter the map's color table and will appear next time the raster
map layer is redisplayed (see <EM><A HREF="d.colortable.html">d.colortable</A></EM>).
<P>
The user must first display the relevant raster map layer to the
active frame on the graphics monitor (e.g., using
<EM><A HREF="d.rast.html">d.rast</A></EM>) before running
<EM>d.colors</EM>. The user can then either enter the name of the
raster map layer whose color table is to be changed on the command
line (e.g., by typing: <tt>d.colors map=soils</tt>), or type
<tt>d.colors</tt> without program arguments. If the user simply types
<tt>d.colors</tt> without program arguments on the command line,
<EM>d.colors</EM> will ask the user to enter the name of an existing
raster map layer using the standard GRASS interface.
<P>
In either case, the user is then presented with the <EM>d.colors</EM>
command menu, shown below. This menu is the same as the category and color
changing portion of the <EM><A HREF="d.display.html">d.display</A></EM>
menu. The <EM>d.colors</EM> commands are listed beneath the Category
Pointer Movement, Color Modification, Replotting Screen, and Quitting
sections below. Commands are invoked by typing in the single-key response
shown to the left below. (Longer descriptions of these commands appear to
the right.) Results from invoking these commands will be reflected in the
Category and Category Number sections of the <EM>d.colors</EM> screen. On
the <EM>d.colors</EM> screen menu, commands appear in the right half of the
screen, and the current status of categories appears in the left half of the
screen.
<PRE>
CATEGORIES
0 No Data
1 (Category 1 description)
2 (Category 2 description)
. ....
. ....
CATEGORY NUMBER:
RED 0 0%
GREEN 0 0%
BLUE 0 0%
Shift Incr: 10 3%
CATEGORY POINTER MOVEMENT
D/d down (cats) Move pointer to next category
U/u up (cats) Move pointer to previous category
COLOR MODIFICATIONS
R/r RED Increase/decrease RED intensity
G/g GREEN Increase/decrease GREEN intensity
B/b BLUE Increase/decrease BLUE intensity
I/i increment Increase/decrease increment
(of intensity shift)
h highlight Highlight current color
+/- shift colors Shift entire color table (up/down)
c save color Save color table
t toggle table Toggle to different color table
REPLOTTING SCREEN
* Replot screen Replots the screen
QUITTING
Q quit Quits program
</PRE>
Changing categories - The keys
<B>"d, D, u,"</B>
and
<B>"U"</B>
are used to move to a different category. The lower case letters move up,
<B>u,</B>
and down,
<B>d,</B>
the category list one category at a time. The upper case letters move 10
categories at a time for fast movement. The cursor does wrap between the
first and last categories. The current category is noted on the text screen
with an arrow, and is indicated on the graphics screen by a box around the
current color.
<P>
Changing colors - The color associated with the current category can be
changed with the
<B>"R, r, G, g, B,"</B>
and
<B>b</B>
keys. The upper case letters increase the intensities of
red
<B>R,</B>
green
<B>G,</B>
and blue
<B>B</B>
for the current category; the lower case letters decrease the intensities of
these same colors for the current category. Video devices make all the
colors of the spectrum by mixing red, green, and blue. For those
accustomed to red, yellow, and blue being the primary colors, this can
be confusing. For starters, yellow is made by mixing red and green. The
intensities are listed on the text screen in as percentages.
<P>
Keys <B>I</B> and <B>i</B> increase and decrease the
percentage change that each keystroke of one of the color
keys (<EM>R, r, G, g, B, b</EM>) causes in its respective
color. The increase increment is initially set to 10%.
Thus, pressing the <EM>R</EM> key would will increase the
red component of the current category by 10%.
<P>
Highlight - The
<B>h</B>
key toggles between the current category color and the current
highlight color. This color is initially black but can be modified as
above while in highlight mode. Blinking can be accomplished by repeatedly
striking the
<B>h</B>
key. When changing to different categories using the movement keys as
described above, while in highlight mode the category colors will be
always left showing their actual colors. Only one category is highlighted
at any one time.
<P>
Saving the current color table -
Pressing the <B>c</B> key will save the current color table as you have
modified it. This table will then be used next time you
display or paint this raster map layer.
<P>
Color table toggle - Different types of color tables are suitable for
different raster map layers.
The key
<B>t</B>
flips between the following color tables: red, green, blue color ramp; gray
scale; smooth changing color wave; random colors; and the saved color table.
<P>
Color table shift - The entire table is shifted up and down using the
<B>+</B>
and
<B>-</B>
keys.
<P>
Quitting the <EM>d.colors</EM> program - Pressing the
<B>Q</B> key will cause you to quit the <EM>d.colors</EM>
program. If colors have been modified but not saved,
<EM>d.colors</EM> will ask:
<PRE>
Colors changed
Save the changes? (y/n)
</PRE>
The user should type in <B>y</B> to save changes,
or <B>n</B> to not save changes, before quitting the program.
If the user types <B>n</B>, the program will ask:
<PRE>
Quit anyway? (y/n)
</PRE>
<H2>NOTES</H2>
<P>
The map whose color table is to be altered with
<EM>d.colors</EM> must already be on display in the active
display frame on the graphics monitor before
<EM>d.colors</EM> is run. This can be done using the
command <B><A HREF="d.rast.html">d.rast</A>
map=</B><EM>name</EM> (where <EM>name</EM> is a raster map
layer whose color table the user wishes to alter).
<P>
Some color monitors may not support the full range of colors required
to display all of the map's categories listed in the map's color table.
However, regardless of whether the user can see the color changes he is
effecting to a map's color table, any changes to a map's color table
made with <EM>d.colors</EM> that are saved will appear in the map's color table.
<H2>SEE ALSO</H2>
<EM><A HREF="d.colortable.html">d.colortable</A></EM><br>
<EM><A HREF="d.rast.html">d.rast</A></EM><br>
<EM><A HREF="r.colors.html">r.colors</A></EM><br>
<H2>AUTHOR</H2>
James Westervelt, U.S. Army Construction Engineering
Research Laboratory
<p>
<i>Last changed: $Date: 2007-04-11 15:45:53 +0200 (Wed, 11 Apr 2007) $</i>
<HR>
<P>
<a href=index.html>Help Index</a>
</p>
</body>
</html>
