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



NNAAMMEE
       dd..iiggrraapphh   -  Graphics  interface  for GRASS on the Inter-
       graph.
       _(_M_a_p _D_e_v_e_l_o_p_m_e_n_t _T_o_o_l_)

SSYYNNOOPPSSIISS
       dd..iiggrraapphh

DDEESSCCRRIIPPTTIIOONN
       _d_._i_g_r_a_p_h is the GRASS  interface  to  the  GRASS  graphics
       driver  on  the Intergraph workstations.  GRASS can be run
       from an ascii terminal or from a window on the  Intergraph
       workstation.   There  are  some	pitfalls to running GRASS
       from a window; these are discussed in  the  NOTES  section
       below.


       When  _d_._i_g_r_a_p_h  is run a pull-down menu will appear on the
       workstation screen and some information will be	displayed
       on  the	ascii  terminal.  The pull-down menu, which works
       the same way other Intergraph pull down-menus  work,  will
       look like this:

	 _______________________
	 |  GRASS Commands	|
	 |  start/select	|
	 |  stop		|
	 |  GRASS Graphics	|
	 |  resize/move 	|
	 |  virtual screens    >|
	 |  colors	       >|
	 | EXIT 		|
	 |______________________|

       The  menu  is  divided into two categories: _G_R_A_S_S _C_o_m_m_a_n_d_s
       and _G_R_A_S_S _G_r_a_p_h_i_c_s.  _G_R_A_S_S _C_o_m_m_a_n_d_s in the pull-down  menu
       have  GRASS  command-line  equivalents. These command-line
       equivalents can be used without running _d_._i_g_r_a_p_h, although
       users  may  find  the  pull-down  menu commands easier and
       faster to use.  On the other hand, there are  no  command-
       line  equivalents  for  the _G_R_A_S_S _G_r_a_p_h_i_c_s commands in the
       pull-down menu.	These commands, which must  be	run  from
       inside _d_._i_g_r_a_p_h, enable you to modify the size, placement,
       and number of colors, of the graphics window.


       The first command under _G_R_A_S_S  _C_o_m_m_a_n_d_s	is  _s_t_a_r_t_/_s_e_l_e_c_t;
       selecting  this	command  with  the  mouse  will start the
       graphics driver _I_G_R_A_P_H and  then  select  it  for  output.
       This  pull-down	menu  command is equivalent to typing the
       following commands at the GRASS command line:

       dd..mmoonn ssttaarrtt==IIGGRRAAPPHH
	      (start and select the IGRAPH graphics driver)

       or

       dd..mmoonn --ss ssttaarrtt==IIGGRRAAPPHH
	      (start but don't select the IGRAPH driver)

       dd..mmoonn sseelleecctt==IIGGRRAAPPHH
	      (select the already started IGRAPH driver)

       Using the _s_t_a_r_t_/_s_e_l_e_c_t option saves the user  from  having
       to  type  the above command(s).	After the graphics driver
       is started, the pull-down  menu	will  disappear  and  the
       _d_._i_g_r_a_p_h  program will exit, leaving the user at the GRASS
       prompt.	When the second command (_s_t_o_p) under  _G_R_A_S_S  _C_o_m_-
       _m_a_n_d_s  is  selected,  the graphics driver _I_G_R_A_P_H will stop
       and the GRASS window will disappear.  The equivalent GRASS
       command-line command is: dd..mmoonn ssttoopp==IIGGRRAAPPHH.


       The second category (_G_R_A_S_S _G_r_a_p_h_i_c_s) in the pull-down menu
       contains three commands written	for  the  GRASS  graphics
       driver  _I_G_R_A_P_H.	 These	commands establish parameters for
       size, location, and number of colors the  graphics  driver
       will  use  to  create  a GRASS graphics window. Therefore,
       they should be run _b_e_f_o_r_e  starting  the  graphics  driver
       with  the _s_t_a_r_t_/_s_e_l_e_c_t command.	These parameters will not
       affect a GRASS window that has already been  started,  but
       they  will  be  saved  and used the next time the graphics
       driver is started.


       The first command in the second category  is  _r_e_s_i_z_e_/_m_o_v_e.
       When  the  _r_e_s_i_z_e_/_m_o_v_e  command is selected, the pull-down
       menu will disappear and a special _R_e_s_i_z_e  window,  colored
       grey, will be created on the graphics monitor.  The _R_e_s_i_z_e
       window will be the exact size and at the same location  as
       the  GRASS graphics window would be if the graphics driver
       had been started.  Use the resize and move  icons  on  the
       _R_e_s_i_z_e window to modify the window.  When the desired size
       and position has been achieved, ddeelleettee the _R_e_s_i_z_e  window.
       To  do  this,  move the mouse to the left side of the icon
       strip at the top of the _R_e_s_i_z_e window and click the  mouse
       on  the	small box  containing an XX.  Note that the window
       size is displayed on  the  ascii  terminal  in  which  the
       _d_._i_g_r_a_p_h program was started.  Now, each time the graphics
       monitor is started, the window will be the same	size  and
       at the same location as the _R_e_s_i_z_e window.


       The second command is _v_i_r_t_u_a_l _s_c_r_e_e_n_s.  This command has a
       sub-menu with a listing of virtual screen numbers (from	0
       to  3).	 Of  the  virtual screen numbers listed (0 to 3),
       only one or two	of  those  numbers  will  be  active  and
       selectable  from  the  sub-menu.  The number of selectable
       virtual screen numbers will depend on the type of worksta-
       tion  and  its  virtual	screen	configuration.	 When the
       _I_G_R_A_P_H driver is started, it will create a GRASS window on
       the  virtual  screen  whose number was picked by this com-
       mand.  Note that the current virtual screen number is dis-
       played  on the ascii terminal n which the _d_._i_g_r_a_p_h program
       was started.


       The third graphics command is _c_o_l_o_r_s.  This command has	a
       sub-menu  with  a  listing of the possible range of active
       colors the workstations will support  (16  to  512).   The
       number  of  active  colors  is determined by the number of
       planes the graphics processor  supports	 (9  planes  will
       give  512 active colors).  We do not suggest running GRASS
       with fewer than 225566 active colors.


       Each workstation can be configured differently with regard
       to  the number of virtual screens and the available number
       of colors.  A certain amount of testing will have to  been
       done  to determine what works best with a particular work-
       station.


       The last command is the _E_X_I_T  command.	This  command  is
       used to leave the _d_._i_g_r_a_p_h program.

UUSSIINNGG TTHHEE GGRRAAPPHHIICCSS WWIINNDDOOWW
       Once  the  GRASS graphics driver is started, a window will
       appear on the screen.  The GRASS graphics window is mouse-
       activated.   The  mouse	must be within the GRASS graphics
       window for the true GRASS colors to be  displayed  on  the
       graphics  window.   The	mouse  doesn't have to be clicked
       inside the window; just moving the mouse within the window
       is enough to activate the window.  While the mouse is out-
       side the GRASS graphics window, the colors in the graphics
       window will be random.

NNOOTTEESS
       Obsolete for LINUX, of course!


       When  using  the  GRASS	program  _d_._c_o_l_o_r_s or the _i_n_t_e_r_a_c_t
       selection in the _d_._d_i_s_p_l_a_y  program,  the  mouse  must  be
       within  the  GRASS  graphics window when toggling or high-
       lighting categories.  If  the  mouse  is  not  within  the
       graphics  window,  the  colors will not represent the true
       category colors.  Using the two programs  mentioned  above
       while  running GRASS from an Intergraph window (ascii win-
       dow) creates a problem;	The  mouse  must  be  within  the
       graphics  window  at  all times for those programs to work
       properly, but the mouse also must be moved  to  the  ascii
       window  to  activate the ascii window so that commands can
       be typed.  This is not a problem when GRASS is run from an
       ascii  terminal,  because the mouse can be left within the
       GRASS graphics window at all times.

AAUUTTHHOORR
       Michael	 Higgins,   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					      d.igraph(1)
