% @(#)copy_zoom.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:26 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      copy_zoom.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/ZOOM
%.PURPOSE    On-line help file for the command: COPY/ZOOM
%.VERSION    1.0  11-JAN-1994:  Creation (from copy_aux_.hlq), KB
%----------------------------------------------------------------
\se
SECTION./ZOOM
\es\co
COPY/ZOOM					11-JAN-1994  KB
\oc\su
COPY/ZOOM [out_dev] [stop_flg] [ITTnam] [LUTnam] [prflag] [prmode]
	make a copy of the zoom window on output device
\us\pu
Purpose: 
          Make a copy of the zoom window of the Image Display on output
          device.
\up\sy
Syntax: 
          COPY/ZOOM [out_dev] [stop_flg] [ITTdef] [LUTnam]
                          [prflag] [prmode]
\ys\pa
          out_dev = generic MIDAS name or system name of output device, the
             MIDAS command HELP [PRINTERS] shows a detailed list of all the
             printers/plotters at your site with their names and locations;
\\
             defaulted to LASER, the MIDAS name for the default black+white
             Postscript Laser printer
\ap\pa
          stop_flg = if set to STOP, only read the contents of zoom window
             and save them in frame `screen.ima', but do not send it to an
             output device; defaulted to NOSTOP
\ap\pa
          ITTdef = N or P for negative or positive conversion of intensity
             or I,ITT_name to indicate special ITT to be applied to the data;
\\
             defaulted to N, so black -> white and white -> black
\\
             Note however, that any ITT already in effect on the display is
             always applied to the image data. So if you want an exact copy
             of the screen, do not enter any ITT (just use N or P if you want
             to exchange black + white in the hardcopy or not).
\\
             If you want a different ITT applied to the hardcopy then disable
             first the ITT on the display, before using COPY/ZOOM with that
             specific ITT.
\ap\pa
          LUTnam = name of a LUT to be applied to the data,
             if the loaded image has a real descriptor MIDAS_LUT, this data
             is taken, if LUT_name is omitted. Else we default to current LUT.
\ap\pa
          prflag = if set to NOPRINT, the PostScript file named `screen.ps'
             which is created by COPY/ZOOM is not sent to `out_dev';
\\
             defaulted to PRINT
\ap\pa
          prmode = 5-char. flag:
\\
              (1) = P(ortrait)/L(andscape), (2) C(olor)/B(lack+white),
\\
              (3) = 4/8 bits per pixel on hardcopy,
\\
              (4) = N(o background)/B(ackground in blue);
\\
              (5) = T(ext)/Z(noText) on output
\\
              default is PC8NT for COLOUR, PC8B for SLIDE,
\\
              for all other devices the default is PB8NT
\ap\sa
See also:
          COPY/DISPLAY, CREATE/ZOOM, VIEW/IMAGE, HELP [Printers]
\as\no
Note:   
          This command only works for X11 devices. The zoom window has to
          exist and be completely inside the display. 
\\
          Frame screen.ima is always created, regardless of stop_flag.
\\
          The command VIEW/IMAGE also has options to make hardcopies of the
          zoom window.
\on\exs
Examples:
\ex
          COPY/ZOOM ? ? lasritt
            Make hardcopy of zoom window of "active" image display and use
            the ITT `lasritt.itt'.
\xe\ex
          COPY/ZOOM P5=NOPRINT
            Store "hardcopy" of zoom window of image display only in image
            frame `screen.ima' and convert it to PostScript file `screen.ps'.
\xe \sxe