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) |