% @(#)copy_pscr.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:26 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      copy_pscr.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/PSCR
%.PURPOSE    On-line help file for the command: COPY/PSCR
%.VERSION    1.0  17-FEB-1997 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./PSCR
\es\co
COPY/PSCR					19-SEP-1995  KB
\oc\su
COPY/PSCR  image [PS_file] [options] [prnt_flags] [scales] [LUT_specs]
	convert MIDAS images (bdf-files) to PostScript format
\us\pu
Purpose: 
          Convert MIDAS images (bdf-files) to PostScript format.
\up\sy
Syntax: 
          COPY/PSCR image [PS_file] [options] [prnt_flags] [scales] [LUT_specs]
\ys\pa
          image = name of MIDAS image
\ap\pa
          PS_file = name of Postscript file;
\\
              defaulted to `image' name with ".ps" appended
\ap\pa
          options = optional string of up to 9 option_flags ("wbneavfNE");
\\
              w - add an intensity wedge to the right of each frame
\\
              b - use a blue background color instead of white
\\
              v - will list the origin and scale parametrs for each frame
\\
              n - use a negative ITT instead of a positive ramp
\\
              e - use an exponential ITT instead of a linear one
\\
              a - autoscale bdf-file to fit into display area (paper size)
\\
              f - draw a frame box around the image
\\
              N - no frame identifier will be included
\\
              E - create an Encapsulated PostScript file which can be embedded
                  in other documents
\ap\pa
          prnt_flags = page_format,resolution;
\\
              page_format can be one of the following:
\\
                A4P, A4L, A3P, A3L, S4P and S4L,
\\
                the first two letters define the page size as A3/A4 or S4,
                which is for Slide format being A4 with wider margins,
                the last letter is P or L for portrait or landscape;
\\
              resolution specifies the resolution of the printer in pixels 
                per cm, if this parameter is 0 or not given the printer default
                is used;
\\
              defaulted to A4P,0
\ap\pa
          scales = xscales,yscales to specify the scaling of the image as
              xscale,yscale in world coordinates per cm;
\\
              by default the image will be scaled to fill the full available
              area with xscale=yscale
\ap\pa
          LUT_specs = 0, 1, 2 or 3 for simple internally generated LUTs,
              or name of LUT stored as standard MIDAS table (in current dir!)
\ap\sa
See also:
          COPY/DISPLAY, @a outima
\as\no
Note:
          The cut values for the pixel intensity is taken from descr. LHCUTS.
\\
          The PostScript file can be viewed with any viewer (e.g. Ghostscript
          or xv) and printed out on a PostScript printer with the `lp' command.
          A color PostScript file requires a color printer to come out 
          correctly.
\on\exs
Examples:
\ex
          COPY/PSCR galaxy ? wn p6=3 
            Image `galaxy.bdf' is converted to the color PostScript file
            `galaxy.ps' using the internal LUT no. 3.
            A negative ITT is also used and a color wedge is added to the right
            of the image.
\xe\ex
          COPY/PSCR n2997 n2997.eps En
            MIDAS image `n2997.bdf' is converted to an Encapsulated PostScript
            file `n2997.eps' using a negative ITT.
            The EPS file `n2997.eps' can then be enbedded in other documents.
\xe \sxe