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  graph-
       ics 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  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 _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 interactively) 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  graphics
       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
       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_._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  typ-
       ing: dd..ccoolloorrss map=soils), or type dd..ccoolloorrss without program
       arguments.  If the user simply types dd..ccoolloorrss without pro-
       gram  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 Cate-
       gory  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 cate-
       gory
       COLOR MODIFICATIONS
	  R/r  RED		  Increase/decrease RED intensity
	  G/g	GREEN		   Increase/decrease GREEN inten-
       sity
	  B/b  BLUE		  Increase/decrease  BLUE  inten-
       sity
	  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,  yel-
       low  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 keystroke of one of the color keys (_R_, _r_, _G_, _g_,
       _B_, _b) causes in its respective color. The increase  incre-
       ment  is  initially  set to 10%.  Thus, pressing the _R key
       would will increase the red component of the current cate-
       gory by 10%.


       Highlight - The hh key toggles between the current category
       color and the current highlight color. This color is  ini-
       tially  black  but can be modified as above while in high-
       light 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 high-
       light 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 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 tt flips
       between the following color tables: red, green, blue color
       ramp;  gray scale; smooth changing color wave; random col-
       ors; 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 col-
       ors 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 Laboratory

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_2 _$



GRASS 5.0					      d.colors(1)
