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



NNAAMMEE
       dd..ccoolloorrmmooddee  -  Allows the user to establish whether a map will be dis-
       played using its own color table or the fixed color table of 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..ccoolloorrmmooddee
       dd..ccoolloorrmmooddee hheellpp
       dd..ccoolloorrmmooddee mmooddee==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _d_._c_o_l_o_r_m_o_d_e  establishes  what color table will be used to display maps
       to the graphics monitor.



   PPaarraammeetteerrss::
       mmooddee==_n_a_m_e
	      Options: _f_i_x_e_d or _f_l_o_a_t



       Each time a new raster map layer is drawn on the screen, a color  table
       associated  with  that map is loaded into the graphics display monitor.
       The command dd..ccoolloorrmmooddee mmooddee==ffiixxeedd requests that  the  monitor's  color
       look-up table be _f_i_x_e_d (i.e., static).  The effect is that colors drawn
       on the screen by graphics calls will not change	when  subsequent  maps
       are  drawn to the screen.  When the _f_i_x_e_d option is used, the colors in
       the map's color table are mapped to the nearest colors available in the
       monitor's  fixed color table.  When the _f_l_o_a_t option is used, the map's
       color table is loaded directly into the monitor's color look-up	table.


       There  are  advantages  to using each color display mode. The _d_._d_i_s_p_l_a_y
       and _d_._c_o_l_o_r_s programs allow the user to interactively modify the  color
       tables  of  maps  displayed  to	the graphics monitor.  This is done by
       allowing the user to directly modify the monitor's color look-up table.
       Hence, to accommodate this option in _d_._c_o_l_o_r_s, the _f_l_o_a_t option is cho-
       sen.  However, this option has  the  sometimes  undesirable  effect  of
       changing  the  colors in which other maps are subsequently displayed to
       the graphics monitor (although it does not actually  change  the  _c_o_l_o_r
       _t_a_b_l_e_s  of  these  latter maps).  The _f_l_o_a_t colormode is therefore best
       used when the user wishes to interactively change a map's color	table,
       or  when  the  user  wishes to display one or more maps having the same
       color table.  The _f_i_x_e_d option allows any number of  maps  to  be  dis-
       played to the screen, where each map uses different colors, but all use
       the same fixed color look-up table.  You cannot toggle  a  map's  color
       table when running in fixed mode.


       This  program  will  be run non-interactively if the user specifies the
       color _m_o_d_e on the command line (e.g., by typing dd..ccoolloorrmmooddee  mmooddee==ffiixxeedd
       or  dd..ccoolloorrmmooddee	mmooddee==ffllooaatt).   Alternately,  if  the user simply types
       dd..ccoolloorrmmooddee on the command line, the program will prompt the  user  for
       the color mode using the standard GRASS _p_a_r_s_e_r interface.

NNOOTTEESS
       Some devices support only a fixed color look-up. Whether or not XDRIVER
       supports float mode depends upon the X display in use; modes with  more
       than  256  colors  usually only support fixed mode. The number of color
       categories capable of being displayed is also device-dependent; if your
       colors fall outside this range when in _f_l_o_a_t mode, they may not be _d_i_s_-
       _p_l_a_y_e_d in the colors indicated in the map's color table file.  However,
       the  color  table files themselves will accurately represent the user's
       changes.


       Color table files associated with raster map layers are stored  in  the
       user's current mapset under the _c_o_l_r and _c_o_l_r_2 directories.

BBUUGGSS
       It  is  strongly  recommended  that the user erase the graphics monitor
       screen (e.g., by running _d_._e_r_a_s_e) immediately after changing  the  mode
       between _f_i_x_e_d and _f_l_o_a_t_.

SSEEEE AALLSSOO
       _d_._c_o_l_o_r_s_,

       _d_._c_o_l_o_r_t_a_b_l_e_,

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