% @(#)modifygcur.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:44 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      modifygcur.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, MODIFY/GCURSOR
%.PURPOSE    On-line help file for the command: MODIFY/GCURSOR
%.VERSION    1.0  27-OCT-1989 : Creation, RHW
%----------------------------------------------------------------
\se
SECTION./GCUR
\es\co
MODIFY/GCURSOR				   	               27-OCT-1989  RHW
\oc\su
MODIFY/GCURSOR frm_in frm_out y-coord xstart,xend no_curs,degree
	interactive modification of pixel values in a frame
\us\pu
Purpose:   
          Change data in a line (the input image) interactively via cursor 
          input, by interpolating polynomially between cursor positions. 
          NOTE: The original data will be overwritten.
\up\sy
Syntax:    
          MODIFY/GCURSOR frm_in frm_out y_coord xstart,xend cursors,degree
\ys\pa
          frm_in      = input frame name
\ap\pa
          frm_out     = output frame after modifications; default input frame
\ap\pa
          y-coord     = y-coordinate of the line to modify (default @1)
\ap\pa
          xstart,xend = first and last point on the line to be displayed,
                        entered either as line (pixel) number when
                        prefixed by @, or as real world coordinates
                        (default entire line)
\ap\pa
          cursors     = no. of cursor positions (<= 100, default 2)
\ap\pa
          degree      = degree of polynomial fit for the interpolation
                        (default 1)
\ap\no
Note:     
          Use any key except (incl. RETURN), or the mouse enter button to 
          validate a cursor position. When the specified number of cursor 
          positions has been specified the interpolation is done and the
          data is modified. To display these modified data use the SPACE BAR.
          To exit use the SPACE BAR or exit button on the mouse once more.
\on\see
See also:
          PLOT/ROW, PLOT/COLUMN, GET/GCURSOR, MODIFY/PIXELS, MODIFY/ROW,
          MODIFY/COLUMN, MODIFY/AREA
\ees\exs
Examples:
\ex
          MODIFY/GCURSOR GL GLO @1 5,50 2,1
          Modify frame GL, line 1, between the world coordinates 5 and 50, 
          with 2 cursor positions and linear interpolation. The modified 
          date will be stored in frame GLO.
\xe \sxe