% @(#)modifygrap.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:45 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      modifygrap.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, MODIFY/GRAPHICS
%.PURPOSE    On-line help file for the command: MODIFY/GRAPHICS
%.VERSION    1.0  27-JUN-1996 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./GRAP
\es\co
MODIFY/GRAPHICS					19-OCT-2000  KB
\oc\su
MODIFY/GRAPHICS [option]
	modify the state of a graphics window (e.g. mapped Window <-> Icon)
\us\pu
Purpose:
          Modify the state of a graphics window, e.g. from mapped Window to
          Icon and vice versa.
\up\sy
Syntax:
          MODIFY/GRAPHICS [option]
\ys\pa
          option = ICON or WINDOW (a)
                   PARENT         (b)
              (a) for ICON the active graphics window is put into an Icon;
                  for WINDOW the iconized graphics window is displayed on 
                  the screen again;
              (b) the active graphics window will serve as parent window 
                  for all subsequently created windows (display + graphics)
                  until the root window of the screen will become the global
                  parent window again - via PARENT=ROOT
              defaulted to ICON
\ap\sa
See also:
          CREATE/GRAPHICS, MODIFY/DISPLAY
\as\no
Note: 
             The command works on the currently active graphics window.
          E. g., putting a window into an Icon state does not automatically
          assign another graphics window (if present on the screen) to be the 
          active one. That would have to be done explicitely by the user.
          Except interactive commands which need the mouse, all other graphics
          related commands (like PLOT/ROW) can still be be applied to an
          iconized graphics window.
          OJO: Some window managers (e.g. Fvwm) have problems to display an
          iconized window again on the screen, if that window was not placed
          completely inside the screen before (including title bar).

 
             By default the screen of your workstation (PC) serves as parent
          window for all windows, i.e. all offsets are relative to that
          display area. Remember, that in Midas the origin (0,0) is the lower
          left corner and y increasing upwards, whereas in X11 (0,0) is the
          upper left corner and y increases downwards.
          With the option PARENT you set up the currently active graphics 
          window as parent window (PW) for all subsequent display/graphics
          windows. Thus their offsets are relative to that parent window and
          also their size will be clipped relative to the size of the PW.
          Moving the PW also moves all its subwindows.
          Use the option PARENT=ROOT to reset the root window, i.e. the full
          screen, as PW. AFter that you could again create a new graphics
          window and set that one up as the next parent window.
\on\exs
Examples:
\ex
          MODIFY/GRAPHICS Icon
            Put the current graphics window into the Icon window of the Window
            manager.
\xe \ex
          MODIFY/GRAPHICS Window
            Put an iconized graphics window again on the screen.
\xe \ex
          MODIFY/GRAPHICS Parent
            All following display/graphics windows will be subwindows of the
            currently active graphics window.
\xe \ex
          MODIFY/GRAPHICS Parent=root
            All display/graphics windows can be placed again anywhere on 
            the screen.
\xe \sxe