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



NNAAMMEE
       dd..iiccoonnss	 -  Displays  points,  as  icons, at user-defined
       locations in the active display frame on the graphics mon-
       itor.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..iiccoonnss
       dd..iiccoonnss hheellpp
       dd..iiccoonnss	  [--rr]	  iiccoonn==_n_a_m_e   [ccoolloorr==_n_a_m_e]   [ssiizzee==_v_a_l_u_e]
       [ppooiinnttss==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       _d_._i_c_o_n_s graphically displays  point  (site)  locations  as
       icons  in  the active frame on the graphics monitor.  Geo-
       graphic coordinates are read either from standard input or
       from  an  input file whose name is stated by the user.  At
       each site location, a user-defined icon is displayed.

OOPPTTIIOONNSS
       The user must enter at least the  name  of  an  _i_c_o_n  file
       storing	a  graphic  representation of the icon to be dis-
       played, and the geographic coordinates of  the  points  at
       which they will appear.


       The  user can run this program either non-interactively or
       interactively.  The program will be run	non-interactively
       if  the	user  specifies  the  name  of	an  _i_c_o_n file and
       (optionally) any other desired parameters on  the  command
       line,  using the form: dd..iiccoonnss [--rr] iiccoonn==_n_a_m_e [ccoolloorr==_n_a_m_e]
       [ssiizzee==_v_a_l_u_e] [ppooiinnttss==_n_a_m_e]

       If the user fails to specify the name of a _p_o_i_n_t_s file  on
       the  command  line,  the  program  will prompt the user to
       enter geographic coordinates from standard input.  If  the
       user  specifies	at  least the name of an _i_c_o_n file on the
       command line, any other parameter values left  unspecified
       by  the	user  will  be	set  to their default values (see
       below).


       Alternately, the user can simply type: dd..iiccoonnss

       on the command line, without program arguments.	 In  this
       case,  the user will be prompted for needed parameter val-
       ues using the standard GRASS user interface  described  in
       the  manual  entry for _p_a_r_s_e_r.  The geographic coordinates
       at which icons are to be displayed can still be input from
       an input file (_p_o_i_n_t_s) in interactive use.

   FFllaagg::
       --rr     Coordinates  are	input  in reverse order (i.e., as
	      _n_o_r_t_h_i_n_g _e_a_s_t_i_n_g).


   PPaarraammeetteerrss::
       iiccoonn==_n_a_m_e
	      The name of an existing file containing  a  graphic
	      representation of the icon to be drawn.  _i_c_o_n files
	      can be created by the user using the  _p_._i_c_o_n_s  com-
	      mand and are stored under the _i_c_o_n_s directory under
	      the user's current mapset.

       ccoolloorr==_n_a_m_e
	      Sets the current icon color to the _n_a_m_e stated.
	      Options: red, orange, yellow, green, blue,  indigo,
	      violet, gray, white, and black
	      Default: white

       ssiizzee==_v_a_l_u_e
	      The icon scaling factor.
	      Options: 1-1000
	      Default: 1

       ppooiinnttss==_n_a_m_e
	      The  name  of a UNIX file containing the geographic
	      coordinates of sites  at	which  icons  are  to  be
	      drawn.   Since this is a UNIX file, the user should
	      specify the name using standard  UNIX  file  naming
	      conventions.   If  this  file  is not in the user's
	      current working directory, its pathname  should  be
	      specified.   The	file contents should consist of a
	      series of geographic coordinates that  fall  within
	      the  boundaries  of  the current geographic region.
	      Each site location should be stated on  a  separate
	      line  as	an  easting  and northing (in that order)
	      separated by a single blank space.   If  no  _p_o_i_n_t_s
	      file  is specified by the user, input is taken from
	      standard input and should  be  given  in	the  same
	      form;  to  end  standard	input, type _e_n_d (or press
	      control-d).


EEXXAAMMPPLLEE
       An _i_c_o_n_s file contains a  graphic  representation  of  the
       icon  to  be displayed. Here, spaces represent areas of no
       color, and x's represent areas of color. For example,  the
       user  might  construct  an  icon resembling a cross in the
       following way:

	 x
	 x
       xxxxx
	 x
	 x
	 x


       This icon might be stored in a file  called  _c_r_o_s_s  (under
       the  user's $LOCATION/icons directory). If the user speci-
       fied that  this	be  the  _i_c_o_n  file  used  while  running
       _d_._i_c_o_n_s,  this  cross  would  then appear in the _c_o_l_o_r and
       _s_i_z_e specified by the user, at each site location named in
       the _p_o_i_n_t_s file.


       Note: icons are created with the _p_._i_c_o_n_s command.


       The  _p_o_i_n_t_s  file lists the geographic coordinates of site
       locations (at which icons will be  displayed).  This  file
       should take the form:

       easting northing
       easting northing
       easting northing


       If  the	user sets the --rr flag, the order of these coordi-
       nates should be	reversed  (i.e.,  coordinates  should  be
       given as _n_o_r_t_h_i_n_g _e_a_s_t_i_n_g).


       If  the points file is not specified, then the corrdinates
       are read from the keyboard or across a pipe. This  feature
       allows  users  to  enter the coordinates by hand, or, more
       usefully, to get then from another program.  For  example,
       to  display  icons at locations specified in a sites list:
       ss..oouutt..aasscciiii _n_a_m_e | dd..iiccoonnss iiccoonn==_c_r_o_s_s

       where _n_a_m_e is the name of a site list, and  _c_r_o_s_s  is  the
       name of an icon.

SSEEEE AALLSSOO
       _d_._p_o_i_n_t_s

       _d_._s_i_t_e_s

       _d_._w_h_e_r_e

       _p_._i_c_o_n_s

       _s_._d_b_._r_i_m

       _s_._o_u_t_._a_s_c_i_i

       _v_._d_b_._r_i_m

       _p_a_r_s_e_r

AAUUTTHHOORR
       Contributed by:


       Dave Johnson

	DBA Systems, Inc.

	10560 Arrowhead Drive

	Fairfax, Virginia 22030


       Modified by:


       Michael	 Shapiro,   U.S.  Army	Construction  Engineering
       Research Laboratory

       _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.icons(1)
