mlib_VectorConvert_S8_U8_Sat(3mlib)

1mlib_VectorConvert_U8_S8_Momde(d3iMaLLIiBb)Library Fmulnicbt_iVoencstorConvert_U8_S8_Mod(3MLIB)
2
3
4

NAME

6       mlib_VectorConvert_U8_S8_Mod,  mlib_VectorConvert_U8_S16_Mod, mlib_Vec‐
7       torConvert_U8_S32_Mod,  mlib_VectorConvert_S8_U8_Mod,   mlib_VectorCon‐
8       vert_S8_S16_Mod,     mlib_VectorConvert_S8_S32_Mod,     mlib_VectorCon‐
9       vert_S16_U8_Mod,     mlib_VectorConvert_S16_S8_Mod,     mlib_VectorCon‐
10       vert_S16_S32_Mod,     mlib_VectorConvert_S32_U8_Mod,    mlib_VectorCon‐
11       vert_S32_S8_Mod,    mlib_VectorConvert_S32_S16_Mod,     mlib_VectorCon‐
12       vert_U8C_S8C_Mod,    mlib_VectorConvert_U8C_S16C_Mod,   mlib_VectorCon‐
13       vert_U8C_S32C_Mod,   mlib_VectorConvert_S8C_U8C_Mod,    mlib_VectorCon‐
14       vert_S8C_S16C_Mod,   mlib_VectorConvert_S8C_S32C_Mod,   mlib_VectorCon‐
15       vert_S16C_U8C_Mod,   mlib_VectorConvert_S16C_S8C_Mod,   mlib_VectorCon‐
16       vert_S16C_S32C_Mod,   mlib_VectorConvert_S32C_U8C_Mod,  mlib_VectorCon‐
17       vert_S32C_S8C_Mod,  mlib_VectorConvert_S32C_S16C_Mod,   mlib_VectorCon‐
18       vert_U8_S8_Sat,      mlib_VectorConvert_U8_S16_Sat,     mlib_VectorCon‐
19       vert_U8_S32_Sat,     mlib_VectorConvert_S8_U8_Sat,      mlib_VectorCon‐
20       vert_S8_S16_Sat,     mlib_VectorConvert_S8_S32_Sat,     mlib_VectorCon‐
21       vert_S16_U8_Sat,     mlib_VectorConvert_S16_S8_Sat,     mlib_VectorCon‐
22       vert_S16_S32_Sat,     mlib_VectorConvert_S32_U8_Sat,    mlib_VectorCon‐
23       vert_S32_S8_Sat,    mlib_VectorConvert_S32_S16_Sat,     mlib_VectorCon‐
24       vert_U8C_S8C_Sat,    mlib_VectorConvert_U8C_S16C_Sat,   mlib_VectorCon‐
25       vert_U8C_S32C_Sat,   mlib_VectorConvert_S8C_U8C_Sat,    mlib_VectorCon‐
26       vert_S8C_S16C_Sat,   mlib_VectorConvert_S8C_S32C_Sat,   mlib_VectorCon‐
27       vert_S16C_U8C_Sat,   mlib_VectorConvert_S16C_S8C_Sat,   mlib_VectorCon‐
28       vert_S16C_S32C_Sat,   mlib_VectorConvert_S32C_U8C_Sat,  mlib_VectorCon‐
29       vert_S32C_S8C_Sat, mlib_VectorConvert_S32C_S16C_Sat - vector data  type
30       convert
31

SYNOPSIS

33       cc [ flag... ] file... -lmlib [ library... ]
34       #include <mlib.h>
35
36       mlib_status mlib_VectorConvert_U8_S8_Mod(mlib_u8 *z, const mlib_s8 *x,
37            mlib_s32 n);
38
39
40       mlib_status mlib_VectorConvert_U8_S16_Mod(mlib_u8 *z, const mlib_s16 *x,
41            mlib_s32 n);
42
43
44       mlib_status mlib_VectorConvert_U8_S32_Mod(mlib_u8 *z, const mlib_s32 *x,
45            mlib_s32 n);
46
47
48       mlib_status mlib_VectorConvert_S8_U8_Mod(mlib_s8 *z, const mlib_u8 *x,
49            mlib_s32 n);
50
51
52       mlib_status mlib_VectorConvert_S8_S16_Mod(mlib_s8 *z, const mlib_s16 *x,
53            mlib_s32 n);
54
55
56       mlib_status mlib_VectorConvert_S8_S32_Mod(mlib_s8 *z, const mlib_s32 *x,
57            mlib_s32 n);
58
59
60       mlib_status mlib_VectorConvert_S16_U8_Mod(mlib_s16 *z, const mlib_u8 *x,
61            mlib_s32 n);
62
63
64       mlib_status mlib_VectorConvert_S16_S8_Mod(mlib_s16 *z, const mlib_s8 *x,
65            mlib_s32 n);
66
67
68       mlib_status mlib_VectorConvert_S16_S32_Mod(mlib_s16 *z, const mlib_s32 *x,
69            mlib_s32 n);
70
71
72       mlib_status mlib_VectorConvert_S32_U8_Mod(mlib_s32 *z, const mlib_u8 *x,
73            mlib_s32 n);
74
75
76       mlib_status mlib_VectorConvert_S32_S8_Mod(mlib_s32 *z, const mlib_s8 *x,
77            mlib_s32 n);
78
79
80       mlib_status mlib_VectorConvert_S32_S16_Mod(mlib_s32 *z, const mlib_s16 *x,
81            mlib_s32 n);
82
83
84       mlib_status mlib_VectorConvert_U8C_S8C_Mod(mlib_u8 *z, const mlib_s8 *x,
85            mlib_s32 n);
86
87
88       mlib_status mlib_VectorConvert_U8C_S16C_Mod(mlib_u8 *z, const mlib_s16 *x,
89            mlib_s32 n);
90
91
92       mlib_status mlib_VectorConvert_U8C_S32C_Mod(mlib_u8 *z, const mlib_s32 *x,
93            mlib_s32 n);
94
95
96       mlib_status mlib_VectorConvert_S8C_U8C_Mod(mlib_s8 *z, const mlib_u8 *x,
97            mlib_s32 n);
98
99
100       mlib_status mlib_VectorConvert_S8C_S16C_Mod(mlib_s8 *z, const mlib_s16 *x,
101            mlib_s32 n);
102
103
104       mlib_status mlib_VectorConvert_S8C_S32C_Mod(mlib_s8 *z, const mlib_s32 *x,
105            mlib_s32 n);
106
107
108       mlib_status mlib_VectorConvert_S16C_U8C_Mod(mlib_s16 *z, const mlib_u8 *x,
109            mlib_s32 n);
110
111
112       mlib_status mlib_VectorConvert_S16C_S8C_Mod(mlib_s16 *z, const mlib_s8 *x,
113            mlib_s32 n);
114
115
116       mlib_status mlib_VectorConvert_S16C_S32C_Mod(mlib_s16 *z, const mlib_s32 *x,
117            mlib_s32 n);
118
119
120       mlib_status mlib_VectorConvert_S32C_U8C_Mod(mlib_s32 *z, const mlib_u8 *x,
121            mlib_s32 n);
122
123
124       mlib_status mlib_VectorConvert_S32C_S8C_Mod(mlib_s32 *z, const mlib_s8 *x,
125            mlib_s32 n);
126
127
128       mlib_status mlib_VectorConvert_S32C_S16C_Mod(mlib_s32 *z, const mlib_s16 *x,
129            mlib_s32 n);
130
131
132       mlib_status mlib_VectorConvert_U8_S8_Sat(mlib_u8 *z, const mlib_s8 *x,
133            mlib_s32 n);
134
135
136       mlib_status mlib_VectorConvert_U8_S16_Sat(mlib_u8 *z, const mlib_s16 *x,
137            mlib_s32 n);
138
139
140       mlib_status mlib_VectorConvert_U8_S32_Sat(mlib_u8 *z, const mlib_s32 *x,
141            mlib_s32 n);
142
143
144       mlib_status mlib_VectorConvert_S8_U8_Sat(mlib_s8 *z, const mlib_u8 *x,
145            mlib_s32 n);
146
147
148       mlib_status mlib_VectorConvert_S8_S16_Sat(mlib_s8 *z, const mlib_s16 *x,
149            mlib_s32 n);
150
151
152       mlib_status mlib_VectorConvert_S8_S32_Sat(mlib_s8 *z, const mlib_s32 *x,
153            mlib_s32 n);
154
155
156       mlib_status mlib_VectorConvert_S16_U8_Sat(mlib_s16 *z, const mlib_u8 *x,
157            mlib_s32 n);
158
159
160       mlib_status mlib_VectorConvert_S16_S8_Sat(mlib_s16 *z, const mlib_s8 *x,
161            mlib_s32 n);
162
163
164       mlib_status mlib_VectorConvert_S16_S32_Sat(mlib_s16 *z, const mlib_s32 *x,
165            mlib_s32 n);
166
167
168       mlib_status mlib_VectorConvert_S32_U8_Sat(mlib_s32 *z, const mlib_u8 *x,
169            mlib_s32 n);
170
171
172       mlib_status mlib_VectorConvert_S32_S8_Sat(mlib_s32 *z, const mlib_s8 *x,
173            mlib_s32 n);
174
175
176       mlib_status mlib_VectorConvert_S32_S16_Sat(mlib_s32 *z, const mlib_s16 *x,
177            mlib_s32 n);
178
179
180       mlib_status mlib_VectorConvert_U8C_S8C_Sat(mlib_u8 *z, const mlib_s8 *x,
181            mlib_s32 n);
182
183
184       mlib_status mlib_VectorConvert_U8C_S16C_Sat(mlib_u8 *z, const mlib_s16 *x,
185            mlib_s32 n);
186
187
188       mlib_status mlib_VectorConvert_U8C_S32C_Sat(mlib_u8 *z, const mlib_s32 *x,
189            mlib_s32 n);
190
191
192       mlib_status mlib_VectorConvert_S8C_U8C_Sat(mlib_s8 *z, const mlib_u8 *x,
193            mlib_s32 n);
194
195
196       mlib_status mlib_VectorConvert_S8C_S16C_Sat(mlib_s8 *z, const mlib_s16 *x,
197            mlib_s32 n);
198
199
200       mlib_status mlib_VectorConvert_S8C_S32C_Sat(mlib_s8 *z, const mlib_s32 *x,
201            mlib_s32 n);
202
203
204       mlib_status mlib_VectorConvert_S16C_U8C_Sat(mlib_s16 *z, const mlib_u8 *x,
205            mlib_s32 n);
206
207
208       mlib_status mlib_VectorConvert_S16C_S8C_Sat(mlib_s16 *z, const mlib_s8 *x,
209            mlib_s32 n);
210
211
212       mlib_status mlib_VectorConvert_S16C_S32C_Sat(mlib_s16 *z, const mlib_s32 *x,
213            mlib_s32 n);
214
215
216       mlib_status mlib_VectorConvert_S32C_U8C_Sat(mlib_s32 *z, const mlib_u8 *x,
217            mlib_s32 n);
218
219
220       mlib_status mlib_VectorConvert_S32C_S8C_Sat(mlib_s32 *z, const mlib_s8 *x,
221            mlib_s32 n);
222
223
224       mlib_status mlib_VectorConvert_S32C_S16C_Sat(mlib_s32 *z, const mlib_s16 *x,
225            mlib_s32 n);
226
227

DESCRIPTION

229       Each  of these functions copies data from one vector to another vector,
230       of different data types.
231
232
233       For real data, the following equation is used:
234
235         z[i] = x[i]
236
237
238
239       where i = 0, 1, ..., (n - 1).
240
241
242       For complex data, the following equation is used:
243
244         z[2*i]     = x[2*i]
245         z[2*i + 1] = x[2*i + 1]
246
247
248
249       where i = 0, 1, ..., (n - 1).
250
251
252       See the following tables for available variations of the data type con‐
253       vert function.
254
255
256
257
258        Type [*]         U8            S8            S16           S32
259       ────────────────────────────────────────────────────────────────────
260       U8                          Y             Y             Y
261       S8            Y                           Y             Y
262       ────────────────────────────────────────────────────────────────────
263
264
265       S16           Y             Y                           Y
266       ────────────────────────────────────────────────────────────────────
267       S32           Y             Y             Y
268
269
270
271
272
273        Type [*]         U8C           S8C          S16C          S32C
274       ────────────────────────────────────────────────────────────────────
275       U8C                         Y             Y             Y
276       ────────────────────────────────────────────────────────────────────
277       S8C           Y                           Y             Y
278       ────────────────────────────────────────────────────────────────────
279       S16C          Y             Y                           Y
280       ────────────────────────────────────────────────────────────────────
281       S32C          Y             Y             Y
282
283
284
285       [*]  Each  row  represents a source data type. Each column represents a
286       destination data type.
287

PARAMETERS

289       Each of the functions takes the following arguments:
290
291       z    Pointer to the first element of the destination vector.
292
293
294       x    Pointer to the first element of the source vector.
295
296
297       n    Number of elements in the vectors.
298
299

RETURN VALUES

301       Each of the functions returns MLIB_SUCCESS if successful. Otherwise  it
302       returns MLIB_FAILURE.
303

ATTRIBUTES

305       See attributes(5) for descriptions of the following attributes:
306
307
308
309
310       ┌─────────────────────────────┬─────────────────────────────┐
311       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
312       ├─────────────────────────────┼─────────────────────────────┤
313       │Interface Stability          │Committed                    │
314       ├─────────────────────────────┼─────────────────────────────┤
315       │MT-Level                     │MT-Safe                      │
316       └─────────────────────────────┴─────────────────────────────┘
317

NAME

SYNOPSIS

DESCRIPTION

PARAMETERS

RETURN VALUES

ATTRIBUTES

SEE ALSO