% @(#)view_imag.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:44:02 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      view_imag.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, VIEW/IMAGE
%.PURPOSE    On-line help file for the command: VIEW/IMAGE
%.VERSION    1.0  31-MAY-1990 : Creation, KB
%.VERSION    1.1  17-JAN-1992 : parameter change, KB
%.VERSION    1.2  10-APR-1992 : parameter modification, KB
%.VERSION    1.3  20-JUL-1992 : add more options, KB
%----------------------------------------------------------------
\se
SECTION./IMAG
\es\co
VIEW/IMAGE						14-DEC-1994  KB
\oc\su
VIEW/IMAGE [frame] [out_tab] [plot_option] [g,zhardcopy]
	view an image with a "looking glass"
\us\pu
Purpose:  
          View an image with a "looking glass" and get statistics.
\up\sy
Syntax: 
          VIEW/IMAGE [frame] [out_tab] [plot_option] [g,zhardcopy]
\ys\pa
          frame = name of image, the image will be loaded with the cuts set
               to mean-3*sigma, mean+3*sigma
\\
               if omitted, the currently displayed image is used
\ap\pa
          out_tab = name of optional output table for coordinates of visited
               regions 
\ap\pa
          plot_option = P or N, for P(lotting) or N(oPlotting), defaulted to P;
\ap\pa
          g,zhardcopy = names of plotters for hardcopies of graphics window
               (initiated via key `p') and zoom window (initiated via key `q');
\\
               defaulted to LASER,LASER
\ap\sa
See also:
          STATISTICS/IMAGE, GET/CURSOR, CENTER/GAUSS, MAGNITUDE/RECTANGLE
\\
          EXTRACT/CURSOR, EXTRACT/RTRACE, LOAD/IMAGE, CUTS/IMAGE
\as\no
Note:   
          This command is only implemented for XWindow stations!
\\
          If the zoom window does not exist yet, it will be created with
          half the size in x and y of main display window.
          Also a graphics window will be opened if plot_option = P.
\\
          Use the cursor to select the center of subimages to be viewed. These
          subimages are zoomed according to the current zoom factor and
          displayed in the zoom_window.
\\
          This command has lots of different options which are activated via
          different keys on the keyboard. But note, that the cursor has to
          remain in the display window at all times, even if you type on the
          keyboard.
\\
          The available options are:
\\
          h = get this help,
          z = zoom up, x = zoom down
          c = load colour LUT, b = load b+w LUT, 
          l = modify LUT via arrow keys  
          i = load ITT, j = clear ITT,
          k = modify ITT via arrow keys  
          u = toggle looking glass mode (zoom on the fly)
          m = modify cuts and redisplay subimage or full image
          t = toggle plot options,
          s = toggle cut options in zoom window 
          v = toggle statistics/magnitude option 
          a = modify radius for magnitude, nomansland, background
          p or q = make hardcopy of graphics or zoom window,
          e = extract subimage 
          if display memory > display window, use the arrow keys to scroll 
\\
          The optional output table will have columns with the standard
          labels :XSTART, :YSTART, :XEND and :YEND.
\\
          If the plotting option is set to row/column-trace mode, not the
          2-dim region of interest is extracted with the `e' command, but the
          row or column at the center (the one which is plotted).
\on\exs
Examples:
\ex
          VIEW/IMAGE cielo 
            Load image `cielo.bdf' with low, high cut values set to
            mean-3*sigma and mean+3*sigma.
\\
            Use the default size (or size of existing auxiliary window) for
            the zoom window.
\xe\ex
          VIEW/IMAGE cielo ? ? ps4ipg1
            As above, but send all eventual hardcopies to printer with the
            name `ps4ipg1'.
\xe\ex
          VIEW/IMAGE ? luna
            Work on image which is currently loaded in the display, write the
            coordinates of all regions which were visited into output table
            `luna.tbl'.
\xe\ex
          VIEW/IMAGE estrella.mt
            The FITS file `estrella.mt' is loaded into the display window and 
            worked on like any binary Midas frame.
\xe\sxe