1 DRAW
  Syntax: DRAW item|command ...
   where: item       is ARC, ARROW, BOX, CIRCLE, ELLIPSE, GLUON, LINE,
                     POLYGON, POLYLINE, SEGMENT, SINE, SYMBOL or TRIANGLE
          command    is CHANGE, DELETE, LIST, FETCH, STORE, or END

  Draws an item on the  plot. See HELP DRAW Menu for a short
  description of each comand. All of the first  set of parameters can take
  default  values if  you hit  `<CR>'. For  `mode  CM', `x=0,  y=0' is the
  bottom left-hand  corner of the  picture. If you want  to change an item
  you have  drawn, then  give the  command `DRAW  CHANGE' and  you will be
  prompted for the item you want to change and what you want to change.

  If you just give the command  `DRAW' you will remain in `DRAW' until you
  give the `END'  command or `<CR>'.  However, if you  give some or all of
  the rest of the `DRAW'  command on the same  line you will automatically
  exit `DRAW' after you have defined an item.

  If you have the mouse turned on, `SET MOUSE ON', the coordinates of the
  items are defined by using the mouse. In the case of a `CIRCLE' give
  the centre and a point on the radius; for an `ARC' give the centre,
  the bottom right corner and the top left corner; for an ellipse give
  the centre, the major axis and the minor axis.

  The default is for items to be drawn after all the plots. If you set
  the `fl' option to 1, the items will be drawn after the 1st plot
  when you give a `REDRAW' or `HARDCOPY' command. You can use this
  option together with `PLOT/EMPTY' to draw an empty frame and then
  the items you want before any histograms. This option is useful if
  you use hatch -3 for example that is not transparent. The option is
  ignored if you are drawing without a plot.

  The hatch and pattern colours are by default the same as the outline
  colour, but can also be given on the command line. If you want to
  solidly fill an object use pattern 100.

  If you are  fitting  more than one  histogram  the item(s)  will only be
  drawn on the last plot. If you select plot units (`mode PLOT') they will
  be for the last plot that you have drawn. However, if you have more than
  one window the correct units will be used.

  If you want to draw without a plot, you should use `SET X|Y PSIZE'
  to set the size of the picture and then give the `CLEAR' command to
  make sure the coordinate system is setup properly.

  If you want your coordinate system to be more flexible you can also
  draw in plot coordinates, even if you have not made a plot. Set the
  X and Y limits, and then specify plot coordinates. Note that the
  coordinate transformation is done as if you had made a plot,
  i.e. `SET X|Y SIZE' sets the physical size, and the `X|Y MARGIN' are
  also respected. If the X and Y limits are set to default, then the
  plot coordinates are the same as the physical coordinates.

  If you want to give the coordinates of the item to draw on the same
  line as the option you must give all the parameters (8 for
  `POLYLINE' and `POLYGON', 7 for the rest). For those that you do not
  want to change give an `='. If you give the coordinates on a new
  line, then you only need to give those parameters for which you are
  not happy with the default.

2 Menu
  The following is the list of `DRAW' commands.
  For more details see HELP DRAW and the individual subtopics:

  ARC        Draws an arc of a circle.
  ARROW      Draws an arrow.
  BOX        Draws a box.
  CIRCLE     Draws a circle.
  ELLIPSE    Draws an ellipse.
  GLUON      Draws a gluon line.
  LINE       Draws a line.
  POLYGON    Draws a polygon.
  POLYLINE   Draws a polyline.
  SEGMENT    Draws a segment of a circle.
  SINE       Draws a sine wave.
  SYMBOL     Draws a symbol.
  TRIANGLE   Draws a triangle.
  CHANGE     Changes a drawn item.
  DELETE     Deletes one or more drawn items.
  LIST       Lists the items to draw.
  FETCH      Fetches a drawing.
  STORE      Stores a drawing in a file  .
  END        End of drawing.

2 ARC
  Syntax:  DRAW ARC symbol colour thick units hatch pattern fl hcol pcol
           x,y
           r1,r2
           phi1,phi2
  where:   symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           hatch      is the hatch symbol to fill the shape
           pattern    is the pattern symbol to fill the shape
           fl         is whether to draw the item first (1) or last (0)
           hcol       is the hatch colour
           pcol       is the pattern colour
           x,y        are the coordinates of the centre of the circle(s)
           r1,r2      are the inner and outer radii of the circles
           phi1,phi2  are the phi angles of the arc (in degrees)

  Draws an arc of one or two circles. If the hatch or pattern is not
  zero the area between the two arcs is filled. If you want to solidly
  fill an object use pattern 100. If you want to draw just one circle
  and the lines from the centre to the ends of the arc, give the first
  radius as zero (using IGARC, see HELP SET IGARC for more details).
  If you just want one arc, give the same value for both radii.

  The HIGZ arc drawing routine IGARC sometimes ignores what you set
  for colour and thickness. As an alternative use `SET IGARC OFF'
  which will let Mn_Fit draw the arc.

2 ARROW
  Syntax:  DRAW ARROW symbol colour thick units type dummy fl
           x1,y1
           x2,y2
   where:  symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           type       is the type of the arrow
                      1  = tip of arrow on (x2,y2)
                      2  = tip of arrow on (x1,y1)
                      3  = tip on both ends
                      4  = tip in middle
                      -n = arrow is filled
           dummy      is an unused parameter
           fl         is whether to draw the item first (1) or last (0)
           x1,y1      is the coordinate of the tail of the arrow
           x2,y2      is the coordinate of the head of the arrow

  Draws an arrow.

2 BOX
  Syntax:  DRAW BOX symbol colour thick units hatch pattern fl hcol pcol
           x1,y1
           x2,y2
  where:   symbol     is the symbol number
           colour     is the colour of the box
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           hatch      is the hatch symbol to fill the shape
           pattern    is the pattern symbol to fill the shape
           fl         is whether to draw the item first (1) or last (0)
           hcol       is the hatch colour
           pcol       is the pattern colour
           x1,y1      is the coordinate of one corner
           x2,y2      is the coordinate of the opposite corner

  Draws a box using the lower left and upper right coordinates. If you
  want to solidly fill the box use pattern 100.

2 CIRCLE
  Syntax:  DRAW CIRCLE symbol colour thick units hatch pattern fl hcol pcol
           x,y
           r1,r2
  where:   symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           hatch      is the hatch symbol to fill the shape
           pattern    is the pattern symbol to fill the shape
           fl         is whether to draw the item first (1) or last (0)
           hcol       is the hatch colour
           pcol       is the pattern colour
           x,y        are the coordinates of the centre of the circle(s)
           r1,r2      are the inner and outer radii of the circles

  Draws one or two circles. If the hatch or pattern is not zero the
  area between the two circles is filled.  If you want to solidly fill
  the circle use pattern 100. If you want to draw just one circle give
  the first radius as zero.

  If you use the mouse to give the position and size of the circle,
  you can only draw a single circle.

  The HIGZ arc drawing routine IGARC sometimes ignores what you set
  for colour and thickness. As an alternative use `SET IGARC OFF'
  which will let Mn_Fit draw the arc.

2 ELLIPSE
  Syntax:  DRAW ELLIPSE symbol colour thick units hatch pattern fl hcol pcol
           x,y
           r1,r2
           phi
  where:   symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           hatch      is the hatch symbol to fill the shape
           pattern    is the pattern symbol to fill the shape
           fl         is whether to draw the item first (1) or last (0)
           hcol       is the hatch colour
           pcol       is the pattern colour
           x,y        are the coordinates of the centre of the ellipse
           r1,r2      are the major and minor axis half-lengths
           phi1       is the rotation angle of the ellipse (in degrees)

  Draws an ellipse. If the hatch or pattern is not zero the ellipse is
  filled. If you want to solidly fill the ellipse use pattern 100.

2 GLUON
  Syntax:  DRAW GLUON symbol colour thick units amplitude period fl
           x1,y1
           x2,y2
  where:   symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           amplitude  is the amplitude of the gluon line
           period     is the length of 1 period
           fl         is whether to draw the item first (1) or last (0)
           x1,y1      is the coordinate of one end of the line
           x2,y2      is the coordinate of the other end of the line

  Draws a gluon line. If the period of a gluon oscillation is not given,
  the amplitude will be used.

2 LINE
  Syntax:  DRAW LINE symbol colour thick units dummy dummy fl
           x1,y1
           x2,y2
  where:   symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           fl         is whether to draw the item first (1) or last (0)
           x1,y1      is the coordinate of one end of the line
           x2,y2      is the coordinate of the other end of the line

  Draws a line.

2 POLYGON
  Syntax:  DRAW POLYGON npoint symbol colour thick units hatch patt fl hcol pcol
           x1,y1
           x2,y2 ...
  where:   npoint     is the number of points on the polygon
           symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           hatch      is the hatch symbol to fill the shape
           patt       is the pattern symbol to fill the shape
           fl         is whether to draw the item first (1) or last (0)
           hcol       is the hatch colour
           pcol       is the pattern colour
           x1,y1      is the coordinate of the first point
           x2,y2      is the coordinate of the second point etc.

  Draws a polygon. If you want to solidly fill the polygon use pattern
  100.

2 POLYLINE
  Syntax:  DRAW POLYLINE npoint symbol colour thick units dummy dummy fl
           x1,y1
           x2,y2 ...
  where:   npoint     is the number of points on the line
           symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           dummy      is an unused parameter
           fl         is whether to draw the item first (1) or last (0)
           x1,y1      is the coordinate of the first point
           x2,y2      is the coordinate of the second point etc.

  Draws a polyline.

2 SEGMENT
  Syntax:  DRAW SEGMENT symbol colour thick units hatch pattern fl hcol pcol
           x1, y1
           x2, y2
           sagitta
  where:   symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           fl         is whether to draw the item first (1) or last (0)
           x1,y1      are the coordinates of one end
           x2,y2      are the coordinates of the other end
           sagitta    is the sagitta

  Draws a segment of a circle. This form is useful if you know the 2
  endpoints and the sagitta, rather than the centre and angles.
  If you want to fill the area you have to use `DRAW ARC'.

  The HIGZ arc drawing routine IGARC sometimes ignores what you set
  for colour and thickness. As an alternative use `SET IGARC OFF'
  which will let Mn_Fit draw the arc.

2 SINE
  Syntax:  DRAW SINE symbol colour thick units amplitude period fl
           x1,y1
           x2,y2
  where:   symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           amplitude  is the amplitude of the sine wave
           period     is the length of 1 period
           fl         is whether to draw the item first (1) or last (0)
           x1,y1      is the coordinate of one end of the line
           x2,y2      is the coordinate of other end of the line

  Draws a sine curve. If the period of the sine wave is not given,
  the amplitude will be used.

2 SYMBOL
  Syntax:  DRAW SYMBOL symbol colour size units dummy dummy fl
           x1,y1
  where:   symbol     is the symbol number
           colour     is the colour of the line
           size       is the size of the symbol
           units      are the units to use (CM or PLOT units)
           fl         is whether to draw the item first (1) or last (0)
           x1,y1      is the coordinate of the symbol

  Draws a symbol.


2 TRIANGLE
  Syntax:  DRAW TRIANGLE symbol colour thick units hatch pattern fl hcol pcol
           x1,y1
           x2,y2
           x3,y3
  where:   symbol     is the symbol number
           colour     is the colour of the line
           thick      is the line thickness (scale factor)
           units      are the units to use (CM or PLOT units)
           size       is the amplitude of the sine wave
           fl         is whether to draw the item first (1) or last (0)
           hcol       is the hatch colour
           pcol       is the pattern colour
           x1,y1      is the coordinate of the first point
           x2,y2      is the coordinate of the second point
           x3,y3      is the coordinate of the third point

  Draws a triangle. If you want to solidly fill the triangle use
  pattern 100.

2 CHANGE
  Syntax:  DRAW CHANGE number
   where:  number     is the item number to change

  Changes a drawn item.

2 DELETE
  Syntax:  DRAW DELETE number
   where:  number     is the item number to change

  Deletes one or more items to draw. `DELETE 0' deletes them all.

2 FETCH
  Syntax:  DRAW FETCH filename
   where:  filename   is the file with a stored drawing

  Fetches a list of drawing commands made with `DRAW STORE'. The new items
  are added to any that have already been made.

2 LIST
  Syntax:  DRAW LIST

  Lists the items to draw.

2 STORE
  Syntax:  DRAW STORE filename number
   where:  filename   is the file with a stored drawing
           number     is the item number to store

  Stores one or more drawn items in a file. Item number 0 means store all
  items.

2 END
  Syntax:  DRAW END

  Finish drawing. Only used if you are already in `DRAW'.

2 Examples

!\begin{enumerate}
!\item
!^
  Example 1:

    Draw a red arrow in cm with a filled arrow symbol in the middle
    with ends (1,1), (3,4)
    Put the complete syntax on one line:

    set x psize 10
    set y psize  5
    clear
    DRAW ARROW 1 red 4 cm -4 = = 1 1 3 4

!\item
!^
  Example 2:

    Draw an arc in cyan. The centre of the arc is at (5,5). It has
    radii of 2 and 4 cm, and goes from 50 to 100 degrees. The arc is
    filled with hatch 345. Split things across several lines to avoid
    giving all parameters:

    set x psize 10
    set y psize 10
    clear
    DRAW arc 3 cyan = 345
    5 5
    2 4
    50 100

!\item
!^
  Example 3:

    Make a square in plot coordinates. Set the margins to a non-zero
    small value, as 0 will set them to the default:

    set x psize 10.2
    set y psize 10.2
    set x margin 0.1
    set y margin 0.1
    set x size 10
    set y size 10
    clear
    set x lim -10 10
    set y lim -10 10
    DRAW box 3 magenta = pl
    -6 -6
    +6 +6
    ! Now distort it
    set y lim -8 8
    redraw

!\end{enumerate}

