% @(#)draw_cros.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:32 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      draw_cros.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, DRAW/CROSS
%.PURPOSE    On-line help file for the command: DRAW/CROSS
%.VERSION    1.0  03-MAY-1984 : Creation, KB
%.VERSION    1.1  22-JUL-1991 : Update, KB
%----------------------------------------------------------------
\se
SECTION./CROS
\es\co
DRAW/CROSS						22-JUL-1991  KB
\oc\su
DRAW/CROSS [in_spec] [coord_ref] [draw_opt] [intens] [nocurs] [key_flag]
	draw crosses in the overlay channel
\us\pu
Purpose: 
           Draw crosses in the overlay channel.
\up\sy
Syntax:  
           DRAW/CROSS [in_spec] [coord_ref] [draw_opt] [intens] [nocurs]
                      [key_flag]
\ys\pa
           in_spec = input specification for centerpoint;
\\
                (a) CURSOR if coordinates are chosen via the cursor-1;
\\
                (b) name of table containing coordinates in columns labeled
                    :X_COORD and :Y_COORD;
\\
                (c) x1,y1 defining the coords. of center point;
\\
                (d) name of integer keyword holding the coords, max. 40 values,
                    i.e. 20 crosses, see parameter 'key_flag'
\\
                defaulted to CURSOR
\ap\pa
           coord_ref = F or S, to indicate that coordinates should be
                interpreted as screen pixels or frame coordinates in the usual
                MIDAS syntax, only applicable for option (b) and (c);
                for option (a) and (d) always screen pixels are used;
\\
                defaulted to S, also any "strange" input is interpreted as "S" !
\ap\pa
           draw_opt = length of arms of cross in screen pixels; defaulted to 3
\ap\pa
           intens = color,rotation angle (in degrees) of drawing;
\\
                the line-graph is first built up from the specs and in the
                very end rotated counter-clockwise by the rotation angle around
                the center; defaulted to WHITE,0.
\ap\pa
           nocurs = no. of cursors to use, if you specify 2, cursor rectangle
                defines the center and the size of the arms - overrides the
                size given in 'draw_opt';
\\
                defaulted to 1
\ap\pa
           key_flag = K(ey) or N(okey) to indicate that 'in_spec' holds the
                name of an integer keyword which contains the positions for
                up to 10 lines, the last coord. must be followed by a -1;
\\
                defaulted to N
\ap\sa
See also: 
           DRAW/LINE, DRAW/CIRCLE, DRAW/ELLIPS, DRAW/RECTANGLE, DRAW/ARROW
\\
           DRAW/SLIT, DRAW/ANY
\as\no
Note: 
           The parameters may also be cross referenced via
\\
           INSPEC=, COOREF=, DROPT=, INTENS=, NOCURS= and KEY=
\\
           The following colors are supported (via name or number) in X11:
\\
           Red(3), Green(4), Blue(5), White(2), Black(1), Yellow (6),
           Magenta(7), Cyan(8). All values in [9,255] are interpreted as White.
\\
           If coord_ref = F, a frame must be loaded in the displayed channel.
\\
           The cursor is moved with the mouse. Use the ENTER and EXIT buttons
           on the mouse to draw or to exit.
\\
           Due to the redrawing of the cursor some parts of the cross will 
           not have immediately the desired color, but that will be corrected,
           once you exit from the command.
\on\exs
Examples:
\ex
           DRAW/CROSS
             Use cursor to define center and draw a white cross with arms of
             size = 3 screen pixels.
\xe\ex
           DRAW/CROSS coords F 10 6
             Use values from columns :x_coord, :y_coord of table `coords.tbl',
             interpret them as real world coordinates of the currently
             displayed frame and draw crosses of size 10 with yellow color.
\xe\ex
           DRAW/CROSS 200,200 dropt=5 
             Draw a cross with center at screen pixel (200,200) of size 5.
\xe\sxe