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



NNAAMMEE
       dd..mmeeaassuurree  -  Measures  the  lengths and areas of features drawn by the
       user 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..mmeeaassuurree
       dd..mmeeaassuurree hheellpp
       dd..mmeeaassuurree [--sskkmm] [cc11==_n_a_m_e] [cc22==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       _d_._m_e_a_s_u_r_e provides the user with an  interactive  way  to  measure  the
       lengths and areas of lines and polygons drawn by the user in the active
       frame on the graphics monitor.  Lines and polygons are  drawn  using  a
       pointing  device  (mouse).  Each line segment is drawn in colors _c_1 and
       _c_2.  A mouse button menu indicates that the user can find out the  geo-
       graphic	coordinates of the cursor location, draw line segments between
       user-specified vertices, and quit _d_._m_e_a_s_u_r_e.  Lines  and  polygons  are
       defined	by the series of vertices marked by the user. If more than two
       successive vertices are drawn, _d_._m_e_a_s_u_r_e prints	the  area  encompassed
       (_d_._m_e_a_s_u_r_e  will  assume  the  area  is closed even if the user has not
       joined the first and last vertices).  Line lengths are  stated  in  the
       same units as those of the current LOCATION. In a XY-LOCATION, where no
       units are available, _d_._m_e_a_s_u_r_e prints a warning and gives results with-
       out  units.   Areas are stated in hectares, square miles, square meters
       and square kilometers.  Lines and polygons drawn using  _d_._m_e_a_s_u_r_e  will
       overlay	(not  overwrite)  whatever  display  currently	appears in the
       active frame on the graphics monitor.  The user can, for  example,  run
       _d_._r_a_s_t or _d_._v_e_c_t prior to running _d_._m_e_a_s_u_r_e, and use raster and/or vec-
       tor maps as a backdrop.

OOPPTTIIOONNSS
       The user can specify the colors in which line segments will be drawn by
       setting the values of _c_1 and _c_2 on the command line.  Default line col-
       ors (see below) will be used if the user does not specify the values of
       _c_1 and _c_2 on the command line.

   FFllaaggss
       --ss     Suppesses  clear screen and writes messages to stderr instead of
	      stdout. Usefull for work with the TCLTKGRASS gui.

       --mm     Use metric units (meters, kilometers) only

       --kk     Output results (additionally) in kilometers and  square  kilome-
	      ters


   PPaarraammeetteerrss::
       cc11==_n_a_m_e
	      The first color in which each line segment is drawn, while being
	      positioned.
	      Options: red,  orange,  yellow,  green,  blue,  indigo,  violet,
	      magenta, brown, gray, white, and black
	      Default: _w_h_i_t_e

       cc22==_n_a_m_e
	      The  second color in which each line segment is drawn, after its
	      vertices are fixed.  Options: Same as _c_1.
	      Default: _w_h_i_t_e


NNOOTTEESS
       _d_._m_e_a_s_u_r_e uses all segments drawn by the user when computing area.   If
       the  user  draws an area within another area, the combined area of both
       regions will be output.

SSEEEE AALLSSOO
       _d_._d_i_s_p_l_a_y

       _d_._f_r_a_m_e

       _d_._g_r_a_p_h

       _d_._m_a_p_g_r_a_p_h

       _d_._r_a_s_t

       _d_._v_e_c_t

       _d_._w_h_e_r_e

AAUUTTHHOORRSS
       James Westervelt,
       Michael Shapiro,

       U.S. Army Construction Engineering Research Laboratory



GRASS 5.0							  d.measure(1)
