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



NNAAMMEE
       dd..ccoolloorrmmooddee  -  Allows the user to establish whether a map
       will be displayed using its own color table or  the  fixed
       color table of the graphics 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 sub-
       sequent 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 interac-
       tively  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  chosen.   However, this option has the sometimes unde-
       sirable 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 displayed 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 dis-
       play  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 col-
       ors 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  them-
       selves 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 graph-
       ics 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 Laboratory

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_2_/_1_9 _0_7_:_3_5_:_0_8 _$



GRASS 5.0					   d.colormode(1)
