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



NNAAMMEE
       dd..ssccaallee	 -  Overlays  a bar scale and north arrow for the current geo-
       graphic 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 current geographic
       region at a user-defined location in the  active  display  frame.   The
       scale  and north arrow are proportioned 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 interac-
       tively  (using a mouse), or provide the geographic 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 displayed on a black background.

OOPPTTIIOONNSS
       The user can run this  program  either  non-interactively  or  interac-
       tively.	 The  program will be run non-interactively if the user speci-
       fies 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 unspecified 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 des-
	      ignating the location at which the  upper  left  corner  of  the
	      scale is to be placed. The user should choose geographic coordi-
	      nates 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  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.scale(1)
