d.vect.area(1)	       Grass User's Manual	   d.vect.area(1)



NNAAMMEE
       _d_._a_r_e_a - Draws vector areas to the GRASS display

       _(_G_R_A_S_S _D_i_s_p_l_a_y_/_V_e_c_t_o_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..vveecctt..aarreeaa  [--rr]  mmaapp_=_n_a_m_e  [ffiillllccoolloorr_=_n_a_m_e_|_R_:_G_:_B] [lliinnee--
       ccoolloorr_=_n_a_m_e_|_R_:_G_:_B]    [ccaattnnuumm_=_v_a_l_u_e_[_,_v_a_l_u_e_,_._._._]]	    [lleegg--
       eenndd_=_f_i_l_e_n_a_m_e_|_"_-_"]

   FFllaaggss::
       --rr     Fill  all areas with a randomly selected color from
	      a small color palette, and draw all  boundaries  in
	      black.  The  palette  is similar to the GRASS named
	      colors, but replaces white  and  black  with  other
	      colors.


   PPaarraammeetteerrss::
       mmaapp    Name of existing vector map to be displayed

       ffiillllccoolloorr
	      Color  desired  for filling polygons. May be speci-
	      fied as a standard grass color name, or as  an  RGB
	      triplet (e.g. 80:198:255).  Fill can be disabled by
	      specifying a color of "none".  Default: white

       lliinneeccoolloorr
	      Color desired for drawing area boundaries.  May  be
	      specified  as a standard grass color name, or as an
	      RGB triplet (e.g. 127:127:127).  Line  drawing  can
	      be  disabled  by	specifying  a  color  of  "none".
	      Default: black

       ccaattnnuumm List of category numbers to  restrict  which  areas
	      are  drawn.   Ignored  if either the _-_r flag or the
	      _l_e_g_e_n_d options are used.

       lleeggeenndd Name of a legend file specifying what color to  use
	      for each category (see below). If "-" is specified,
	      the  legend  will  be  read  from  standard  input.
	      Default: none


DDEESSCCRRIIPPTTIIOONN
       Use  _d_._v_e_c_t_._a_r_e_a  to draw labelled areas from a vector map
       to the GRASS display.  Using, the "_-_r" flag,  the  program
       will  cycle  through a small color palette, overriding any
       _f_i_l_l_c_o_l_o_r or _l_i_n_e_c_o_l_o_r argument.   If  a  _l_e_g_e_n_d  file  is
       specified, it will be used.  Otherwise, the color used for
       filling areas is as specified.


       The _f_i_l_l_c_o_l_o_r argument may be any of  the  standard  named
       GRASS  colors,  or and RGB (red, green, blue) triplet.  An
       RGB triplet must have the  form	_:_:_<_;_n_u_m_>_;  where  _n_u_m  is
       between	0  and 255.  If "none" is specified, no fill will
       be done.  Specifying "none" does not make  sense  for  the
       random color option, since it always draws lines in black.


       The _l_i_n_e_c_o_l_o_r argument specifies  the  color  to  use  for
       drawing	area  boundary	lines.	It has the same format as
       _f_i_l_l_c_o_l_o_r, and also accepts the "none"  color  to  disable
       line drawing.


       An  optional  list  of  category  numbers  may  be used to
       restrict which areas are drawn (only valid with the  _f_i_l_l_-
       _c_o_l_o_r and _l_i_n_e_c_o_l_o_r options).


       More control can be had by creating a _l_e_g_e_n_d file.  At the
       time of this writing, GRASS does not have  any  management
       functions  for  specifying how vectors should be drawn, so
       this file must be created by "hand".  The easiest  way  to
       create  such  a file, is to copy the category file for the
       vector map, and edit it to contain  color  specifications.
       The  format  of the _l_e_g_e_n_d file is _c_a_t_e_g_o_r_y _r_e_d _g_r_e_e_n _b_l_u_e
       _[_r_e_d _g_r_e_e_n _b_l_u_e_], with one entry per line.  The first  RGB
       color  specifies the fill color, while the optional second
       one specifies the boundary line color.  If a category  for
       a  map  is not included in this file, it will not be drawn
       unless there is a special "default" entry with a  category
       of  -1.	 Boundary  lines  are  not  drawn unless either a
       boundary color is specified for the category, or there  is
       a  default  boundary  color.  Using the keyword "none" for
       either _f_i_l_l_c_o_l_o_r or _l_i_n_e_c_o_l_o_r in conjunction with a legend
       will override drawing fill or boundary lines.

       EExxaammppllee LLeeggeenndd FFiillee
	      -1 255 255 255 127 127 127

	      1  210 198 168

	      5  168 198 220




       In  the	above,	all labelled areas will be drawn in white
       (255, 255, 255) with dark gray boundaries (127, 127,  127)
       except  those  labelled	as  categories	1  or  5.  If the
       "default" entry had been omitted, then only areas labelled
       1 or 5 would have been drawn.  Since the entries for 1 and
       5 don't specify a color for boundary  lines,  no  boundary
       lines are drawn.


       One  may  place comments on any line in the legend file by
       starting it with a non-numeric character ('#'  is  a  good
       choice).  Empty lines are ignored.

NNOOTTEESS
       It  is  expected  that  the legend specification aspect of
       this module will change when an infrastructure for  manag-
       ing vector drawing styles is implemented.

AAUUTTHHOORR
       Eric G. Miller

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_2_/_2_5 _0_4_:_1_8_:_5_2 _$



GRASS 5.0					   d.vect.area(1)
