mediaLib Library Functions                mlibSignalLimit(3MLIB)



NAME
     mlibSignalLimit,                  mlibSignalLimitS16S16,
     mlibSignalLimitS16S16S,            mlibSignalLimitS16,
     mlibSignalLimitS16S,             mlibSignalLimitF32F32,
     mlibSignalLimitF32SF32S,            mlibSignalLimitF32,
     mlibSignalLimitF32S - signal hard limiting

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

     mlibstatus mlibSignalLimitS16S16(mlibs16 *dst,
          const mlibs16 *src, const mlibs16 *low,
          const mlibs16 *high, mlibs32 n);


     mlibstatus mlibSignalLimitS16S16S(mlibs16 *dst,
          const mlibs16 *src, const mlibs16 *low,
          const mlibs16 *high, mlibs32 n);


     mlibstatus mlibSignalLimitS16(mlibs16 *srcdst,
          const mlibs16 *low, const mlibs16 *high, mlibs32 n);


     mlibstatus mlibSignalLimitS16S(mlibs16 *srcdst,
          const mlibs16 *low, const mlibs16 *high, mlibs32 n);


     mlibstatus mlibSignalLimitF32F32(mlibf32 *dst,
          const mlibf32 *src, const mlibf32 *low,
          const mlibf32 *high, mlibs32 n);


     mlibstatus mlibSignalLimitF32SF32S(mlibf32 *dst,
          const mlibf32 *src, const mlibf32 *low,
          const mlibf32 *high, mlibs32 n);


     mlibstatus mlibSignalLimitF32(mlibf32 *srcdst,
          const mlibf32 *low, const mlibf32 *high, mlibs32 n);


     mlibstatus mlibSignalLimitF32S(mlibf32 *srcdst,
          const mlibf32 *low, const mlibf32 *high, mlibs32 n);


DESCRIPTION
     Each of these functions performs hard limiting.






SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions                mlibSignalLimit(3MLIB)



     For monaural signals, the following equation is used:

       dst[i] = low[0]           if src[i] < low[0]
       dst[i] = src[i]           if low[0] < src[i] < high[0]
       dst[i] = high[0]          if src[i] > high[0]



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


     For stereo signals, the following equation is used:

       dst[2*i] = low[0]         if src[2*i] < low[0]
       dst[2*i] = src[2*i]       if low[0] < src[2*i] < high[0]
       dst[2*i] = high[0]        if src[2*i] > high[0]

       dst[2*i]1] = low[1]       if src[2*i]1] < low[1]
       dst[2*i]1] = src[2*i]1]   if low[1] < src[2*i]1] < high[1]
       dst[2*i]1] = high[1]      if src[2*i]1] > high[1]



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

PARAMETERS
     Each of the functions takes some of the following arguments:

     dst       Destination signal array.


     src       Source signal array.


     srcdst    Source and destination signal array.


     low       Lower input limit. In the stereo  version,  low[0]
               contains the lower limit for channel 0, and low[1]
               contains the lower limit for channel 1.


     high      Upper input limit. In the stereo version.  high[0]
               contains  the  upper  limit  for  channel  0,  and
               high[1] contains the upper limit for channel 1.


     n         Number of samples in the source signal array.


RETURN VALUES




SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions                mlibSignalLimit(3MLIB)



     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
     attributes(5)



































SunOS 5.11           Last change: 2 Mar 2007                    3