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 loca-
       tion (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 stan-
       dard input (i.e., the keyboard) and will (silently) prompt
       the  user  for  these graphics commands.  Alternately, 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  instruc-
	      tions.   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 process-
	      ing.

       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 coordinates stated in the map coordi-
	      nate  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  outside  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  cur-
	      rent  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 northing stated
	      in the map coordinate system of the user's  current
	      GRASS  location, and located within the user's cur-
	      rent 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 speci-
	      fied 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 current 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	location  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 difference 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 Laboratory

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