mlib_GraphicsDrawLineSet_A_8(3mlib)

1mlib_GraphicsDrawLineSet(3MmLeIdBi)aLib Library Functmiloinbs_GraphicsDrawLineSet(3MLIB)
2
3
4

NAME

6       mlib_GraphicsDrawLineSet,   mlib_GraphicsDrawLineSet_8,  mlib_Graphics‐
7       DrawLineSet_32,  mlib_GraphicsDrawLineSet_X_8,   mlib_GraphicsDrawLine‐
8       Set_X_32,  mlib_GraphicsDrawLineSet_A_8, mlib_GraphicsDrawLineSet_A_32,
9       mlib_GraphicsDrawLineSet_B_8,            mlib_GraphicsDrawLineSet_B_32,
10       mlib_GraphicsDrawLineSet_G_8,            mlib_GraphicsDrawLineSet_G_32,
11       mlib_GraphicsDrawLineSet_Z_8,            mlib_GraphicsDrawLineSet_Z_32,
12       mlib_GraphicsDrawLineSet_AB_8,          mlib_GraphicsDrawLineSet_AB_32,
13       mlib_GraphicsDrawLineSet_ABG_8,        mlib_GraphicsDrawLineSet_ABG_32,
14       mlib_GraphicsDrawLineSet_ABGZ_8,      mlib_GraphicsDrawLineSet_ABGZ_32,
15       mlib_GraphicsDrawLineSet_ABZ_8,        mlib_GraphicsDrawLineSet_ABZ_32,
16       mlib_GraphicsDrawLineSet_AG_8,          mlib_GraphicsDrawLineSet_AG_32,
17       mlib_GraphicsDrawLineSet_AGZ_8,        mlib_GraphicsDrawLineSet_AGZ_32,
18       mlib_GraphicsDrawLineSet_AZ_8,          mlib_GraphicsDrawLineSet_AZ_32,
19       mlib_GraphicsDrawLineSet_BG_8,          mlib_GraphicsDrawLineSet_BG_32,
20       mlib_GraphicsDrawLineSet_BGZ_8,        mlib_GraphicsDrawLineSet_BGZ_32,
21       mlib_GraphicsDrawLineSet_BZ_8,          mlib_GraphicsDrawLineSet_BZ_32,
22       mlib_GraphicsDrawLineSet_GZ_8,  mlib_GraphicsDrawLineSet_GZ_32  -  draw
23       line set where each member can have different end points
24

SYNOPSIS

26       cc [ flag... ] file... -lmlib [ library... ]
27       #include <mlib.h>
28
29       mlib_status mlib_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_X_8(mlib_image *buffer,
38            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
39            mlib_s32 c, mlib_s32 c2);
40
41
42       mlib_status mlib_GraphicsDrawLineSet_X_32(mlib_image *buffer,
43            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
44            mlib_s32 c, mlib_s32 c2);
45
46
47       mlib_status mlib_GraphicsDrawLineSet_A_8(mlib_image *buffer,
48            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
49
50
51       mlib_status mlib_GraphicsDrawLineSet_A_32(mlib_image *buffer,
52            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
53
54
55       mlib_status mlib_GraphicsDrawLineSet_B_8(mlib_image *buffer,
56            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
57            mlib_s32 c, mlib_s32 a);
58
59
60       mlib_status mlib_GraphicsDrawLineSet_B_32(mlib_image *buffer,
61            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
62            mlib_s32 c, mlib_s32 a);
63
64
65       mlib_status mlib_GraphicsDrawLineSet_G_8(mlib_image *buffer,
66            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
67            const mlib_s32 *c);
68
69
70       mlib_status mlib_GraphicsDrawLineSet_G_32(mlib_image *buffer,
71            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
72             const mlib_s32 *c);
73
74
75       mlib_status mlib_GraphicsDrawLineSet_Z_8(mlib_image *buffer,
76            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
77            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
78
79
80       mlib_status mlib_GraphicsDrawLineSet_Z_32(mlib_image *buffer,
81            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
82            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
83
84
85       mlib_status mlib_GraphicsDrawLineSet_AB_8(mlib_image *buffer,
86            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
87            mlib_s32 c, mlib_s32 a);
88
89
90       mlib_status mlib_GraphicsDrawLineSet_AB_32(mlib_image *buffer,
91            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
92            mlib_s32 c, mlib_s32 a);
93
94
95       mlib_status mlib_GraphicsDrawLineSet_ABG_8(mlib_image *buffer,
96            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
97            const mlib_s32 *c, mlib_s32 a);
98
99
100       mlib_status mlib_GraphicsDrawLineSet_ABG_32(mlib_image *buffer,
101            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
102            const mlib_s32 *c, mlib_s32 a);
103
104
105       mlib_status mlib_GraphicsDrawLineSet_ABGZ_8(mlib_image *buffer,
106            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
107            const mlib_s16 *z, mlib_s32 npoints,
108            const mlib_s32 *c, mlib_s32 a);
109
110
111       mlib_status mlib_GraphicsDrawLineSet_ABGZ_32(mlib_image *buffer,
112            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
113            const mlib_s16 *z, mlib_s32 npoints,
114            const mlib_s32 *c, mlib_s32 a);
115
116
117       mlib_status mlib_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_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_GraphicsDrawLineSet_*() functions draws a set of lines
199       connecting  (x1,y1)  with  (x2,y2),  (x3,y3)  with  (x4,y4),  ...,  and
200       (xn-1,yn-1) with (xn,yn).
201
202
203       Each of the mlib_GraphicsDrawLineSet_X_*() functions  draws  a  set  of
204       lines in Xor mode as follows:
205
206             data[x,y] ^= c ^ c2
207
208
209
210       Each  of  the  mlib_GraphicsDrawLineSet_A_*()  functions draws a set of
211       lines with antialiasing.
212
213
214       Each of the mlib_GraphicsDrawLineSet_B_*() functions  draws  a  set  of
215       lines with alpha blending as follows:
216
217             data[x,y] = (data[x,y] * (255 - a) + c * a) / 255
218
219
220
221       Each  of  the  mlib_GraphicsDrawLineSet_G_*()  functions draws a set of
222       lines with Gouraud shading.
223
224
225       Each of the mlib_GraphicsDrawLineSet_Z_*() functions  draws  a  set  of
226       lines with Z buffering.
227
228
229       Each  of the other functions draws a set of lines with a combination of
230       two or more features like antialiasing (A), alpha blending (B), Gouraud
231       shading (G), and Z buffering (Z).
232

PARAMETERS

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

RETURN VALUES

266       Each  of the functions returns MLIB_SUCCESS if successful. Otherwise it
267       returns MLIB_FAILURE.
268

ATTRIBUTES

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

NAME

SYNOPSIS

DESCRIPTION

PARAMETERS

RETURN VALUES

ATTRIBUTES

SEE ALSO