mlib_GraphicsDrawLineStripSet_X_32(3mlib)

1mlib_GraphicsDrawLineStripSmeetd(i3aMLLiIbB)LibrarymFluinbc_tGiroanpshicsDrawLineStripSet(3MLIB)
2
3
4

NAME

6       mlib_GraphicsDrawLineStripSet,         mlib_GraphicsDrawLineStripSet_8,
7       mlib_GraphicsDrawLineStripSet_32,    mlib_GraphicsDrawLineStripSet_X_8,
8       mlib_GraphicsDrawLineStripSet_X_32,  mlib_GraphicsDrawLineStripSet_A_8,
9       mlib_GraphicsDrawLineStripSet_A_32,  mlib_GraphicsDrawLineStripSet_B_8,
10       mlib_GraphicsDrawLineStripSet_B_32,  mlib_GraphicsDrawLineStripSet_G_8,
11       mlib_GraphicsDrawLineStripSet_G_32,  mlib_GraphicsDrawLineStripSet_Z_8,
12       mlib_GraphicsDrawLineStripSet_Z_32, mlib_GraphicsDrawLineStripSet_AB_8,
13       mlib_GraphicsDrawLineStripSet_AB_32,                 mlib_GraphicsDraw‐
14       LineStripSet_ABG_8,  mlib_GraphicsDrawLineStripSet_ABG_32,  mlib_Graph‐
15       icsDrawLineStripSet_ABGZ_8,      mlib_GraphicsDrawLineStripSet_ABGZ_32,
16       mlib_GraphicsDrawLineStripSet_ABZ_8,                 mlib_GraphicsDraw‐
17       LineStripSet_ABZ_32, mlib_GraphicsDrawLineStripSet_AG_8, mlib_Graphics‐
18       DrawLineStripSet_AG_32,            mlib_GraphicsDrawLineStripSet_AGZ_8,
19       mlib_GraphicsDrawLineStripSet_AGZ_32,                mlib_GraphicsDraw‐
20       LineStripSet_AZ_8,  mlib_GraphicsDrawLineStripSet_AZ_32, mlib_Graphics‐
21       DrawLineStripSet_BG_8, mlib_GraphicsDrawLineStripSet_BG_32, mlib_Graph‐
22       icsDrawLineStripSet_BGZ_8,        mlib_GraphicsDrawLineStripSet_BGZ_32,
23       mlib_GraphicsDrawLineStripSet_BZ_8,                  mlib_GraphicsDraw‐
24       LineStripSet_BZ_32,  mlib_GraphicsDrawLineStripSet_GZ_8, mlib_Graphics‐
25       DrawLineStripSet_GZ_32 - draw line set where each  member  of  the  set
26       starts at the point where the previous member ended
27

SYNOPSIS

29       cc [ flag... ] file... -lmlib [ library... ]
30       #include <mlib.h>
31
32       mlib_status mlib_GraphicsDrawLineStripSet_8(mlib_image *buffer,
33            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
34
35
36       mlib_status mlib_GraphicsDrawLineStripSet_32(mlib_image *buffer,
37            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
38
39
40       mlib_status mlib_GraphicsDrawLineStripSet_X_8(mlib_image *buffer,
41            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
42            mlib_s32 c2);
43
44
45       mlib_status mlib_GraphicsDrawLineStripSet_X_32(mlib_image *buffer,
46            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
47            mlib_s32 c2);
48
49
50       mlib_status mlib_GraphicsDrawLineStripSet_A_8(mlib_image *buffer,
51            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
52
53
54       mlib_status mlib_GraphicsDrawLineStripSet_A_32(mlib_image *buffer,
55            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
56
57
58       mlib_status mlib_GraphicsDrawLineStripSet_B_8(mlib_image *buffer,
59            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
60            mlib_s32 a);
61
62
63       mlib_status mlib_GraphicsDrawLineStripSet_B_32(mlib_image *buffer,
64            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
65            mlib_s32 a);
66
67
68       mlib_status mlib_GraphicsDrawLineStripSet_G_8(mlib_image *buffer,
69            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
70            const mlib_s32 *c);
71
72
73       mlib_status mlib_GraphicsDrawLineStripSet_G_32(mlib_image *buffer,
74            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
75            const mlib_s32 *c);
76
77
78       mlib_status mlib_GraphicsDrawLineStripSet_Z_8(mlib_image *buffer,
79            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
80            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
81
82
83       mlib_status mlib_GraphicsDrawLineStripSet_Z_32(mlib_image *buffer,
84            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
85            const mlib_s16 *z,
86            mlib_s32 npoints, mlib_s32 c);
87
88
89       mlib_status mlib_GraphicsDrawLineStripSet_AB_8(mlib_image *buffer,
90            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
91            mlib_s32 a);
92
93
94       mlib_status mlib_GraphicsDrawLineStripSet_AB_32(mlib_image *buffer,
95            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
96            mlib_s32 c, mlib_s32 a);
97
98
99       mlib_status mlib_GraphicsDrawLineStripSet_ABG_8(mlib_image *buffer,
100            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
101            const mlib_s32 *c, mlib_s32 a);
102
103
104       mlib_status mlib_GraphicsDrawLineStripSet_ABG_32(mlib_image *buffer,
105            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
106            const mlib_s32 *c, mlib_s32 a);
107
108
109       mlib_status mlib_GraphicsDrawLineStripSet_ABGZ_8(mlib_image *buffer,
110            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
111            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
112
113
114       mlib_status mlib_GraphicsDrawLineStripSet_ABGZ_32(mlib_image *buffer,
115            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
116            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
117
118
119       mlib_status mlib_GraphicsDrawLineStripSet_ABZ_8(mlib_image *buffer,
120            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
121            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
122
123
124       mlib_status mlib_GraphicsDrawLineStripSet_ABZ_32(mlib_image *buffer,
125            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
126            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
127
128
129       mlib_status mlib_GraphicsDrawLineStripSet_AG_8(mlib_image *buffer,
130            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
131            const mlib_s32 *c);
132
133
134       mlib_status mlib_GraphicsDrawLineStripSet_AG_32(mlib_image *buffer,
135            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
136            const mlib_s32 *c);
137
138
139       mlib_status mlib_GraphicsDrawLineStripSet_AGZ_8(mlib_image *buffer,
140            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
141            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
142
143
144       mlib_status mlib_GraphicsDrawLineStripSet_AGZ_32(mlib_image *buffer,
145            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
146            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
147
148
149       mlib_status mlib_GraphicsDrawLineStripSet_AZ_8(mlib_image *buffer,
150            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
151            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
152
153
154       mlib_status mlib_GraphicsDrawLineStripSet_AZ_32(mlib_image *buffer,
155            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
156            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
157
158
159       mlib_status mlib_GraphicsDrawLineStripSet_BG_8(mlib_image *buffer,
160            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
161            const mlib_s32 *c, mlib_s32 a);
162
163
164       mlib_status mlib_GraphicsDrawLineStripSet_BG_32(mlib_image *buffer,
165            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
166            const mlib_s32 *c, mlib_s32 a);
167
168
169       mlib_status mlib_GraphicsDrawLineStripSet_BGZ_8(mlib_image *buffer,
170            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
171            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
172
173
174       mlib_status mlib_GraphicsDrawLineStripSet_BGZ_32(mlib_image *buffer,
175            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
176            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
177
178
179       mlib_status mlib_GraphicsDrawLineStripSet_BZ_8(mlib_image *buffer,
180            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
181            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
182
183
184       mlib_status mlib_GraphicsDrawLineStripSet_BZ_32(mlib_image *buffer,
185            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
186            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
187
188
189       mlib_status mlib_GraphicsDrawLineStripSet_GZ_8(mlib_image *buffer,
190            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
191            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
192
193
194       mlib_status mlib_GraphicsDrawLineStripSet_GZ_32(mlib_image *buffer,
195            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
196            const mlib_s16 *z,
197            mlib_s32 npoints, const mlib_s32 *c);
198
199

DESCRIPTION

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

PARAMETERS

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

RETURN VALUES

272       Each of the functions returns MLIB_SUCCESS if successful. Otherwise  it
273       returns MLIB_FAILURE.
274

ATTRIBUTES

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

NAME

SYNOPSIS

DESCRIPTION

PARAMETERS

RETURN VALUES

ATTRIBUTES

SEE ALSO