% @(#)preparlong.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:53:25
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1993 European Southern Observatory
%.IDENT      preparlong.hlq
%.AUTHOR     01-APR-93, IPG/ESO
%.KEYWORDS   MIDAS, help files, 
%.PURPOSE    On-line help file for the command: PREPARE/LONG
%.VERSION    1.0  PB : Creation, 01-APR-93
%----------------------------------------------------------------
\se
SECTION./LONG
\es\co
PREPARE/LONG					   PB  01-APR-93
\oc\su
PREPARE/LONG   in   [out]    [limits]
	Extracts sub-images from an image or a catalog.
\us\pu
Purpose:    
            Applies command EXTRACT/IMAGE to an image (parameter in
            is given with an extension .bdf) or to a catalog (default)
            and generate output images which root name is specified by
            out.
\up\sy
Syntax:     
            PREPARE/LONG   in   [out]    [limits]
\ys\pa
            in     =  Input frame or catalog. An input frame must be
                      identified by the extension .bdf. An input catalog
                      can be specified with or without the extension .cat.
\ap\pa
            out    =  Root name for output files. Default: ext
\ap\pa
            limits =  x1,y1,x2,y2. Limits of the extraction window, 
                      in pixels. x1,y1 is the position of the lower-left
                      corner, and x2,y2 the position of the upper-right
                      corner. Null values can be used to represent the 
                      limit of the frame. \\
                      Session keyword: TRIM; default: 0,0,0,0
\ap\sa
See also: 
            EXTRACT/IMAGE
\as\no
Note:       
            None
\on\exs
Examples:
\ex
\\{\tt
            CREATE/ICAT  mycat  *.bdf            \\
            PREPARE/LONG mycat trim=0,60,0,450 
\\}
            Extracts all rows from y=60 to y=450
\xe \sxe