% @(#)draw_any.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:32 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      draw_any.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, DRAW/ANY
%.PURPOSE    On-line help file for the command: DRAW/ANY
%.VERSION    1.0  03-MAY-1984 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./ANY
\es\co
DRAW/ANY						26-MAR-1998  KB
\oc\su
DRAW/ANY [intens]
	draw manually or with input from file into the overlay channel
\us\pu
Purpose:
            Draw manually (via mouse) or using input from an ASCII file
            into the overlay channel.
\up\sy
Syntax: 
            DRAW/ANY [in_specs]
\ys\pa
            in_specs = color for manual line drawing, 
\\
                       or name of an ASCII file (specified as name.type)
                       with DRAW commands like DRAW/CIRCLE, DRAW/LINE, etc.
\\
                       defaulted to WHITE (i.e. color)
\ap\see
See also:   DRAW/RECTANGLE, /CIRCLE, /ELLIPS, /SLIT, /ARROW, /CROSS, /LINE
\ees\no
Note:
            Manual drawing:
\\
              The following colors are supported (via name or number) in X11:
\\
              Black(1), White(2), Red(3), Green(4), Blue(5), Yellow(6),
              Magenta(7), Cyan(8).
\\
              The cursor is moved with the mouse, pressing the ENTER button 
              starts the drawing. Use the EXIT button to interrupt drawing,
              move the mouse and press ENTER again to start drawing at new
              point. 
              Press the EXIT button twice to really exit.
\\
            Drawing with file input:
\\
              The ASCII file must hold records containing full DRAW commands,
              e.g. DRAW/CIRCLE 234,123,29 s nofill black
\\
                   DRAW/LINE 123.,233.,190.,400. frame 
\on\exs
Examples:
\ex
            DRAW/ANY blue
              Draw interactively with the mouse using blue color.
\xe \ex
            DRAW/ANY plot.dat
              Read all lines of ASCII file plot.dat and execute the commands
              written. Lines hold any DRAW command.
\xe \sxe