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]     [ccaatt--
       nnuumm_=_i_[_,_j_,_k_,_._._._,_n_]] [lleeggeenndd_=_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 category (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  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,
       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  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_/_0_6 _0_6_:_1_9_:_2_6 _$



GRASS 5.0					   d.vect.line(1)
