Provided by: grass-doc_6.4.3-3_all bug


       d.mapgraph   -  Generates  and  displays simple graphics on map layers drawn in the active
       graphics monitor display frame.


       display, cartography


       d.mapgraph help
       d.mapgraph  [input=string]   [color=string]   [--verbose]  [--quiet]

           Unix file containg graphing instructions, if not given reads from standard input

           Color to draw with, either a standard GRASS  color  or  R:G:B  triplet  (separated  by
           Default: black

   This module is superseded and scheduled for demolition.
       Please use "d.graph -m" instead.


       d.mapgraph draws graphics that are described in standard input (default) or the UNIX input
       file name. If commands are entered via standard input, a ctrl-d is used to signal the  end
       of  input  to  d.mapgraph. This program performs essentially the same function as d.graph;
       however, point locations are specified to d.mapgraph 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.mapgraph
       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 except the graphics input=name parameter on the command line.   In  this  case,
       d.mapgraph  will expect the user to input d.mapgraph graphics commands from standard input
       (i.e., the keyboard) and will (silently) prompt the  user  for  these  graphics  commands.
       Alternately,  the user can simply type d.mapgraph 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
       g.parser interface.

       d.mapgraph is used for drawing simple graphics on  top  of  map  layers.   The  coordinate
       system  used  by  d.mapgraph  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

       The graphics language is simple and uses the following commands:

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

       move xpos ypos
              The  current  location  is updated to xpos ypos (where these, respectively, are the
              easting and northing of geographic coordinates 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 outside of the user's current region, graphics
              drawn there will not appear in the graphics frame.

       Note: use g.region to obtain the coordinates of current location.  Use d.where  to  obtain
       specific  map  coordinates  of  various  points  on the raster map displayed in the active
       Note: there must be a space between xpos and ypos.

       draw xpos ypos
              A line is drawn in the current color from the current location to the new  location
              xpos   ypos,   which  then  becomes  the  current  location.   xpos  and  ypos  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 current geographic
              region and active frame.

       Note: there must be a space between xpos and ypos.

       color color
              Sets the current color to that stated.  Color options  are:  red,  orange,  yellow,
              green,  blue,  indigo, violet, magenta, brown, gray, white, black, an R:G:B triplet
              (separated by colons), or the word "none" (draws in the default background color).

       size xper yper
              Subsequent text will be drawn such that the text is xper  percent  of  the  display
              frame's  width  and  yper 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 size 5 5.

       text line-of-text
              The  stated  text  is drawn at the current location using the current color and the
              current size.

       icon type size x y
              Draws an icon of types o, x, or + with specified size at location x,y.  Note:  type
              o designates a square.

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


       d.mapgraph is identical to the d.graph command, except for the  difference  in  coordinate
       systems  used. In the future functionality will be merged into d.graph and d.mapgraph will
       be removed.

       d.mapgraph 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.


       Draw some text in the center of the display:
          EAST=`g.region -c | grep east | cut -f2 -d:`
          NORTH=`g.region -c | grep north | cut -f2 -d:`
          d.mapgraph << EOF
            move $EAST $NORTH
            text GRASS




       James Westervelt, U.S. Army Construction Engineering Research Laboratory

       Last changed: $Date: 2011-11-08 03:29:50 -0800 (Tue, 08 Nov 2011) $

       Full index

       © 2003-2013 GRASS Development Team