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  geo-
       graphic 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 val-
       ues 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 keyboard)  and
       will  prompt the user for these locations. Each icon loca-
       tion should be entered as an  easting  and  northing  pair
       separated  by  a  space,  followed  by  a carriage return.
       Coordinates should be stated in	whatever  map  coordinate
       system  is used by the user's current GRASS location.  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 com-
       mand line, and be prompted for the values of  all  parame-
       ters  (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 coordinates that fit within  the  bound-
	      aries  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 nor-
	      thing  (in  that order) separated 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  cur-
	      rent 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 geographic 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 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_3 _$



GRASS 5.0					      d.points(1)
