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



NNAAMMEE
       dd..rraasstt  -  Displays  and overlays raster map layers in the
       active display frame 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..rraasstt
       dd..rraasstt hheellpp
       dd..rraasstt  [--ooii]   mmaapp==_n_a_m_e   [ccaattlliisstt==_l_i_s_t]   [vvaalllliisstt==_l_i_s_t]
       [bbgg==_c_o_l_o_r]

DDEESSCCRRIIPPTTIIOONN
       _d_._r_a_s_t  displays  the  raster map layer _n_a_m_e in the active
       display frame on the graphics monitor.


       The program can be run either non-interactively or  inter-
       actively.   If the user specifies the name of a raster map
       layer (mmaapp==_n_a_m_e) and (optionally) the  --oo  option  on  the
       command	line,  the  program  will  run non-interactively.
       Alternately, the user can type simply dd..rraasstt on	the  com-
       mand  line; in this case, the program will prompt the user
       for the flag setting and parameter value using  the  stan-
       dard GRASS parser interface.

   FFllaaggss::
       --oo     Overlay the named raster map layer onto whatever is
	      already displayed in the active graphics frame. Any
	      no  data	areas  in  the named raster map will seem
	      transparent, and reveal the underlying image previ-
	      ously  displayed	in the graphics frame.	If the --oo
	      flag is set, only cells containing non-null  values
	      will  be	displayed  from  the _o_v_e_r_l_a_i_d raster map.
	      All other areas (i.e., the portions of the overlaid
	      map  that  are null) will leave the underlying dis-
	      play untouched.  If the --oo flag is not set  by  the
	      user, _d_._r_a_s_t will (by default) completely overwrite
	      whatever appears in  the	active	graphics  display
	      frame.

       --ii     Invert catlist.


   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      Name  of	the  raster  map to be displayed.  If the
	      active graphics  frame  already  contains  text  or
	      graphics,  and the user does not wish to use the --oo
	      option, it is wise to first invoke _d_._e_r_a_s_e to clear
	      the  active  graphics  frame before running _d_._r_a_s_t.
	      After running _d_._r_a_s_t other _d_.  programs like _d_._v_e_c_t
	      and _d_._g_r_i_d can be used to enhance the plot.

       ccaattlliisstt==_l_i_s_t
	      List of categories to be displayed (INT maps).

       vvaalllliisstt==_l_i_s_t
	      List of values to be displayed (FP maps).

       bbgg==_c_o_l_o_r
	      Background color for null.


NNOOTTEESS
       The  _d_._r_a_s_t raster map overlay option (--oo) only works when
       the color look-up table for the graphics monitor is set to
       dd..ccoolloorrmmooddee ffiixxeedd.

SSEEEE AALLSSOO
       _d_._c_o_l_o_r_m_o_d_e

       _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_._g_r_i_d

       _d_._r_a_s_t_._l_a_b_e_l_s

       _d_._v_e_c_t

       _d_._w_h_a_t_._r_a_s_t

       _r_._r_e_c_l_a_s_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_4_/_1_2 _0_1_:_4_4_:_0_9 _$



GRASS 5.0						d.rast(1)
