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] [lliinneeccoolloorr_=_n_a_m_e_|_R_:_G_:_B]
       [ccaattnnuumm_=_v_a_l_u_e_[_,_v_a_l_u_e_,_._._._]]  [lleeggeenndd_=_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 simi-
	      lar 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 specified as a stan-
	      dard 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 cat-
	      egory  (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  for-
       mat  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	speci-
       fied 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 cat-
       egories	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 managing 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)
