man/man3/meta.3

.\" RCSid "$Id$"
.TH META 3 11/15/93 Radiance
.SH NAME
libmeta.a - simplified interface to metafile(5)
.SH SYNOPSIS
.B extern FILE  *pout;
.PP
.B mline(x, y, type, thick, color)
.PP
.B mpoly(x, y, border, pat, color)
.PP
.B mdraw(x, y)
.PP
.B mtext(x, y, s, cpi, color)
.br
.B char  *s;
.PP
mvstr(xmin, ymin, xmax, ymax, s, d, thick, color)
.br
.B char  *s;
.PP
mrectangle(xmin, ymin, xmax, ymax, pat, color)
.PP
mtriangle(xmin, ymin, xmax, ymax, d, pat, color)
.PP
msegment(xmin, ymin, xmax, ymax, sname, d, thick, color)
.br
.B char  *sname;
.PP
.B msetpat(pat, pattern)
.br
.B char  *pattern;
.PP
.B mopenseg(sname)
.br
.B char  *sname;
.PP
.B mcloseseg()
.PP
.B minclude(fname)
.br
.B char  *fname;
.PP
.B mendpage()
.PP
.B mdone()
.SH DESCRIPTION
The routines in
.I libmeta
provide a simple interface to the metafile(5) 2D graphics stream.
Output from these routines is sent to 
.I pout.
.I Pout
defaults to the standard output,
and should be piped to the appropriate device driver.
.PP
All coordinates range from 0 to 16383 and map to a square area on
the output device.
.I D
values are one of 'r', 'u', 'l' and 'd' corresponding to right,
up, left, and down respectively.
.I Color
values range from 0 to 3 and normally correspond to black,
cyan, green and blue.
.I Pattern
values range from 0 to 3 and default to solid, thick lines,
thin lines, and candystripe.
Pattern value mapping may be changed via
.I setpat.
All strings are null-terminated, and do not contain newlines.
.PP
.I Mline
starts a line at the given coordinates.
The line
.I type
is a number from 0 to 3 corresponding to solid, dashed, dotted,
and dot-dashed.
The line thickness,
.I thick,
is a number from 0 to 3.
Connected lines are drawn with successive calls to
.I mdraw.
.PP
.I Mpoly
starts a polygon at the given coordinates.
The boolean
.I border
specifies whether or not a border is desired around the polygon.
.I Mdraw
is used to add vertices to the polygon.
The polygon will be closed automatically after the last call.
.PP
.I Mtext
prints a string of hardware characters starting at the given
coordinates.
The characters per inch are
.I cpi.
Text is always oriented to the right.
.PP
.I Mvstr
places a vector character string within the given boundaries.
The string is oriented according to
.I d.
The character line thickness is given by
.I thick.
.PP
.I Mrectangle
fills the given box with
.I pat.
.I Mtriangle
fills the half-box with orientation
.I 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.
.PP
.I Msegment
places an instance of the segment
.I sname
within the given boundaries.
The segment is oriented according to
.I d,
where 'r' is null rotation.
If either
.I thick
or
.I color
is nonzero,
its value will replace corresponding values in the segment
primitives.  (For area filling, thick changes the fill pattern.)
.PP
.I Msetpat
maps
.I pat
to
.I pattern.
.I Pattern
is a string of the form "Pn" where n is a number between 0 and 11.
.PP
.I Mopenseg
opens the segment named
.I sname.
All graphics calls up to a matching call to
.I mcloseseg
are stored under
.I sname.
An instance of the segment is obtained with a call to
.I msegment.
Segments can be nested to any level, and redefining segments
is allowed.
Beware of calls to
.I mtext
within a segment, since text will not rotate or scale.
.PP
.I Minclude
includes the graphics metafile
.I fname
in the output stream.
.I Mendpage
advances to the next screen or page.
On a terminal, the bell rings and a line is read to prevent
premature erasure.
.I Mdone
completes metafile output, and is the only required call.
.SH DIAGNOSTICS
None.
.SH SEE ALSO
t4014(1), mx80(1), impress(1), primout(3), metafile(5)
Revision:	1.2
Committed:	Tue Dec 9 15:59:07 2003 UTC (20 years, 4 months ago) by greg
Branch:	MAIN
CVS Tags:	rad5R4, rad5R2, rad4R2P2, rad5R0, rad5R1, rad3R7P2, rad3R7P1, rad4R2, rad4R1, rad4R0, rad3R6, rad3R6P1, rad3R8, rad3R9, rad4R2P1, rad5R3, HEAD
Changes since 1.1:	+1 -1 lines
Log Message:	Fixed RCSid specification
#	Content
1	.\" RCSid "$Id$"
2	.TH META 3 11/15/93 Radiance
3	.SH NAME
4	libmeta.a - simplified interface to metafile(5)
5	.SH SYNOPSIS
6	.B extern FILE *pout;
7	.PP
8	.B mline(x, y, type, thick, color)
9	.PP
10	.B mpoly(x, y, border, pat, color)
11	.PP
12	.B mdraw(x, y)
13	.PP
14	.B mtext(x, y, s, cpi, color)
15	.br
16	.B char *s;
17	.PP
18	mvstr(xmin, ymin, xmax, ymax, s, d, thick, color)
19	.br
20	.B char *s;
21	.PP
22	mrectangle(xmin, ymin, xmax, ymax, pat, color)
23	.PP
24	mtriangle(xmin, ymin, xmax, ymax, d, pat, color)
25	.PP
26	msegment(xmin, ymin, xmax, ymax, sname, d, thick, color)
27	.br
28	.B char *sname;
29	.PP
30	.B msetpat(pat, pattern)
31	.br
32	.B char *pattern;
33	.PP
34	.B mopenseg(sname)
35	.br
36	.B char *sname;
37	.PP
38	.B mcloseseg()
39	.PP
40	.B minclude(fname)
41	.br
42	.B char *fname;
43	.PP
44	.B mendpage()
45	.PP
46	.B mdone()
47	.SH DESCRIPTION
48	The routines in
49	.I libmeta
50	provide a simple interface to the metafile(5) 2D graphics stream.
51	Output from these routines is sent to
52	.I pout.
53	.I Pout
54	defaults to the standard output,
55	and should be piped to the appropriate device driver.
56	.PP
57	All coordinates range from 0 to 16383 and map to a square area on
58	the output device.
59	.I D
60	values are one of 'r', 'u', 'l' and 'd' corresponding to right,
61	up, left, and down respectively.
62	.I Color
63	values range from 0 to 3 and normally correspond to black,
64	cyan, green and blue.
65	.I Pattern
66	values range from 0 to 3 and default to solid, thick lines,
67	thin lines, and candystripe.
68	Pattern value mapping may be changed via
69	.I setpat.
70	All strings are null-terminated, and do not contain newlines.
71	.PP
72	.I Mline
73	starts a line at the given coordinates.
74	The line
75	.I type
76	is a number from 0 to 3 corresponding to solid, dashed, dotted,
77	and dot-dashed.
78	The line thickness,
79	.I thick,
80	is a number from 0 to 3.
81	Connected lines are drawn with successive calls to
82	.I mdraw.
83	.PP
84	.I Mpoly
85	starts a polygon at the given coordinates.
86	The boolean
87	.I border
88	specifies whether or not a border is desired around the polygon.
89	.I Mdraw
90	is used to add vertices to the polygon.
91	The polygon will be closed automatically after the last call.
92	.PP
93	.I Mtext
94	prints a string of hardware characters starting at the given
95	coordinates.
96	The characters per inch are
97	.I cpi.
98	Text is always oriented to the right.
99	.PP
100	.I Mvstr
101	places a vector character string within the given boundaries.
102	The string is oriented according to
103	.I d.
104	The character line thickness is given by
105	.I thick.
106	.PP
107	.I Mrectangle
108	fills the given box with
109	.I pat.
110	.I Mtriangle
111	fills the half-box with orientation
112	.I d
113	in the given boundaries.
114	Right corresponds to a triangle in the lower right half of the
115	box.
116	Up corresponds to a triangle in the upper right, left is upper
117	left, and down is lower left.
118	.PP
119	.I Msegment
120	places an instance of the segment
121	.I sname
122	within the given boundaries.
123	The segment is oriented according to
124	.I d,
125	where 'r' is null rotation.
126	If either
127	.I thick
128	or
129	.I color
130	is nonzero,
131	its value will replace corresponding values in the segment
132	primitives. (For area filling, thick changes the fill pattern.)
133	.PP
134	.I Msetpat
135	maps
136	.I pat
137	to
138	.I pattern.
139	.I Pattern
140	is a string of the form "Pn" where n is a number between 0 and 11.
141	.PP
142	.I Mopenseg
143	opens the segment named
144	.I sname.
145	All graphics calls up to a matching call to
146	.I mcloseseg
147	are stored under
148	.I sname.
149	An instance of the segment is obtained with a call to
150	.I msegment.
151	Segments can be nested to any level, and redefining segments
152	is allowed.
153	Beware of calls to
154	.I mtext
155	within a segment, since text will not rotate or scale.
156	.PP
157	.I Minclude
158	includes the graphics metafile
159	.I fname
160	in the output stream.
161	.I Mendpage
162	advances to the next screen or page.
163	On a terminal, the bell rings and a line is read to prevent
164	premature erasure.
165	.I Mdone
166	completes metafile output, and is the only required call.
167	.SH DIAGNOSTICS
168	None.
169	.SH SEE ALSO
170	t4014(1), mx80(1), impress(1), primout(3), metafile(5)