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]
       [ccaattnnuumm_=_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 display.  Using, the "_-_f" flag, the program will
       cycle  through the standard 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)".  Hexidecimal color strings  must
       be  six	characters  where  each  pair represents the red,
       green and blue colors, respectively.  RGB values  must  be
       between 0 and 255 for each component.  Do not use any sep-
       arator besides a space between the RGB numbers.


       The user can optionally choose to restrict drawing  opera-
       tions  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  contain-
       ing spaces or any rgb(...) specification must be quoted to
       prevent the shell from splitting it  into  separate  argu-
       ments.


       The  routine  for handling holes in polygons is relatively
       slow.  Therefore, large maps containing a large number  of
       holes will suffer a significant 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 cur-
       rent 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_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_2 _$



GRASS 5.0						d.area(1)
