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 monitor.
       _(_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.  Geographic 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 displayed, and the geographic coordi-
       nates of the points at which they will appear.


       The user can run this  program  either  non-interactively  or  interac-
       tively.	 The  program will be run non-interactively if the user speci-
       fies the name of an _i_c_o_n file and (optionally) any other desired param-
       eters  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 unspeci-
       fied 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 values using the standard GRASS
       user interface described in the manual  entry  for  _p_a_r_s_e_r.   The  geo-
       graphic	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 command and are stored under the _i_c_o_n_s direc-
	      tory 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  dis-
       played.	Here,  spaces  represent  areas of no color, and x's represent
       areas of color. For example, the user might construct  an  icon	resem-
       bling 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 specified 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 coordinates 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 pro-
       gram. 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)
