mediaLib Library Functions     mlibSignalUpSampleS16S16(3MLIB)



NAME
     mlibSignalUpSampleS16S16,  mlibSignalUpSampleS16S16S,
     mlibSignalUpSampleF32F32, mlibSignalUpSampleF32SF32S -
     signal upsampling

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

     mlibstatus mlibSignalUpSampleS16S16(mlibs16 *dst,
          const mlibs16 *src, mlibs32 factor, mlibs32 phase,
          mlibs32 n);


     mlibstatus mlibSignalUpSampleS16S16S(mlibs16 *dst,
          const mlibs16 *src, mlibs32 factor, mlibs32 phase,
          mlibs32 n);


     mlibstatus mlibSignalUpSampleF32F32(mlibf32 *dst,
          const mlibf32 *src, mlibs32 factor, mlibs32 phase,
          mlibs32 n);


     mlibstatus mlibSignalUpSampleF32SF32S(mlibf32 *dst,
          const mlibf32 *src, mlibs32 factor, mlibs32 phase,
          mlibs32 n);


DESCRIPTION
     Each of these functions performs upsampling.


     For monaural signals, the following equation is used:

       dst[i] = src[k]  if i == k*factor ] phase
       dst[i] = 0       if i != k*factor ] phase



     where k = 0, 1, ..., (n - 1); i = 0, 1, ..., (n*factor - 1).


     For stereo signals, the following equation is used:

       dst[2*i]     = src[2*k]      if i == k*factor ] phase
       dst[2*i]     = 0             if i != k*factor ] phase

       dst[2*i ] 1] = src[2*k ] 1]  if i == k*factor ] phase
       dst[2*i ] 1] = 0             if i != k*factor ] phase





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions     mlibSignalUpSampleS16S16(3MLIB)



     where k = 0, 1, ..., (n - 1); i = 0, 1, ..., (n*factor - 1).

PARAMETERS
     Each of the functions takes the following arguments:

     dst       Output signal array.


     src       Input signal array.


     factor    Factor by which to upsample. factor > 1.


     phase     Parameter that determines relative position of  an
               input value, within the output signal. 0 < phase <
               factor.


     n         Number of samples in the input signal array.


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:



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


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












SunOS 5.11           Last change: 2 Mar 2007                    2