DESCRIPTION

While running d.colors
the cursor must be inside the window where the execution takes place. When in "float" colormode, the correct colors appear on the graphics monitor only if the cursor is inside the monitor. To see the correct colors, move the cursor from the execution window to inside the graphics monitor, then move back to the window to continue making changes.

If d.colormode is "fixed", any color changes made using d.colors 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 d.colormode and d.colortable). Note that some graphics display monitors or drivers cannot support interactive color change.

The user must first display the relevant raster map layer to the active frame on the graphics monitor (e.g., using d.rast or d.display) before running d.colors. 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: d.colors map=soils), or type d.colors without program arguments. If the user simply types d.colors without program arguments on the command line, d.colors will ask the user to enter the name of an existing raster map layer using the standard GRASS interface described in the manual entry for parser.

In either case, the user is then presented with the d.colors command menu, shown below. This menu is the same as the category and color changing portion of the d.display menu. The d.colors 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 d.colors screen. On the d.colors 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.

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

Changing colors - The color associated with the current category can be changed with the "R, r, G, g, B," and b keys. The upper case letters increase the intensities of red R, green G, and blue 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.

Keys I and i increase and decrease the percentage change that each keystroke of one of the color keys (R, r, G, g, B, b) causes in its respective color. The increase increment is initially set to 10%. Thus, pressing the R key would will increase the red component of the current category by 10%.

Highlight - The h 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 h 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.

Saving the current color table - Pressing the c 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.

Color table toggle - Different types of color tables are suitable for different raster map layers. The key t flips between the following color tables: red, green, blue color ramp; gray scale; smooth changing color wave; random colors; and the saved color table.

Color table shift - The entire table is shifted up and down using the + and - keys.

Quitting the d.colors program - Pressing the Q key will cause you to quit the d.colors program. If colors have been modified but not saved, d.colors will ask:

         Colors changed
         Save the changes? (y/n)

         Quit anyway? (y/n) 

NOTES

The map whose color table is to be altered with d.colors must already be on display in the active display frame on the graphics monitor before d.colors is run. This can be done using the command d.rast map=name (where name is a raster map layer whose color table the user wishes to alter).

The user might type the following sequence of commands to interactively change the colors of a raster soils map:

d.colormode mode=float

d.erase

d.rast map=soils

d.colors