1mlib_GraphicsDrawPolyline(3mMeLdIiBa)Lib Library Funcmtliiobn_sGraphicsDrawPolyline(3MLIB)
2
3
4

NAME

6       mlib_GraphicsDrawPolyline,  mlib_GraphicsDrawPolyline_8, mlib_Graphics‐
7       DrawPolyline_32, mlib_GraphicsDrawPolyline_X_8,  mlib_GraphicsDrawPoly‐
8       line_X_32,     mlib_GraphicsDrawPolyline_A_8,    mlib_GraphicsDrawPoly‐
9       line_A_32,    mlib_GraphicsDrawPolyline_B_8,     mlib_GraphicsDrawPoly‐
10       line_B_32,     mlib_GraphicsDrawPolyline_G_8,    mlib_GraphicsDrawPoly‐
11       line_G_32,    mlib_GraphicsDrawPolyline_Z_8,     mlib_GraphicsDrawPoly‐
12       line_Z_32,    mlib_GraphicsDrawPolyline_AB_8,    mlib_GraphicsDrawPoly‐
13       line_AB_32,   mlib_GraphicsDrawPolyline_ABG_8,   mlib_GraphicsDrawPoly‐
14       line_ABG_32,  mlib_GraphicsDrawPolyline_ABGZ_8,  mlib_GraphicsDrawPoly‐
15       line_ABGZ_32,  mlib_GraphicsDrawPolyline_ABZ_8,  mlib_GraphicsDrawPoly‐
16       line_ABZ_32,   mlib_GraphicsDrawPolyline_AG_8,   mlib_GraphicsDrawPoly‐
17       line_AG_32,   mlib_GraphicsDrawPolyline_AGZ_8,   mlib_GraphicsDrawPoly‐
18       line_AGZ_32,   mlib_GraphicsDrawPolyline_AZ_8,   mlib_GraphicsDrawPoly‐
19       line_AZ_32,   mlib_GraphicsDrawPolyline_BG_8,    mlib_GraphicsDrawPoly‐
20       line_BG_32,   mlib_GraphicsDrawPolyline_BGZ_8,   mlib_GraphicsDrawPoly‐
21       line_BGZ_32,   mlib_GraphicsDrawPolyline_BZ_8,   mlib_GraphicsDrawPoly‐
22       line_BZ_32,    mlib_GraphicsDrawPolyline_GZ_8,   mlib_GraphicsDrawPoly‐
23       line_GZ_32 - draw polyline
24

SYNOPSIS

26       cc [ flag... ] file... -lmlib [ library... ]
27       #include <mlib.h>
28
29       mlib_status mlib_GraphicsDrawPolyline_8(mlib_image *buffer,
30            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
31
32
33       mlib_status mlib_GraphicsDrawPolyline_32(mlib_image *buffer,
34            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
35
36
37       mlib_status mlib_GraphicsDrawPolyline_X_8(mlib_image *buffer,
38            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
39            mlib_s32 c2);
40
41
42       mlib_status mlib_GraphicsDrawPolyline_X_32(mlib_image *buffer,
43            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
44            mlib_s32 c2);
45
46
47       mlib_status mlib_GraphicsDrawPolyline_A_8(mlib_image *buffer,
48            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
49            mlib_s32 c);
50
51
52       mlib_status mlib_GraphicsDrawPolyline_A_32(mlib_image *buffer,
53            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
54            mlib_s32 c);
55
56
57       mlib_status mlib_GraphicsDrawPolyline_B_8(mlib_image *buffer,
58            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
59            mlib_s32 a);
60
61
62       mlib_status mlib_GraphicsDrawPolyline_B_32(mlib_image *buffer,
63            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
64            mlib_s32 a);
65
66
67       mlib_status mlib_GraphicsDrawPolyline_G_8(mlib_image *buffer,
68            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
69            const mlib_s32 *c);
70
71
72       mlib_status mlib_GraphicsDrawPolyline_G_32(mlib_image *buffer,
73            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
74            const mlib_s32 *c);
75
76
77       mlib_status mlib_GraphicsDrawPolyline_Z_8(mlib_image *buffer,
78            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
79            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
80
81
82       mlib_status mlib_GraphicsDrawPolyline_Z_32(mlib_image *buffer,
83            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
84            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
85
86
87       mlib_status mlib_GraphicsDrawPolyline_AB_8(mlib_image *buffer,
88            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
89            mlib_s32 a);
90
91
92       mlib_status mlib_GraphicsDrawPolyline_AB_32(mlib_image *buffer,
93            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
94            mlib_s32 a);
95
96
97       mlib_status mlib_GraphicsDrawPolyline_ABG_8(mlib_image *buffer,
98            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
99            const mlib_s32 *c, mlib_s32 a);
100
101
102       mlib_status mlib_GraphicsDrawPolyline_ABG_32(mlib_image *buffer,
103            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
104            const mlib_s32 *c, mlib_s32 a);
105
106
107       mlib_status mlib_GraphicsDrawPolyline_ABGZ_8(mlib_image *buffer,
108            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
109            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
110
111
112       mlib_status mlib_GraphicsDrawPolyline_ABGZ_32(mlib_image *buffer,
113            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
114            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
115
116
117       mlib_status mlib_GraphicsDrawPolyline_ABZ_8(mlib_image *buffer,
118            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
119            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
120
121
122       mlib_status mlib_GraphicsDrawPolyline_ABZ_32(mlib_image *buffer,
123            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
124            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
125
126
127       mlib_status mlib_GraphicsDrawPolyline_AG_8(mlib_image *buffer,
128            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
129            const mlib_s32 *c);
130
131
132       mlib_status mlib_GraphicsDrawPolyline_AG_32(mlib_image *buffer,
133            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
134            const mlib_s32 *c);
135
136
137       mlib_status mlib_GraphicsDrawPolyline_AGZ_8(mlib_image *buffer,
138            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
139            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
140
141
142       mlib_status mlib_GraphicsDrawPolyline_AGZ_32(mlib_image *buffer,
143            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
144            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
145
146
147       mlib_status mlib_GraphicsDrawPolyline_AZ_8(mlib_image *buffer,
148            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
149            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
150
151
152       mlib_status mlib_GraphicsDrawPolyline_AZ_32(mlib_image *buffer,
153            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
154            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
155
156
157       mlib_status mlib_GraphicsDrawPolyline_BG_8(mlib_image *buffer,
158            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
159            const mlib_s32 *c, mlib_s32 a);
160
161
162       mlib_status mlib_GraphicsDrawPolyline_BG_32(mlib_image *buffer,
163            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
164            const mlib_s32 *c, mlib_s32 a);
165
166
167       mlib_status mlib_GraphicsDrawPolyline_BGZ_8(mlib_image *buffer,
168            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
169            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
170
171
172       mlib_status mlib_GraphicsDrawPolyline_BGZ_32(mlib_image *buffer,
173            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
174            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
175
176
177       mlib_status mlib_GraphicsDrawPolyline_BZ_8(mlib_image *buffer,
178            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
179            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
180
181
182       mlib_status mlib_GraphicsDrawPolyline_BZ_32(mlib_image *buffer,
183            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
184            const mlib_s16 *z,mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
185
186
187       mlib_status mlib_GraphicsDrawPolyline_GZ_8(mlib_image *buffer,
188            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
189            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
190
191
192       mlib_status mlib_GraphicsDrawPolyline_GZ_32(mlib_image *buffer,
193            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
194            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
195
196

DESCRIPTION

198       Each of the mlib_GraphicsDrawPolyline_*() functions  draws  a  polyline
199       connecting (x1,y1), (x2,y2), ..., and (xn,yn).
200
201
202       Each  of the mlib_GraphicsDrawPolyline_X_*() functions draws a polyline
203       in Xor mode as follows:
204
205             data[x,y] ^= c ^ c2
206
207
208
209       Each of the mlib_GraphicsDrawPolyline_A_*() functions draws a  polyline
210       with antialiasing.
211
212
213       Each  of the mlib_GraphicsDrawPolyline_B_*() functions draws a polyline
214       with alpha blending as follows:
215
216             data[x,y] = (data[x,y] * (255 - a) + c * a) / 255
217
218
219
220       Each of the mlib_GraphicsDrawPolyline_G_*() functions draws a  polyline
221       with Gouraud shading.
222
223
224       Each  of the mlib_GraphicsDrawPolyline_Z_*() functions draws a polyline
225       with Z buffering.
226
227
228       Each of the other functions draws a polyline with a combination of  two
229       or  more  features  like  antialiasing (A), alpha blending (B), Gouraud
230       shading (G), and Z buffering (Z).
231
232
233       Note that the mlib_GraphicsDrawPolyline_*() functions  are  aliases  of
234       the mlib_GraphicsDrawLineStripSet_*() functions.
235

PARAMETERS

237       Each of the functions takes some of the following arguments:
238
239       buffer     Pointer to the image into which the function is drawing.
240
241
242       zbuffer    Pointer to the image that holds the Z buffer.
243
244
245       x          Pointer to array of X coordinates of the points.
246
247
248       y          Pointer to array of Y coordinates of the points.
249
250
251       z          Pointer to array of Z coordinates of the points.
252
253
254       npoints    Number of points in the arrays.
255
256
257       c          Color  used in the drawing, or pointer to array of colors of
258                  the points in the case of Gouraud shading.
259
260
261       c2         Alternation color.
262
263
264       a          Alpha value for blending. 0 ≤ a ≤ 255.
265
266

RETURN VALUES

268       Each of the functions returns MLIB_SUCCESS if successful. Otherwise  it
269       returns MLIB_FAILURE.
270

ATTRIBUTES

272       See attributes(5) for descriptions of the following attributes:
273
274
275
276
277       ┌─────────────────────────────┬─────────────────────────────┐
278       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
279       ├─────────────────────────────┼─────────────────────────────┤
280       │Interface Stability          │Committed                    │
281       ├─────────────────────────────┼─────────────────────────────┤
282       │MT-Level                     │MT-Safe                      │
283       └─────────────────────────────┴─────────────────────────────┘
284

SEE ALSO

286       mlib_GraphicsDrawLine(3MLIB),          mlib_GraphicsDrawLineSet(3MLIB),
287       mlib_GraphicsDrawLineFanSet(3MLIB),                  mlib_GraphicsDraw‐
288       LineStripSet(3MLIB), attributes(5)
289
290
291
292SunOS 5.11                        2 Mar 2007  mlib_GraphicsDrawPolyline(3MLIB)
Impressum