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 automati-
       cally.

OOPPTTIIOONNSS
       If options are not stated on the command line, default values  will  be
       used.  These values are listed under Parameters, 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 displayed 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 val-
       ues will be used.

FFIILLEESS
       This program is simply a shell script.  Users are  encouraged  to  make
       their   own   shell   scripts  using  similar  techniques.   See  $GIS-
       BASE/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)
