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



NNAAMMEE
       dd..ccoolloorrttaabbllee  - To display the color table associated with a raster map
       layer.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..ccoolloorrttaabbllee
       dd..ccoolloorrttaabbllee hheellpp
       dd..ccoolloorrttaabbllee mmaapp==_n_a_m_e [ccoolloorr==_n_a_m_e] [lliinneess==_v_a_l_u_e] [ccoollss==_v_a_l_u_e]

DDEESSCCRRIIPPTTIIOONN
       The GRASS program _d_._c_o_l_o_r_t_a_b_l_e is used to display the color table asso-
       ciated with a raster map layer in the active frame on the graphics mon-
       itor. The map _n_a_m_e should be an	available  raster  map	layer  in  the
       user's current mapset search path and location.



   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      Name  of	a raster map layer in the user's current mapset search
	      path whose color table is to be displayed.

       ccoolloorr==_n_a_m_e
	      Color of the lines separating the colors of the color table.
	      Options: red, orange, yellow, green, blue, indigo, violet, gray,
	      white, and black.
	      Default: _w_h_i_t_e

       lliinneess==_v_a_l_u_e
	      Number of lines to appear in the color table.
	      Options: 1 - 1000

       ccoollss==_v_a_l_u_e
	      Number of columns to appear in the color table.
	      Options:	1  - 1000 If the _v_a_l_u_es of both _l_i_n_e_s and _c_o_l_s are not
	      specified by the user, _d_._c_o_l_o_r_t_a_b_l_e  divides  the  active  frame
	      equally  among  the  number  of  categories present in the named
	      raster map layer. If one option is specified, the other is auto-
	      matically set to accommodate all categories.  If both are speci-
	      fied, as many categories as possible are displayed.



       The user can specify all needed parameters on the  command  line  using
       the form:


       dd..ccoolloorrttaabbllee mmaapp==_n_a_m_e [ccoolloorr==_n_a_m_e] [lliinneess==_v_a_l_u_e] [ccoollss==_v_a_l_u_e]



       If  the	user  specifies the name of a map on the command line but does
       not specify the values of other parameters,  parameter  default	values
       will  be  used.	 Alternately, if the user types simply dd..ccoolloorrttaabbllee on
       the command line without any program arguments, the program will prompt
       the  user for parameter settings using the standard GRASS parser inter-
       face described in the manual entry for _p_a_r_s_e_r.

EEXXAAMMPPLLEE
       The  user  running  the	command:  dd..ccoolloorrttaabbllee	mmaapp==_s_o_i_l_s  [ccoolloorr==_r_e_d]
       [lliinneess==_1] [ccoollss==_3]

       would  see the active graphics frame divided into three columns extend-
       ing the full frame height. The lines dividing the color	table  associ-
       ated with the _s_o_i_l_s map would be displayed in red.  The user would see,
       at most, only three of the colors from the _s_o_i_l_s color table  displayed
       in  the	active	frame  (because  the user requested that this frame be
       divided into three sections).

NNOOTTEESS
       If the user wishes to display the entire color table associated with  a
       map, the user should either stipulate a number of lines (rows) and col-
       umns (cols) sufficient to accommodate the number of categories  in  the
       map's  color  table,  or  fail to assign values to one or both of _l_i_n_e_s
       and/or _c_o_l_s.  If the user runs _d_._c_o_l_o_r_t_a_b_l_e using the default number of
       lines  and  columns  (the full graphics frame), all categories from the
       map's color table will be displayed. However, if the user requests that
       the  color  table associated with a map which has 10 data categories be
       displayed in a graphics frame with only 3 lines (rows) and 2 columns (a
       total  of  six  cells), only six of the ten map categories will be dis-
       played.


       The user should run the command dd..ccoolloorrmmooddee mmooddee==float  before  running
       _d_._c_o_l_o_r_t_a_b_l_e, for accurate display of the map's color table.


       The  user  should  run the GRASS program _d_._e_r_a_s_e between runs of _d_._c_o_l_-
       _o_r_t_a_b_l_e to avoid confusion.

SSEEEE AALLSSOO
       _d_._c_o_l_o_r_m_o_d_e

       _d_._c_o_l_o_r_s

       _d_._d_i_s_p_l_a_y

       _d_._e_r_a_s_e

       _d_._r_a_s_t

       _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.colortable(1)
