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



NNAAMMEE
       dd..iiggrraapphh  - Graphics interface for GRASS on the Intergraph.
       _(_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  sec-
       tion 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 equiv-
       alents  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. There-
       fore, 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 workstation 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 command.	Note that the current virtual screen number is
       displayed  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 num-
       ber 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 workstation.


       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  outside  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 highlighting 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 window) 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)
