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 interactively.  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
       command	line;  in  this case, the program will prompt the user for the
       flag setting and parameter value using the standard GRASS parser inter-
       face.

   FFllaaggss::
       --oo     Overlay the named raster map layer onto whatever is already dis-
	      played in the active graphics frame. Any no data	areas  in  the
	      named  raster map will seem transparent, and reveal the underly-
	      ing image previously displayed in the graphics frame.  If the --oo
	      flag  is set, only cells containing non-null values will be dis-
	      played 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 display 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  Labora-
       tory

       _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)
