%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990-2008 European Southern Observatory
%.IDENT      overplrow.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, OVERPLOT/ROW
%.PURPOSE    On-line help file for the command: OVERPLOT/ROW
%.VERSION    870609 RHW Creation, RHW
%.VERSION    910313 RHW Improvements acc. to Verification Form
%.VERSION    910904 RHW New file overplrow.hlq for overplot/row command
%---------------------------------------------------------------------
\se
SECTION./ROW
\es\co
OVERPLOT/ROW                                              10-DEC-2004  RHW,KB
\oc\su
OVERPLOT/ROW frame [y-coord] [x_start,x_end] [offset] [l_type]
             [multi_color_option] [2ndcol_spec]
	overplot a row (line) of a frame on a graphic device
\us\pu
Purpose:    
            Overplot a row (line) of a frame on a graphic device
\up\sub
Subject:    
            Graphics, frames
\bus\sy
Syntax:     
            OVERPLOT/ROW frame [y_coord] [x_sta,x_end] [offset] [l_type] 
                         [multi_color_option] [2ndcol_spec]
\ys\pa
            frame = image file name
\ap\pa
            y_coord = row (line) number or world coordinate in the frame;
                    default the first row.
\ap\pa
            x_sta,x_end = can be: (a) first and last pixel coordinate;
                    (b) start, end in world coordinates on the line.
                    Default is either the manual setting done by the
                    command SET/GRAPHICS (if present), or the whole line.
\ap\pa
            offset = offset in pixel intensity units; default 0.0
\ap\pa
            l_type = line type to be used; default is the currently
                    enabled line type (use SHOW/GRAPHICS).
\ap\pa
            multi_color_option = data interval (1) or color data (2),
                for (1) interval:
                    low_val,hi_val                      (a)
                    low_val,hi_val(@row)                (b)
                    low_val,hi_val(frame,@row)          (c)
                    optional intensity interval where to use different colour;
                    use pixels in same line (a),
                    in another line in same frame (b),
                    or in another line in another frame (c)
                    low_val = "<" for lowest value, hi_val = ">" for highest
                    value are possible
                    (row no.s begin with 1)
                for (2) color data:
                    c=color_image,@row                  (a)
                    c=@row                              (b)
                    use color values from image `color_image' or different
                    row from plotted frame
\ap\pa
            2ndcol_spec = in_color,out_color - only neeed for (1) above
                    instead of the default color chosen via SET/GRAPH COLOR=n
                    all pixels with intensities in `interval' are
                    plotted with `in_color'
                    if out_color is provided, all pixels with intensities
                    outside `interval' are plotted with that color,
                    else they are plotted with the current default color
                    pixels are chosen according to (a), (b), (c) of `interval'
                    parameter
                    the colors can be given as plot_col no.s or directly as
                    one of: black(1), red(2), green(3), blue(4), yellow(5),
                            magenta(6), cyan(7), white(8)
\ap\no
Note:       
            After the overplot the last (over)plotted data set is the active
            one and subsequent commands will work on these data.
               If parameter `multi_color_option' is used and an image is
            interpreted as color data the values must be in the interval
            [1,8] for valid colors.
\on\see
See also:   
            SET/GRAPHICS, SHOW/GRAPHICS, PLOT/ROW, PLOT/COLUMN, OVERPLOT/COLUMN
\ees\exs
Examples:
\ex
            OVERPLOT/ROW manzana @256 @10,@100 100
              Overplots from image manzana.bdf line 256, pixels 10 
              to 100 with an offset of 100 units.
\xe\ex
            OVERPLOT/ROW platano @25 ? ? ? c=@100
              Overplot row (line) 25 of image platano.bdf. The drawing color
              is chosen according to the values in line 100 of platano.bdf.
\xe\ex
            OVERPLOT/ROW durazno @25 ? ? ? <,245.67 4
              Overplot row (line) 25 of image durazno.bdf. 
	      All pixels less than or equal to 245.67 are plotted in blue 
              (= color no. 4).
\xe \sxe
