Radiance meta program

META(3)                                                                META(3)

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  num-
       ber 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  tri-
       angle 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)

Radiance                           11/15/93                            META(3)