NAME

       libmeta.a - simplified interface to metafile(5)

SYNOPSIS

       extern FILE *pout;

       mline(x, y, type, thick, color)

       mpoly(x, y, border, pat, color)

       mdraw(x, y)

       mtext(x, y, s, cpi, color)
       char *s;

       mvstr(xmin, ymin, xmax, ymax, s, d, thick, color)
       char *s;

       mrectangle(xmin, ymin, xmax, ymax, pat, color)

       mtriangle(xmin, ymin, xmax, ymax, d, pat, color)

       msegment(xmin, ymin, xmax, ymax, sname, d, thick, color)
       char *sname;

       msetpat(pat, pattern)
       char *pattern;

       mopenseg(sname)
       char *sname;

       mcloseseg()

       minclude(fname)
       char *fname;

       mendpage()

       mdone()

DESCRIPTION

       The  routines in libmeta provide a simple interface to the metafile(5) 2D graphics stream.
       Output from these routines is sent to pout.  Pout defaults to  the  standard  output,  and
       should be piped to the appropriate device driver.

       All  coordinates  range  from 0 to 16383 and map to a square area on the output device.  D
       values are one of 'r', 'u', 'l' and  'd'  corresponding  to  right,  up,  left,  and  down
       respectively.   Color  values  range  from  0 to 3 and normally correspond to black, cyan,
       green and blue.  Pattern values range from 0 to 3 and default to solid, thick lines,  thin
       lines, and candystripe.  Pattern value mapping may be changed via setpat.  All strings are
       null-terminated, and do not contain newlines.

       Mline starts a line at the given coordinates.  The line type is  a  number  from  0  to  3
       corresponding  to  solid, dashed, dotted, and dot-dashed.  The line thickness, thick, is a
       number from 0 to 3.  Connected lines are drawn with successive calls to mdraw.

       Mpoly starts a polygon at the given coordinates.  The boolean border specifies whether  or
       not a border is desired around the polygon.  Mdraw is used to add vertices to the polygon.
       The polygon will be closed automatically after the last call.

       Mtext prints a string of hardware characters  starting  at  the  given  coordinates.   The
       characters per inch are cpi.  Text is always oriented to the right.

       Mvstr  places  a  vector  character  string  within  the  given boundaries.  The string is
       oriented according to d.  The character line thickness is given by thick.

       Mrectangle fills the given box with pat.  Mtriangle fills the half-box with orientation  d
       in  the  given boundaries.  Right corresponds to a triangle in the lower right half of the
       box.  Up corresponds to a triangle in the upper right, left is upper  left,  and  down  is
       lower left.

       Msegment places an instance of the segment sname within the given boundaries.  The segment
       is oriented according to d, where 'r' is null rotation.   If  either  thick  or  color  is
       nonzero, its value will replace corresponding values in the segment primitives.  (For area
       filling, thick changes the fill pattern.)

       Msetpat maps pat to pattern.  Pattern is a string of the form "Pn" where  n  is  a  number
       between 0 and 11.

       Mopenseg  opens  the  segment  named  sname.   All graphics calls up to a matching call to
       mcloseseg are stored under sname.  An instance of the segment is obtained with a  call  to
       msegment.   Segments  can  be  nested  to  any  level, and redefining segments is allowed.
       Beware of calls to mtext within a segment, since text will not rotate or scale.

       Minclude includes the graphics metafile fname in the output stream.  Mendpage advances  to
       the  next  screen  or  page.   On a terminal, the bell rings and a line is read to prevent
       premature erasure.  Mdone completes metafile output, and is the only required call.

DIAGNOSTICS

       None.

SEE ALSO

       t4014(1), mx80(1), impress(1), primout(3), metafile(5)