d.colors(1)		      Grass User's Manual		   d.colors(1)



NNAAMMEE
       dd..ccoolloorrss - Allows the user to interactively change the color table of a
       raster map layer displayed on the graphics monitor.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..ccoolloorrss
       dd..ccoolloorrss hheellpp
       dd..ccoolloorrss mmaapp==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       A color table file associates specific colors with the categories of  a
       raster  map layer. The user can change these map category color assign-
       ments (i.e., change the map's color table) interactively, by first dis-
       playing	the  raster  map  to the graphics monitor and then running the
       program _d_._c_o_l_o_r_s.  If you have first set _d_._c_o_l_o_r_m_o_d_e to "float"	before
       displaying  the map to the graphics monitor, any color changes that you
       subsequently make while in  _d_._c_o_l_o_r_s  will  immediately	(and  interac-
       tively) appear on the graphics display.


       While running _d_._c_o_l_o_r_s
	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	graph-
       ics monitor, then move back to the window to continue making changes.


       If  _d_._c_o_l_o_r_m_o_d_e	is "fixed", any color changes made using _d_._c_o_l_o_r_s 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_._c_o_l_o_r_t_a_b_l_e).  Note
       that  some graphics display monitors or drivers cannot support interac-
       tive color change.


       The user must first display the relevant raster map layer to the active
       frame  on  the  graphics monitor (e.g., using _d_._d_i_s_p_l_a_y) before running
       _d_._c_o_l_o_r_s.  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: dd..ccoolloorrss map=soils), or type  dd..ccoolloorrss  without	program  argu-
       ments.	If the user simply types dd..ccoolloorrss without program arguments on
       the command line, _d_._c_o_l_o_r_s 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 _p_a_r_s_e_r.


       In either case, the user is then presented with	the  _d_._c_o_l_o_r_s  command
       menu,  shown  below.   This  menu is the same as the category and color
       changing portion of the _d_._d_i_s_p_l_a_y  menu.   The  _d_._c_o_l_o_r_s  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_._c_o_l_o_r_s screen. On the  _d_._c_o_l_o_r_s  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 categories - The keys ""dd,, DD,, uu,,"" and ""UU"" are used to move to a
       different category. The lower case letters move up, uu,, and down, dd,, 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.


       Changing colors - The color associated with the current category can be
       changed	with  the  ""RR,, rr,, GG,, gg,, BB,,"" and bb keys. The upper case letters
       increase the intensities of red RR,, green GG,, and blue BB 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 II and ii increase and decrease the percentage change that each key-
       stroke  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 hh 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 hh 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 cc key will save the  cur-
       rent  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 tt 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_._c_o_l_o_r_s program - Pressing the QQ key will	cause  you  to
       quit the _d_._c_o_l_o_r_s program.  If colors have been modified but not saved,
       _d_._c_o_l_o_r_s will ask:

		Colors changed
		Save the changes? (y/n)

       The user should type in yy to save changes, or nn to  not	save  changes,
       before  quitting  the  program.	 If the user types nn, the program will
       ask:

		Quit anyway? (y/n)


NNOOTTEESS
       To see map color changes reflected on the display monitor as  you  make
       them,  you  must  put  the  monitor  in _f_l_o_a_t color mode before running
       _d_._c_o_l_o_r_s. It is also wise to erase the display  screen  after  changing
       the color mode.


       The  map  whose color table is to be altered with _d_._c_o_l_o_r_s must already
       be on display in the active  display  frame  on	the  graphics  monitor
       before  _d_._c_o_l_o_r_s  is  run.  This  can  be done using the command dd..rraasstt
       mmaapp==_n_a_m_e (where _n_a_m_e 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 _s_o_i_l_s map:


       dd..ccoolloorrmmooddee mmooddee==_f_l_o_a_t dd..eerraassee dd..rraasstt mmaapp==_s_o_i_l_s dd..ccoolloorrss



       After the user has saved any  color  changes  made  with  _d_._c_o_l_o_r_s  and
       exited  the  program,  the user could then redisplay the _s_o_i_l_s map with
       the new colors by typing:


       dd..ccoolloorrmmooddee mode=fixed dd..eerraassee dd..rraasstt map=soils

       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 _d_._c_o_l_o_r_s that are saved will appear in the map's color table.


       Some monitors may not support an interactive color change capability.

SSEEEE AALLSSOO
       _d_._c_o_l_o_r_m_o_d_e

       _d_._c_o_l_o_r_t_a_b_l_e

       _d_._d_i_s_p_l_a_y

       _d_._r_a_s_t

       _p_._c_o_l_o_r_s

       _r_._c_o_l_o_r_s

       _p_a_r_s_e_r

AAUUTTHHOORR
       James  Westervelt,  U.S. Army Construction Engineering Research Labora-
       tory

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_3_/_0_8_/_2_0 _0_8_:_1_0_:_1_2 _$



GRASS 5.0							   d.colors(1)
