% @(#)view_imag.hlq	19.1 (ESO-IPG) 02/25/03 14:03:50 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.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
%----------------------------------------------------------------
\se
SECTION./IMAG
\es\co
VIEW/IMAGE						12-FEB-2003  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:   
             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. And, finally, a separate 
	  terminal window is used for the additional output (which is not
	  stored in the Midas logfile).
	     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 obtained by entering 'h'.
             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
