% @(#)extracrtra.hlq	17.1.1.2 (ESO-IPG) 02/25/02 17:46:21 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      extracrtra.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, EXTRACT/RTRACE
%.PURPOSE    On-line help file for the command: EXTRACT/RTRACE
%.VERSION    1.0  05-FEB-1990 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./RTRA
\es\co
EXTRACT/RTRACE						02-FEB-2002  KB
\oc\su
EXTRACT/RTRACE [step] [frame] [plot_flag] [zw_option]
	extract a row from displayed image
\us\pu
Purpose:  
          Extract interactively a row from a displayed image.
\up\sy
Syntax: 
          EXTRACT/RTRACE [step] [frame] [plot_flag] [zw_option]
\ys\pa
          step = stepsize along the traced row;
               defaultd to stepsize in x of displayed image
\ap\pa
          frame = name for result frame; defaulted to 'row.bdf'.
\ap\pa
          plot_flag = DRAW, PLOT or NONE; defaulted to DRAW;
               if set to DRAW, a plot of the extracted row is displayed in the
               overlay channel each time the ENTER button is pushed;
               if set to PLOT, a plot of the extracted row is displayed on the
               graphics terminal (graphics window) each time the ENTER button
               is pushed;
\ap\pa
          zw_option = zoom_window_flag,zoom;
              zoom_window_flag = W for zoom_window, N for none,
              zoom = initial zoom factor; defaulted to N,4;
              only applicable to X11 window displays!
\ap\sa
See also:
          EXTRACT/TRACE, EXTRACT/CTRACE, EXTRACT/ROTATED
          VIEW/IMAGE, GET/CURSOR
\as\no
Note:  
             Use the mouse to move cursor #0 to mark the row in the
          currently displayed image. 
          To extract the chosen row and exit, press the EXIT button
          (the button to the right of the ENTER button). The start/end pixels
          of the original frame where the row was extracted are saved in
          int. descr. START_END_TRACEPIX.
             With the zoom window option you first select a subwindow in the
          main display window. Then move the mouse into the zoom window
          and choose the row trace. Push Enter to extract the row and
          draw the full row vector in the main display window. Press Exit
          to go back to the main window and choose another subwindow there
          or press Exit to leave the command.
             All the additional functionality which comes with the zoom
          window option (see e.g. VIEW/IMAGE) is also available.
             The parameter 'frame' may be set to "+" also, which means that
          no frame is extracted (only useful with plot_flag = DRAW or PLOT).
\on\exs
Examples:
\ex
         EXTRACT/RTRACE ? gato
           Extract row of displayed frame and store in 1-dim frame
           `gato.bdf' and show the profile, each time the ENTER button
           is pressed. Use stepsize in x-direction of displayed frame.
\xe\ex
         EXTRACT/RTRACE 1.05 
           Extract 1-dim frame `row.bdf' from displayed frame 
           and use stepsize = 1.05 in the sampling of the row.
\xe\ex
          EXTRACT/RTRACE ? mosca plot w
            Extract row from displayed frame and store in frame `mosca.bdf'.
            Choose the row in the zoom window and plot the profile in the
            graphics window each time you press Enter (in the zoom window).
            If no graphics and/or zoom window exist, they are created with
            default sizes.
\xe \sxe