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



NNAAMMEE
       dd..ssccaallee	 -  Overlays  a bar scale and north arrow for the
       current geographic region at a  user-defined  location  in
       the active display frame.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..ssccaallee
       dd..ssccaallee hheellpp
       dd..ssccaallee [--mm] [bbccoolloorr==_n_a_m_e] [ttccoolloorr==_n_a_m_e] [aatt==_x_,_y]

DDEESSCCRRIIPPTTIIOONN
       _d_._s_c_a_l_e	overlays a bar scale and north arrow for the cur-
       rent geographic region at a user-defined location  in  the
       active  display frame.  The scale and north arrow are pro-
       portioned to fit in the active frame when placed along the
       frame's left edge.


       The  user  can specify the location of the scale and north
       arrow interactively (using a mouse), or provide	the  geo-
       graphic	coordinates  at  which	they will be placed.  The
       scale and north arrow will only overwrite  those  portions
       of the graphics display that lie directly beneath them.


       The  user  can  also specify the colors in which the scale
       and north arrow will be drawn. By default, if  unspecified
       by  the	user,  a white scale and north arrow will be dis-
       played on a black background.

OOPPTTIIOONNSS
       The user can run this program either non-interactively  or
       interactively.	The program will be run non-interactively
       if the user specifies program parameter values and desired
       flag settings on the command line, using the form:


       dd..ssccaallee [--mm] [bbccoolloorr==_n_a_m_e] [ttccoolloorr==_n_a_m_e] [aatt==_x_,_y]



       If  at  least  one parameter value is given on the command
       line and the -m flag is not set, the program will  be  run
       non-interactively; any other parameter values left unspec-
       ified on the command line  will	be  set  equal	to  their
       default	values	(see  below).	Alternately, the user can
       simply type dd..ssccaallee on the command line,  without  program
       arguments.  In  this  case,  the user will be prompted for
       needed parameter values and the	flag  setting  using  the
       standard  GRASS parser interface.  If the user sets the -m
       flag, _d_._s_c_a_l_e  will  expect  the  user  to  designate  the
       scale's location interactively, using the mouse.



   FFllaagg::
       --mm     Use  the	mouse to interactively place the location
	      of the scale and north arrow.


   PPaarraammeetteerrss::
       bbccoolloorr==_n_a_m_e
	      Set the background color underlying the  scale  and
	      north arrow to _n_a_m_e.
	      Options:	_r_e_d_, _o_r_a_n_g_e_, _y_e_l_l_o_w_, _g_r_e_e_n_, _b_l_u_e_, _i_n_d_i_g_o_,
	      _v_i_o_l_e_t_, _g_r_a_y_, _b_r_o_w_n_, _m_a_g_e_n_t_a_, _w_h_i_t_e, and _b_l_a_c_k
	      Default: _b_l_a_c_k

       ttccoolloorr==_n_a_m_e
	      Set the foreground color in which the text,  scale,
	      and north arrow are displayed to _n_a_m_e.
	      Options: Same as _b_c_o_l_o_r colors.
	      Default: _w_h_i_t_e

       aatt==_x_,_y The  map	easting  (x)  and northing (y) geographic
	      coordinates designating the location at  which  the
	      upper left corner of the scale is to be placed. The
	      user should choose geographic  coordinates  located
	      within  the  current geographic region (see _d_._w_h_e_r_e
	      and _g_._r_e_g_i_o_n for these coordinates).
	      Default: 0.0,0.0


NNOOTTEESS
       _d_._s_c_a_l_e assumes that layer units are in meters.


       The scale that _d_._s_c_a_l_e generates is probably not  suitable
       for very tiny maps (in small display frames).

SSEEEE AALLSSOO
       _d_._b_a_r_s_c_a_l_e

       _d_._l_e_g_e_n_d

       _d_._m_e_a_s_u_r_e

       _d_._w_h_a_t_._r_a_s_t

       _d_._w_h_a_t_._s_i_t_e_s

       _d_._w_h_a_t_._v_e_c_t

       _d_._w_h_e_r_e

       _g_._r_e_g_i_o_n

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