mlib_GraphicsDrawTriangleStripSet_AB_32(3mlib)

1mlib_GraphicsDrawTriangleStmreidpiSaeLti(b3MLLiIbBrm)alriyb_FGurnacpthiiocnssDrawTriangleStripSet(3MLIB)
2
3
4

NAME

6       mlib_GraphicsDrawTriangleStripSet, mlib_GraphicsDrawTriangleStripSet_8,
7       mlib_GraphicsDrawTriangleStripSet_32,           mlib_GraphicsDrawTrian‐
8       gleStripSet_X_8, mlib_GraphicsDrawTriangleStripSet_X_32, mlib_Graphics‐
9       DrawTriangleStripSet_A_8,       mlib_GraphicsDrawTriangleStripSet_A_32,
10       mlib_GraphicsDrawTriangleStripSet_B_8,          mlib_GraphicsDrawTrian‐
11       gleStripSet_B_32, mlib_GraphicsDrawTriangleStripSet_G_8, mlib_Graphics‐
12       DrawTriangleStripSet_G_32,       mlib_GraphicsDrawTriangleStripSet_Z_8,
13       mlib_GraphicsDrawTriangleStripSet_Z_32,         mlib_GraphicsDrawTrian‐
14       gleStripSet_AB_8,  mlib_GraphicsDrawTriangleStripSet_AB_32, mlib_Graph‐
15       icsDrawTriangleStripSet_ABG_8,                  mlib_GraphicsDrawTrian‐
16       gleStripSet_ABG_32,           mlib_GraphicsDrawTriangleStripSet_ABGZ_8,
17       mlib_GraphicsDrawTriangleStripSet_ABGZ_32,      mlib_GraphicsDrawTrian‐
18       gleStripSet_ABZ_8,            mlib_GraphicsDrawTriangleStripSet_ABZ_32,
19       mlib_GraphicsDrawTriangleStripSet_AG_8,         mlib_GraphicsDrawTrian‐
20       gleStripSet_AG_32, mlib_GraphicsDrawTriangleStripSet_AGZ_8, mlib_Graph‐
21       icsDrawTriangleStripSet_AGZ_32, mlib_GraphicsDrawTriangleStripSet_AZ_8,
22       mlib_GraphicsDrawTriangleStripSet_AZ_32,        mlib_GraphicsDrawTrian‐
23       gleStripSet_BG_8, mlib_GraphicsDrawTriangleStripSet_BG_32,  mlib_Graph‐
24       icsDrawTriangleStripSet_BGZ_8,                  mlib_GraphicsDrawTrian‐
25       gleStripSet_BGZ_32, mlib_GraphicsDrawTriangleStripSet_BZ_8, mlib_Graph‐
26       icsDrawTriangleStripSet_BZ_32,  mlib_GraphicsDrawTriangleStripSet_GZ_8,
27       mlib_GraphicsDrawTriangleStripSet_GZ_32 - draw triangle set  where  the
28       first  side of each member is common to the second side of the previous
29       member
30

SYNOPSIS

32       cc [ flag... ] file... -lmlib [ library... ]
33       #include <mlib.h>
34
35       mlib_status mlib_GraphicsDrawTriangleStripSet_8(mlib_image *buffer,
36            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
37
38
39       mlib_status mlib_GraphicsDrawTriangleStripSet_32(mlib_image *buffer,
40            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
41
42
43       mlib_status mlib_GraphicsDrawTriangleStripSet_X_8(mlib_image *buffer,
44            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
45            mlib_s32 c2);
46
47
48       mlib_status mlib_GraphicsDrawTriangleStripSet_X_32(mlib_image *buffer,
49            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
50            mlib_s32 c2);
51
52
53       mlib_status mlib_GraphicsDrawTriangleStripSet_A_8(mlib_image *buffer,
54            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
55
56
57       mlib_status mlib_GraphicsDrawTriangleStripSet_A_32(mlib_image *buffer,
58            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c);
59
60
61       mlib_status mlib_GraphicsDrawTriangleStripSet_B_8(mlib_image *buffer,
62            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
63            mlib_s32 a);
64
65
66       mlib_status mlib_GraphicsDrawTriangleStripSet_B_32(mlib_image *buffer,
67            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
68            mlib_s32 a);
69
70
71       mlib_status mlib_GraphicsDrawTriangleStripSet_G_8(mlib_image *buffer,
72            const mlib_s16 *x, const mlib_s16 *y,
73            mlib_s32 npoints, const mlib_s32 *c);
74
75
76       mlib_status mlib_GraphicsDrawTriangleStripSet_G_32(mlib_image *buffer,
77            const mlib_s16 *x, const mlib_s16 *y,
78            mlib_s32 npoints, const mlib_s32 *c);
79
80
81       mlib_status mlib_GraphicsDrawTriangleStripSet_Z_8(mlib_image *buffer,
82            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
83            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
84
85
86       mlib_status mlib_GraphicsDrawTriangleStripSet_Z_32(mlib_image *buffer,
87            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
88            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
89
90
91       mlib_status mlib_GraphicsDrawTriangleStripSet_AB_8(mlib_image *buffer,
92            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
93            mlib_s32 a);
94
95
96       mlib_status mlib_GraphicsDrawTriangleStripSet_AB_32(mlib_image *buffer,
97            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints, mlib_s32 c,
98            mlib_s32 a);
99
100
101       mlib_status mlib_GraphicsDrawTriangleStripSet_ABG_8(mlib_image *buffer,
102            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
103            const mlib_s32 *c, mlib_s32 a);
104
105
106       mlib_status mlib_GraphicsDrawTriangleStripSet_ABG_32(mlib_image *buffer,
107            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
108            const mlib_s32 *c, mlib_s32 a);
109
110
111       mlib_status mlib_GraphicsDrawTriangleStripSet_ABGZ_8(mlib_image *buffer,
112            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
113            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
114
115
116       mlib_status mlib_GraphicsDrawTriangleStripSet_ABGZ_32(mlib_image *buffer,
117            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
118            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
119
120
121       mlib_status mlib_GraphicsDrawTriangleStripSet_ABZ_8(mlib_image *buffer,
122            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
123            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
124
125
126       mlib_status mlib_GraphicsDrawTriangleStripSet_ABZ_32(mlib_image *buffer,
127            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
128            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
129
130
131       mlib_status mlib_GraphicsDrawTriangleStripSet_AG_8(mlib_image *buffer,
132            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
133            const mlib_s32 *c);
134
135
136       mlib_status mlib_GraphicsDrawTriangleStripSet_AG_32(mlib_image *buffer,
137            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
138            const mlib_s32 *c);
139
140
141       mlib_status mlib_GraphicsDrawTriangleStripSet_AGZ_8(mlib_image *buffer,
142            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
143            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
144
145
146       mlib_status mlib_GraphicsDrawTriangleStripSet_AGZ_32(mlib_image *buffer,
147            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
148            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
149
150
151       mlib_status mlib_GraphicsDrawTriangleStripSet_AZ_8(mlib_image *buffer,
152            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
153            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
154
155
156       mlib_status mlib_GraphicsDrawTriangleStripSet_AZ_32(mlib_image *buffer,
157            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
158            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c);
159
160
161       mlib_status mlib_GraphicsDrawTriangleStripSet_BG_8(mlib_image *buffer,
162            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
163            const mlib_s32 *c, mlib_s32 a);
164
165
166       mlib_status mlib_GraphicsDrawTriangleStripSet_BG_32(mlib_image *buffer,
167            const mlib_s16 *x, const mlib_s16 *y, mlib_s32 npoints,
168            const mlib_s32 *c, mlib_s32 a);
169
170
171       mlib_status mlib_GraphicsDrawTriangleStripSet_BGZ_8(mlib_image *buffer,
172            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
173            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
174
175
176       mlib_status mlib_GraphicsDrawTriangleStripSet_BGZ_32(mlib_image *buffer,
177            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
178            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c, mlib_s32 a);
179
180
181       mlib_status mlib_GraphicsDrawTriangleStripSet_BZ_8(mlib_image *buffer,
182            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
183            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
184
185
186       mlib_status mlib_GraphicsDrawTriangleStripSet_BZ_32(mlib_image *buffer,
187            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
188            const mlib_s16 *z, mlib_s32 npoints, mlib_s32 c, mlib_s32 a);
189
190
191       mlib_status mlib_GraphicsDrawTriangleStripSet_GZ_8(mlib_image *buffer,
192            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
193            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
194
195
196       mlib_status mlib_GraphicsDrawTriangleStripSet_GZ_32(mlib_image *buffer,
197            mlib_image *zbuffer, const mlib_s16 *x, const mlib_s16 *y,
198            const mlib_s16 *z, mlib_s32 npoints, const mlib_s32 *c);
199
200

DESCRIPTION

202       Each of the mlib_GraphicsDrawTriangleStripSet_*() functions draws a set
203       of  triangles  with  vertices at {(x1,y1), (x2,y2), (x3,y3)}, {(x2,y2),
204       (x3,y3), (x4,y4)}, ..., and {(xn-2,yn-2), (xn-1,yn-1), (xn,yn)}.
205
206
207       Each of the mlib_GraphicsDrawTriangleStripSet_X_*() functions  draws  a
208       set of triangles in Xor mode as follows:
209
210             data[x,y] ^= c ^ c2
211
212
213
214       Each  of  the mlib_GraphicsDrawTriangleStripSet_A_*() functions draws a
215       set of triangles with antialiasing.
216
217
218       Each of the mlib_GraphicsDrawTriangleStripSet_B_*() functions  draws  a
219       set of triangles with alpha blending as follows:
220
221             data[x,y] = (data[x,y] * (255 - a) + c * a) / 255
222
223
224
225       Each  of  the mlib_GraphicsDrawTriangleStripSet_G_*() functions draws a
226       set of triangles with Gouraud shading.
227
228
229       Each of the mlib_GraphicsDrawTriangleStripSet_Z_*() functions  draws  a
230       set of triangles with Z buffering.
231
232
233       Each of the other functions draws a set of triangles with a combination
234       of two or more features like  antialiasing  (A),  alpha  blending  (B),
235       Gouraud shading (G), and Z buffering (Z).
236

PARAMETERS

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

RETURN VALUES

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

ATTRIBUTES

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

NAME

SYNOPSIS

DESCRIPTION

PARAMETERS

RETURN VALUES

ATTRIBUTES

SEE ALSO