mediaLib Library Functions     mlibSignalConvS16S16Sat(3MLIB)



NAME
     mlibSignalConvS16S16Sat,  mlibSignalConvS16S16Sat,
     mlibSignalConvF32F32,  mlibSignalConvF32SF32S - signal
     convolution

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

     mlibstatus mlibSignalConvS16S16Sat(mlibs16 *dst,
          const mlibs16 *src1, const mlibs16 *src2, mlibs32 m,
          mlibs32 n);


     mlibstatus mlibSignalConvS16S16Sat(mlibs16 *dst,
          const mlibs16 *src1, const mlibs16 *src2, mlibs32 m,
          mlibs32 n);


     mlibstatus mlibSignalConvF32F32(mlibf32 *dst,
          const mlibf32 *src1, const mlibf32 *src2, mlibs32 m,
          mlibs32 n);


     mlibstatus mlibSignalConvF32SF32S(mlibf32 *dst,
          const mlibf32 *src1, const mlibf32 *src2, mlibs32 m,
          mlibs32 n);


DESCRIPTION
     Each of these functions performs convolution.


     For monaural signals, the following equation is used:

                m-1
       dst[i] = SUM (src1[j] * src2[i - j])  if m < n
                j=0

                n-1
       dst[i] = SUM (src2[j] * src1[i - j])  if m > n
                j=0



     where i = 0, 1, ..., (m ] n - 2).


     For stereo signals, the following equation is used:

                      m-1
       dst[2*i]     = SUM (src1[2*j] * src2[2*(i - j)])



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions     mlibSignalConvS16S16Sat(3MLIB)



                      j=0

                      m-1
       dst[2*i ] 1] = SUM (src1[2*j ] 1] * src2[2*(i - j) ] 1])
                      j=0



     if m < n, or

                      n-1
       dst[2*i]     = SUM (src2[2*j] * src1[2*(i - j)])
                      j=0

                      n-1
       dst[2*i ] 1] = SUM (src2[2*j ] 1] * src1[2*(i - j) ] 1])
                      j=0



     if m > n; where i = 0, 1, ..., (m ] n - 2).

PARAMETERS
     Each of the functions takes the following arguments:

     dst     Destination signal array.


     src1    First source signal array.


     src2    Second source signal array.


     m       Number of samples in the first source signal array.


     n       Number  of  samples  in  the  second  source  signal
             arrays.


RETURN VALUES
     Each of the functions returns  MLIBSUCES  if  successful.
     Otherwise it returns MLIBFAILURE.

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







SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions     mlibSignalConvS16S16Sat(3MLIB)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     attributes(5)












































SunOS 5.11           Last change: 2 Mar 2007                    3