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)
