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



NNAAMMEE
       dd..mmaappggrraapphh   -  Generates  and  displays  simple graphics on map layers
       drawn in the active graphics monitor display frame.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..mmaappggrraapphh
       dd..mmaappggrraapphh hheellpp
       dd..mmaappggrraapphh [iinnppuutt==_n_a_m_e] [ccoolloorr==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       _d_._m_a_p_g_r_a_p_h  draws  graphics  that  are  described  in  standard	 input
       (default)  or  the  UNIX  input	file _n_a_m_e. If commands are entered via
       standard input, a _c_t_r_l_-_d is used to signal the end of input  to	_d_._m_a_p_-
       _g_r_a_p_h.  This program performs essentially the same function as _d_._g_r_a_p_h;
       however, point locations are specified to _d_._m_a_p_g_r_a_p_h in the  geographic
       coordinate  system  of the user's current mapset and location (i.e., in
       map coordinates), rather than in graphics display screen coordinates.


       The program can be run interactively or	non-interactively.   The  user
       can run the program completely non-interactively by specifying the name
       of a file containing _d_._m_a_p_g_r_a_p_h graphics commands and the values of all
       needed  parameters  on the command line.  The user can instead elect to
       run the program partially interactively, by specifying any/all  of  the
       parameters  _e_x_c_e_p_t  the	graphics  iinnppuutt==_n_a_m_e  parameter on the command
       line.  In this case, _d_._m_a_p_g_r_a_p_h will expect the user  to  input	_d_._m_a_p_-
       _g_r_a_p_h  graphics	commands  from standard input (i.e., the keyboard) and
       will (silently) prompt the user for these  graphics  commands.	Alter-
       nately, the user can simply type dd..mmaappggrraapphh on the command line, and be
       prompted for the values of all parameters (the  user  can  still  input
       graphics  commands  from  an input file using this form.) In this case,
       the user is presented with the standard GRASS _p_a_r_s_e_r interface.

OOPPTTIIOONNSS
   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name of a UNIX file containing graphics  instructions.   Specify
	      the  full path name of the file if not in the current directory.
	      If no file name is  given,  commands  are  taken	from  standard
	      input.

       ccoolloorr==_n_a_m_e
	      Starting color desired for graphics.
	      Options:	red,  orange,  yellow,	green,	blue,  indigo, violet,
	      magenta, brown, gray, white, and black.
	      Default: _w_h_i_t_e

       _d_._m_a_p_g_r_a_p_h is used for drawing simple graphics on top  of  map  layers.
       The coordinate system used by _d_._m_a_p_g_r_a_p_h is the same as that of the map
       layer displayed in the active display frame on the graphics monitor (or
       that of the user's current region, if no map is displayed).


       The graphics language is simple and uses the following commands:

       ## _c_o_m_m_e_n_t
	      A line of comment which is ignored in the processing.

       mmoovvee _x_p_o_s _y_p_o_s
	      The  current  location  is  updated  to  _x_p_o_s _y_p_o_s (where these,
	      respectively, are the easting and northing of geographic coordi-
	      nates  stated in the map coordinate system of the user's current
	      GRASS location, falling within the  current  region  and	active
	      frame).	If  unspecified  by  the  user,  the  current location
	      becomes (0,0).  If, as most likely, the point (0,0)  falls  out-
	      side of the user's current region, graphics drawn there will not
	      appear in the graphics frame.


       Note: use _g_._r_e_g_i_o_n to obtain the coordinates of current location.   Use
       _d_._w_h_e_r_e	to  obtain  specific  map coordinates of various points on the
       raster map displayed in the active frame.
       Note: there must be a space between _x_p_o_s and _y_p_o_s.

       ddrraaww _x_p_o_s ypos
	      A line is drawn in the current color from the  current  location
	      to  the  new  location _x_p_o_s _y_p_o_s, which then becomes the current
	      location.  _x_p_o_s and _y_p_o_s are (respectively) an easting and  nor-
	      thing  stated in the map coordinate system of the user's current
	      GRASS location, and located within the user's current geographic
	      region and active frame.


       Note: there must be a space between _x_p_o_s and _y_p_o_s.

       ccoolloorr _c_o_l_o_r
	      Sets  the current color to that stated.  Color options are: _r_e_d,
	      _o_r_a_n_g_e, _y_e_l_l_o_w, _g_r_e_e_n, _b_l_u_e,  _i_n_d_i_g_o,  _v_i_o_l_e_t,  _m_a_g_e_n_t_a_,	_b_r_o_w_n,
	      _g_r_a_y, _w_h_i_t_e, and _b_l_a_c_k.

       ssiizzee _x_p_e_r _y_p_e_r
	      Subsequent text will be drawn such that the text is _x_p_e_r percent
	      of the display frame's width and _y_p_e_r  percent  of  the  display
	      frame  height.   If  not	specified  by  the user, the text size
	      becomes 5 percent of the active frame's width and 5  percent  of
	      the frame's height.  This is equivalent to entering ssiizzee 55 55.

       tteexxtt _l_i_n_e_-_o_f_-_t_e_x_t
	      The  stated text is drawn at the current location using the cur-
	      rent color and the current size.

       iiccoonn _t_y_p_e _s_i_z_e _x _y
	      Draws an icon of types o, x, or + with specified size  at  loca-
	      tion x,y.  Note: type o designates a square.

       ppoollyyggoonn
	       _x_p_o_s _y_p_o_s

	       _x_p_o_s _y_p_o_s




	      The map coordinates appearing on lines beneath the word _p_o_l_y_g_o_n,
	      one pair per line, circumscribe a polygon which is to be	filled
	      with the current color.


NNOOTTEESS
       _d_._m_a_p_g_r_a_p_h  is identical to the _d_._g_r_a_p_h command, except for the differ-
       ence in coordinate systems used.


       _d_._m_a_p_g_r_a_p_h will complain if the user enters something to standard input
       that it does not understand.  Blank lines in the input file will result
       in this error message.

SSEEEE AALLSSOO
       _d_._f_r_a_m_e

       _d_._g_r_a_p_h

       _d_._r_a_s_t

       _d_._z_o_o_m

       _g_._r_e_g_i_o_n

       _g_r_a_s_s_._l_o_g_o_._s_h

       _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_1_/_2_5 _0_5_:_4_5_:_3_3 _$



GRASS 5.0							 d.mapgraph(1)
