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



NNAAMMEE
       dd..ppooiinnttss  - Displays point graphics in the active frame on the graphics
       display monitor.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..ppooiinnttss
       dd..ppooiinnttss hheellpp
       dd..ppooiinnttss [ccoolloorr==_n_a_m_e] [ssiizzee==_v_a_l_u_e] [ttyyppee==_n_a_m_e] [ffiillee==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       _d_._p_o_i_n_t_s displays points whose coordinate locations  are  specified  by
       the user and located within the current geographic region in the active
       display frame on the graphics  monitor.	 Point	coordinates  are  read
       either  from  standard  input  or  from	a file stated by the ffiillee==_n_a_m_e
       option. When entering coordinates  through  standard  input,  the  user
       presses _c_o_n_t_r_o_l_-_d to signal the end of input to _d_._p_o_i_n_t_s.

OOPPTTIIOONNSS
       The  program  can  be run interactively or non-interactively.  The user
       can run the program completely non-interactively by specifying the name
       of  a points ffiillee (containing the geographic coordinates of icons to be
       sited) and the values of all needed parameters on the command line.  If
       the name of an input ffiillee to _d_._p_o_i_n_t_s is given on the command line, any
       other parameter values left unspecified on the command line (e.g.,  the
       icon ccoolloorr, ssiizzee, and/or ttyyppee) are set to their default values.


       The  user can instead elect to run the program partially interactively,
       by specifying any/all of the parameters	_e_x_c_e_p_t	the  points  ffiillee==_n_a_m_e
       parameter  on the command line.	In this case, _d_._p_o_i_n_t_s will expect the
       user to enter icon locations from standard input  (i.e.,  at  the  key-
       board) and will prompt the user for these locations. Each icon location
       should be entered as an easting and northing pair separated by a space,
       followed  by  a carriage return.  Coordinates should be stated in what-
       ever map coordinate system is used by the user's  current  GRASS  loca-
       tion.   The  user presses _c_o_n_t_r_o_l_-_d to signal the end of standard input
       to _d_._p_o_i_n_t_s.


       Alternately, the user can simply type dd..ppooiinnttss on the command line, and
       be  prompted for the values of all parameters (the user can still input
       icon coordinates from an input file using this form). In this case, the
       user is presented with the standard GRASS _p_a_r_s_e_r interface.

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

       ssiizzee==_v_a_l_u_e
	      Size of icon in pixels.
	      Options: 0-1000 (pixels)
	      Default: 5 (pixels)

       ttyyppee==_n_a_m_e
	      Sets the shape (type) of the icon to be drawn to _n_a_m_e.
	      Options: x, diamond, box, +
	      Default: +

       ffiillee==_n_a_m_e
	      Take input from the UNIX file _n_a_m_e.  (Note: This file must be in
	      the user's current directory or given by its full path name.)
	      Default: Standard input.
	      The file contents should consist of a series of geographic coor-
	      dinates that fit within the boundaries of the current geographic
	      region falling within the active display frame (refer to _d_._w_h_e_r_e
	      or _g_._r_e_g_i_o_n for these coordinates).  Each icon  location	should
	      be  specified  by  an easting and northing (in that order) sepa-
	      rated by a single  blank	space,	and  followed  by  a  carriage
	      return.  Eastings and northings should be stated in whatever map
	      coordinate system is being used  by  the	user's	current  GRASS
	      location.


NNOOTTEESS
       _d_._p_o_i_n_t_s  will  display a point at the location specified in the active
       frame, even if the point lies outside the boundaries  of  current  geo-
       graphic region.

SSEEEE AALLSSOO
       _d_._f_r_a_m_e

       _d_._w_h_e_r_e

       _d_._s_i_t_e_s

       _g_._r_e_g_i_o_n

       _s_._o_u_t_._a_s_c_i_i

       _p_a_r_s_e_r

AAUUTTHHOORR
       James  Westervelt,  U.S. Army Construction Engineering Research Labora-
       tory

       _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_3 _$



GRASS 5.0							   d.points(1)
