3d.view.sh(1)	       Grass User's Manual	    3d.view.sh(1)



NNAAMMEE
       33dd..vviieeww..sshh   -  Displays  several 3-dimensional views of a
       landscape on the user's graphics monitor.
       _(_G_R_A_S_S _S_h_e_l_l _S_c_r_i_p_t_)

SSYYNNOOPPSSIISS
       33dd..vviieeww..sshh
       33dd..vviieeww..sshh hheellpp
       33dd..vviieeww..sshh   ffiillee==_m_a_p_n_a_m_e   eeff==_m_a_p_n_a_m_e	vvhh==_v_i_e_w_i_n_g___h_e_i_g_h_t
       ssvv==_s_i_n_k___v_a_l_u_e   eexxaagg==_e_x_a_g   llff==_l_i_n_e___f_r_e_q_u_e_n_c_y   bbaacckk==_b_a_c_k_-
       _g_r_o_u_n_d___c_o_l_o_r

DDEESSCCRRIIPPTTIIOONN
       _3_d_._v_i_e_w_._s_h is a Bourne shell (sh(1)) script that  displays
       several	3-dimensional  views of a landscape on the user's
       graphics monitor.  It erases the graphics monitor and then
       prepares  it for the display of nine equally-sized frames.
       The user-specified raster map layer (given  by  ffiillee=_n_a_m_e)
       is  displayed  using  _d_._r_a_s_t  in  the  middle  frame.  The
       remaining frames are then used to display 3-d  perspective
       views.  The top middle panel is a view from the north, the
       top right from the north-east, the right  from  the  east,
       and so on.  Each is drawn with a call to the _d_._3_d program.
       The viewing angles are calculated automatically.

OOPPTTIIOONNSS
       If options are not stated on  the  command  line,  default
       values will be used.  These values are listed under Param-
       eters, below.

   PPaarraammeetteerrss::
       ffiillee==_m_a_p_n_a_m_e
	      Name of raster map layer to be displayed.
	      Default:	_e_l_e_v_a_t_i_o_n

       eeff==_m_a_p_n_a_m_e
	      Name of raster map layer whose category values will
	      supply  the  elevation  values used to generate 3-d
	      perspective views.
	      Default:	_e_l_e_v_a_t_i_o_n

       vvhh==_v_i_e_w_i_n_g___h_e_i_g_h_t
	      Height (in  meters)  of  the  location  from  which
	      scenes will be viewed.
	      Default:	30000

       ssvv==_s_i_n_k___v_a_l_u_e
	      Sink  factor  value,  causing  the image to be dis-
	      played lower, or higher, on the graphics screen.
	      Default:	0

       eexxaagg==_v_e_r_t_i_c_a_l___e_x_a_g_g_e_r_a_t_i_o_n
	      Vertical exaggeration factor of the values  in  the
	      elevation file.
	      Default:	3

       llff==_l_i_n_e___f_r_e_q_u_e_n_c_y
	      Contour  intervals  at which vector grid lines will
	      be drawn, in meters.
	      Default:	20

       bbaacckk==_b_a_c_k_g_r_o_u_n_d___c_o_l_o_r
	      Color of the background of the display frames.
	      Options:	red, orange, yellow, green, blue, indigo,
	      violet, magenta, brown, gray, white, and black
	      Default:	black


NNOOTTEESS
       In the _s_p_e_a_r_f_i_s_h sample data base, the user must specify a
       viewing height when running _3_d_._v_i_e_w_._s_h.	 Note  also  that
       the  raster  elevation  map layers in the PERMANENT mapset
       under spearfish are named _e_l_e_v_a_t_i_o_n_._d_e_m and _e_l_e_v_a_t_i_o_n_._d_m_a.


       This  program will not prompt the user for inputs;  if the
       user types 33dd..vviieeww..sshh without  program  arguments  on  the
       command line, default values will be used.

FFIILLEESS
       This  program is simply a shell script.	Users are encour-
       aged to make their own shell scripts using  similar  tech-
       niques.	See $GISBASE/scripts/3d.view.sh.

SSEEEE AALLSSOO
       _d_._3_d
       _d_._r_a_s_t

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



GRASS 5.0					    3d.view.sh(1)
