mlib_MatrixScale_S32_S16_Sat(3mlib)

1mlib_MatrixScale_U8_U8_Mod(m3eMdLiIaBL)ib Library Funmcltiibo_nMsatrixScale_U8_U8_Mod(3MLIB)
2
3
4

NAME

6       mlib_MatrixScale_U8_U8_Mod,  mlib_MatrixScale_U8_U8_Sat,  mlib_MatrixS‐
7       cale_U8C_U8C_Mod,      mlib_MatrixScale_U8C_U8C_Sat,      mlib_MatrixS‐
8       cale_S8_S8_Mod,        mlib_MatrixScale_S8_S8_Sat,        mlib_MatrixS‐
9       cale_S8C_S8C_Mod,      mlib_MatrixScale_S8C_S8C_Sat,      mlib_MatrixS‐
10       cale_S16_U8_Mod,       mlib_MatrixScale_S16_U8_Sat,       mlib_MatrixS‐
11       cale_S16_S8_Mod,       mlib_MatrixScale_S16_S8_Sat,       mlib_MatrixS‐
12       cale_S16_S16_Mod,      mlib_MatrixScale_S16_S16_Sat,      mlib_MatrixS‐
13       cale_S16C_U8C_Mod,     mlib_MatrixScale_S16C_U8C_Sat,     mlib_MatrixS‐
14       cale_S16C_S8C_Mod,     mlib_MatrixScale_S16C_S8C_Sat,     mlib_MatrixS‐
15       cale_S16C_S16C_Mod,    mlib_MatrixScale_S16C_S16C_Sat,    mlib_MatrixS‐
16       cale_S32_S16_Mod,      mlib_MatrixScale_S32_S16_Sat,      mlib_MatrixS‐
17       cale_S32_S32_Mod,      mlib_MatrixScale_S32_S32_Sat,      mlib_MatrixS‐
18       cale_S32C_S16C_Mod,    mlib_MatrixScale_S32C_S16C_Sat,    mlib_MatrixS‐
19       cale_S32C_S32C_Mod,  mlib_MatrixScale_S32C_S32C_Sat  -  matrix   linear
20       scaling
21

SYNOPSIS

23       cc [ flag... ] file... -lmlib [ library... ]
24       #include <mlib.h>
25
26       mlib_status mlib_MatrixScale_U8_U8_Mod(mlib_u8 *z,
27            const mlib_u8 *x, const mlib_u8 *a, const mlib_u8 *b,
28            mlib_s32 m, mlib_s32 n);
29
30
31       mlib_status mlib_MatrixScale_U8_U8_Sat(mlib_u8 *z,
32            const mlib_u8 *x, const mlib_u8 *a, const mlib_u8 *b,
33            mlib_s32 m, mlib_s32 n);
34
35
36       mlib_status mlib_MatrixScale_U8C_U8C_Mod(mlib_u8 *z,
37            const mlib_u8 *x, const mlib_u8 *a, const mlib_u8 *b,
38            mlib_s32 m, mlib_s32 n);
39
40
41       mlib_status mlib_MatrixScale_U8C_U8C_Sat(mlib_u8 *z,
42            const mlib_u8 *x, const mlib_u8 *a, const mlib_u8 *b,
43            mlib_s32 m, mlib_s32 n);
44
45
46       mlib_status mlib_MatrixScale_S8_S8_Mod(mlib_s8 *z,
47            const mlib_s8 *x, const mlib_s8 *a, const mlib_s8 *b,
48            mlib_s32 m, mlib_s32 n);
49
50
51       mlib_status mlib_MatrixScale_S8_S8_Sat(mlib_s8 *z,
52            const mlib_s8 *x, const mlib_s8 *a, const mlib_s8 *b,
53            mlib_s32 m, mlib_s32 n);
54
55
56       mlib_status mlib_MatrixScale_S8C_S8C_Mod(mlib_s8 *z,
57            const mlib_s8 *x, const mlib_s8 *a, const mlib_s8 *b,
58            mlib_s32 m, mlib_s32 n);
59
60
61       mlib_status mlib_MatrixScale_S8C_S8C_Sat(mlib_s8 *z,
62            const mlib_s8 *x, const mlib_s8 *a, const mlib_s8 *b,
63            mlib_s32 m, mlib_s32 n);
64
65
66       mlib_status mlib_MatrixScale_S16_U8_Mod(mlib_s16 *z,
67            const mlib_u8 *x, const mlib_u8 *a, const mlib_u8 *b,
68            mlib_s32 m, mlib_s32 n);
69
70
71       mlib_status mlib_MatrixScale_S16_U8_Sat(mlib_s16 *z,
72            const mlib_u8 *x, const mlib_u8 *a, const mlib_u8 *b,
73            mlib_s32 m, mlib_s32 n);
74
75
76       mlib_status mlib_MatrixScale_S16_S8_Mod(mlib_s16 *z,
77            const mlib_s8 *x, const mlib_s8 *a, const mlib_s8 *b,
78            mlib_s32 m, mlib_s32 n);
79
80
81       mlib_status mlib_MatrixScale_S16_S8_Sat(mlib_s16 *z,
82            const mlib_s8 *x, const mlib_s8 *a, const mlib_s8 *b,
83            mlib_s32 m, mlib_s32 n);
84
85
86       mlib_status mlib_MatrixScale_S16_S16_Mod(mlib_s16 *z,
87            const mlib_s16 *x, const mlib_s16 *a, const mlib_s16 *b,
88            mlib_s32 m, mlib_s32 n);
89
90
91       mlib_status mlib_MatrixScale_S16_S16_Sat(mlib_s16 *z,
92            const mlib_s16 *x, const mlib_s16 *a, const mlib_s16 *b,
93            mlib_s32 m, mlib_s32 n);
94
95
96       mlib_status mlib_MatrixScale_S16C_U8C_Mod(mlib_s16 *z,
97            const mlib_u8 *x, const mlib_u8 *a, const mlib_u8 *b,
98            mlib_s32 m, mlib_s32 n);
99
100
101       mlib_status mlib_MatrixScale_S16C_U8C_Sat(mlib_s16 *z,
102            const mlib_u8 *x, const mlib_u8 *a, const mlib_u8 *b,
103            mlib_s32 m, mlib_s32 n);
104
105
106       mlib_status mlib_MatrixScale_S16C_S8C_Mod(mlib_s16 *z,
107            const mlib_s8 *x, const mlib_s8 *a, const mlib_s8 *b,
108            mlib_s32 m, mlib_s32 n);
109
110
111       mlib_status mlib_MatrixScale_S16C_S8C_Sat(mlib_s16 *z,
112            const mlib_s8 *x, const mlib_s8 *a, const mlib_s8 *b,
113            mlib_s32 m, mlib_s32 n);
114
115
116       mlib_status mlib_MatrixScale_S16C_S16C_Mod(mlib_s16 *z,
117            const mlib_s16 *x, const mlib_s16 *a, const mlib_s16 *b,
118            mlib_s32 m, mlib_s32 n);
119
120
121       mlib_status mlib_MatrixScale_S16C_S16C_Sat(mlib_s16 *z,
122            const mlib_s16 *x, const mlib_s16 *a, const mlib_s16 *b,
123            mlib_s32 m, mlib_s32 n);
124
125
126       mlib_status mlib_MatrixScale_S32_S16_Mod(mlib_s32 *z,
127            const mlib_s16 *x, const mlib_s16 *a, const mlib_s16 *b,
128            mlib_s32 m, mlib_s32 n);
129
130
131       mlib_status mlib_MatrixScale_S32_S16_Sat(mlib_s32 *z,
132            const mlib_s16 *x, const mlib_s16 *a, const mlib_s16 *b,
133            mlib_s32 m, mlib_s32 n);
134
135
136       mlib_status mlib_MatrixScale_S32_S32_Mod(mlib_s32 *z,
137            const mlib_s32 *x, const mlib_s32 *a, const mlib_s32 *b,
138            mlib_s32 m, mlib_s32 n);
139
140
141       mlib_status mlib_MatrixScale_S32_S32_Sat(mlib_s32 *z,
142            const mlib_s32 *x, const mlib_s32 *a, const mlib_s32 *b,
143            mlib_s32 m, mlib_s32 n);
144
145
146       mlib_status mlib_MatrixScale_S32C_S16C_Mod(mlib_s32 *z,
147            const mlib_s16 *x, const mlib_s16 *a, const mlib_s16 *b,
148            mlib_s32 m, mlib_s32 n);
149
150
151       mlib_status mlib_MatrixScale_S32C_S16C_Sat(mlib_s32 *z,
152            const mlib_s16 *x, const mlib_s16 *a, const mlib_s16 *b,
153            mlib_s32 m, mlib_s32 n);
154
155
156       mlib_status mlib_MatrixScale_S32C_S32C_Mod(mlib_s32 *z,
157            const mlib_s32 *x, const mlib_s32 *a, const mlib_s32 *b,
158            mlib_s32 m, mlib_s32 n);
159
160
161       mlib_status mlib_MatrixScale_S32C_S32C_Sat(mlib_s32 *z,
162            const mlib_s32 *x, const mlib_s32 *a, const mlib_s32 *b,
163            mlib_s32 m, mlib_s32 n);
164
165

DESCRIPTION

167       Each  of  these functions multiplies a matrix by a scalar and then adds
168       an offset.
169
170
171       For real data, the following equation is used:
172
173         z[i] = a[0]*x[i] + b[0]
174
175
176
177       where i = 0, 1, ..., (m*n - 1).
178
179
180       For complex data, the following equation is used:
181
182         z[2*i]     = a[0]*x[2*i] - a[1]*x[2*i + 1] + b[0]
183         z[2*i + 1] = a[1]*x[2*i] + a[0]*x[2*i + 1] + b[1]
184
185
186
187       where i = 0, 1, ..., (m*n - 1).
188

PARAMETERS

190       Each of the functions takes the following arguments:
191
192       z    Pointer to the destination matrix.
193
194
195       x    Pointer to the source matrix.
196
197
198       a    Pointer to the source scaling factor. When the  function  is  used
199            with  complex  data  types,  a[0] contains the scalar for the real
200            part, and a[1] contains the scalar for the imaginary part.
201
202
203       b    Pointer to the source offset. When the function is used with  com‐
204            plex  data  types, b[0] contains the offset for the real part, and
205            b[1] contains the offset for the imaginary part.
206
207
208       m    Number of rows in each matrix.
209
210
211       n    Number of columns in each matrix.
212
213

RETURN VALUES

215       Each of the functions returns MLIB_SUCCESS if successful. Otherwise  it
216       returns MLIB_FAILURE.
217

ATTRIBUTES

219       See attributes(5) for descriptions of the following attributes:
220
221
222
223
224       ┌─────────────────────────────┬─────────────────────────────┐
225       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
226       ├─────────────────────────────┼─────────────────────────────┤
227       │Interface Stability          │Committed                    │
228       ├─────────────────────────────┼─────────────────────────────┤
229       │MT-Level                     │MT-Safe                      │
230       └─────────────────────────────┴─────────────────────────────┘
231

NAME

SYNOPSIS

DESCRIPTION

PARAMETERS

RETURN VALUES

ATTRIBUTES

SEE ALSO