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



NNAAMMEE
       _d_._a_r_e_a - Draws labelled vector lines 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..lliinnee  mmaapp_=_n_a_m_e  [ccoolloorr_=_n_a_m_e_|_R_:_G_:_B]  [ccaattnnuumm_=_i_[_,_j_,_k_,_._._._,_n_]] [lleegg--
       eenndd_=_f_i_l_e_n_a_m_e_|_"_-_"]

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

       ccoolloorr  Color desired for drawing lines. May be specified as a  standard
	      grass  color  name,  or  as  an  RGB  triplet (e.g. 80:198:255).
	      Default: white

       ccaattnnuumm List of category numbers to  restrict  which  lines  are	drawn.
	      Ignored if the _l_e_g_e_n_d option is 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_._l_i_n_e  to draw labelled lines from a vector map to the GRASS
       display.  By default, _d_._v_e_c_t_._l_i_n_e will draw all labelled lines  in  the
       vector  map with white.	The lines drawn may be restricted via the _c_a_t_-
       _n_u_m argument or by using a _l_e_g_e_n_d file.


       The _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.


       An optional list of category numbers may  be  used  to  restrict  which
       lines are drawn (option ignored if a _l_e_g_e_n_d option is given).


       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, with one  entry  per
       line.   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.

       EExxaammppllee LLeeggeenndd FFiillee
	      -1 255 255 255

	      1  210 198 168

	      5  168 198 220




       In the above, all labelled lines will be drawn in white (255, 255, 255)
       except those labelled as categories 1 or 5.  If the "default" entry had
       been omitted, then only lines labelled 1 or 5 would have been 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_/_0_6 _0_6_:_1_9_:_2_6 _$



GRASS 5.0							d.vect.line(1)
