Manual Pages for UNIX Operating System command usage for man mlib_VectorMulMShift_S16C_S16C_Mod

mediaLib Library Functions
                          mlib_VectorMulMShift_S16_S16_Mod(3MLIB)



NAME
     mlib_VectorMulMShift_S16_S16_Mod,
     mlib_VectorMulMShift_S16_S16_Sat,
     mlib_VectorMulMShift_S16C_S16C_Mod,
     mlib_VectorMulMShift_S16C_S16C_Sat  - multiplication of vec-
     tor by matrix with shifting

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     mlib_status mlib_VectorMulMShift_S16_S16_Mod(mlib_s16 *z,
          const mlib_s16 *x, const mlib_s16 *y, mlib_s32 m,
          mlib_s32 n, mlib_s32 shift);


     mlib_status mlib_VectorMulMShift_S16_S16_Sat(mlib_s16 *z,
          const mlib_s16 *x, const mlib_s16 *y, mlib_s32 m,
          mlib_s32 n, mlib_s32 shift);


     mlib_status mlib_VectorMulMShift_S16C_S16C_Mod(mlib_s16 *z,
          const mlib_s16 *x, const mlib_s16 *y, mlib_s32 m,
          mlib_s32 n, mlib_s32 shift);


     mlib_status mlib_VectorMulMShift_S16C_S16C_Sat(mlib_s16 *z,
          const mlib_s16 *x, const mlib_s16 *y, mlib_s32 m,
          mlib_s32 n, mlib_s32 shift);


DESCRIPTION
     Each of these functions multiplies a vector by a matrix  and
     shifts the results.


     For real data, the following equation is used:

                m-1
       z[i] = { SUM (x[j] * y[j*m + i]) } * 2**(-shift)
                j=0



     where i = 0, 1, ..., (n - 1).


     For complex data, the following equation is used:

                      m-1
       z[2*i ]    = { SUM (xR*yR - xI*yI) } * 2**(-shift)



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions
                          mlib_VectorMulMShift_S16_S16_Mod(3MLIB)



                      j=0

                      m-1
       z[2*i + 1] = { SUM (xR*yI + xI*yR) } * 2**(-shift)
                      j=0



     where i = 0, 1, ..., (n - 1), and

       xR = x[2*j]
       xI = x[2*j + 1]
       yR = y[2*(j*m + i)]
       yI = y[2*(j*m + i) + 1]


PARAMETERS
     Each of the functions takes the following arguments:

     z        Pointer to the first  element  of  the  destination
              vector.


     x        Pointer to the first element of the source vector.


     y        Pointer to the first element of the source matrix.


     m        Number of rows in the matrix, and  number  of  ele-
              ments in the source vector.


     n        Number of columns in the matrix, and number of ele-
              ments in the destination vector.


     shift    Right shifting factor.


RETURN VALUES
     Each of the functions returns  MLIB_SUCCESS  if  successful.
     Otherwise it returns MLIB_FAILURE.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:







SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions
                          mlib_VectorMulMShift_S16_S16_Mod(3MLIB)



______________________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     mlib_VectorMulM_U8_U8_Mod(3MLIB), attributes(5)











































SunOS 5.11           Last change: 2 Mar 2007                    3






mediaLib Library Functions
                          mlib_VectorMulMShift_S16_S16_Mod(3MLIB)






















































SunOS 5.11           Last change: 2 Mar 2007                    4