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



NNAAMMEE
       _d_._a_r_e_a - Draws selected polygons 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..aarreeaa	 [--ff]	mmaapp_=_n_a_m_e   [ffiillllccoolloorr_=_n_a_m_e]   [lliinneeccoolloorr_=_n_a_m_e]	 [ccaatt--
       nnuumm_=_v_a_l_u_e_[_,_v_a_l_u_e_,_._._._]]

   FFllaaggss::
       --ff     Fill all areas with color (cycle through standard GRASS colors)


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

       ffiillllccoolloorr
	      Color desired for filling polygons Default: white

       lliinneeccoolloorr
	      Color desired for polygons borders Default: none

       ccaattnnuumm List of area category number(s) to display


DDEESSCCRRIIPPTTIIOONN
       Use _d_._a_r_e_a to draw filled polygons from a vector map to the GRASS  dis-
       play.   Using,  the "_-_f" flag, the program will cycle through the stan-
       dard GRASS named colors, overriding any _f_i_l_l_c_o_l_o_r argument.  Otherwise,
       the color used for filling polygons is as specified.


       The  arguments  for  _f_i_l_l_c_o_l_o_r and _l_i_n_e_c_o_l_o_r can be any named X11 color
       (as found in grass5/etc/rgb.txt),  a  hexidecimal  color  string  (like
       "AFDF00"),  or an RGB triplet specified as "rgb(_r_e_d _g_r_e_e_n _b_l_u_e)".  Hex-
       idecimal color strings must be six characters where  each  pair	repre-
       sents the red, green and blue colors, respectively.  RGB values must be
       between 0 and 255 for each component.  Do not use any separator besides
       a space between the RGB numbers.


       The  user  can  optionally  choose  to  restrict  drawing operations to
       selected polygons by specifying one or more area category numbers using
       the _c_a_t_n_u_m argument.

NNOOTTEESS
       When  run  on the command line, any X11 color name containing spaces or
       any rgb(...) specification must be quoted to  prevent  the  shell  from
       splitting it into separate arguments.


       The  routine for handling holes in polygons is relatively slow.	There-
       fore, large maps containing a large number of holes will suffer a  sig-
       nificant performance penalty.

       It  is  the  intention of GRASS developers to create a better mechanism
       for persistent storage of vector drawing instructions in the future.

BBUUGGSS
       The program does not properly clip areas to match the  current  display
       extent (HHEELLPP WWAANNTTEEDD).

       There  is a slight disagreement between the output of d.vect and _d_._a_r_e_a
       regarding the map coordinate to	screen	coordinate  conversion.   This
       leads to undesirable results when both are used.

AAUUTTHHOORR
       CERL

       Modified by Eric G. Miller

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_3_/_0_3_/_1_6 _1_2_:_2_5_:_1_9 _$



GRASS 5.0							     d.area(1)
