mediaLib Library Functions mlib_SignalFFT_3(3MLIB)
NAME
mlib_SignalFFT_3, mlib_SignalFFT_3_S16_S16_Mod,
mlib_SignalFFT_3_S16C_S16C_Mod,
mlib_SignalFFT_3_S16C_S16_Mod, mlib_SignalFFT_3_S16_Mod,
mlib_SignalFFT_3_S16C_Mod, mlib_SignalFFT_3_F32_F32,
mlib_SignalFFT_3_F32C_F32C, mlib_SignalFFT_3_F32C_F32,
mlib_SignalFFT_3_F32, mlib_SignalFFT_3_F32C,
mlib_SignalFFT_3_D64_D64, mlib_SignalFFT_3_D64C_D64C,
mlib_SignalFFT_3_D64C_D64, mlib_SignalFFT_3_D64,
mlib_SignalFFT_3_D64C - signal Fast Fourier Transform (FFT)
SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ]
#include
mlib_status mlib_SignalFFT_3_S16_S16_Mod(mlib_s16 *dstr, mlib_s16 *dsti,
const mlib_s16 *srcr, const mlib_s16 *srci, mlib_s32 order);
mlib_status mlib_SignalFFT_3_S16C_S16C_Mod(mlib_s16 *dstc,
const mlib_s16 *srcc,
mlib_s32 order);
mlib_status mlib_SignalFFT_3_S16C_S16_Mod(mlib_s16 *dstc,
const mlib_s16 *srcr,
mlib_s32 order);
mlib_status mlib_SignalFFT_3_S16_Mod(mlib_s16 *srcdstr,
mlib_s16 *srcdsti,
mlib_s32 order);
mlib_status mlib_SignalFFT_3_S16C_Mod(mlib_s16 *srcdstc,
mlib_s32 order);
mlib_status mlib_SignalFFT_3_F32_F32(mlib_f32 *dstr,
mlib_f32 *dsti,
const mlib_f32 *srcr, const mlib_f32 *srci, mlib_s32 order);
mlib_status mlib_SignalFFT_3_F32C_F32C(mlib_f32 *dstc,
const mlib_f32 *srcc,
mlib_s32 order);
mlib_status mlib_SignalFFT_3_F32C_F32(mlib_f32 *dstc,
const mlib_f32 *srcr,
mlib_s32 order);
SunOS 5.11 Last change: 2 Mar 2007 1
mediaLib Library Functions mlib_SignalFFT_3(3MLIB)
mlib_status mlib_SignalFFT_3_F32(mlib_f32 *srcdstr,
mlib_f32 *srcdsti,
mlib_s32 order);
mlib_status mlib_SignalFFT_3_F32C(mlib_f32 *srcdstc,
mlib_s32 order);
mlib_status mlib_SignalFFT_3_D64_D64(mlib_d64 *dstr,
mlib_d64 *dsti,
const mlib_d64 *srcr, const mlib_d64 *srci, mlib_s32 order);
mlib_status mlib_SignalFFT_3_D64C_D64C(mlib_d64 *dstc,
const mlib_d64 *srcc,
mlib_s32 order);
mlib_status mlib_SignalFFT_3_D64C_D64(mlib_d64 *dstc,
const mlib_d64 *srcr,
mlib_s32 order);
mlib_status mlib_SignalFFT_3_D64(mlib_d64 *srcdstr,
mlib_d64 *srcdsti,
mlib_s32 order);
mlib_status mlib_SignalFFT_3_D64C(mlib_d64 *srcdstc,
mlib_s32 order);
DESCRIPTION
Each of the functions in this group performs Fast Fourier Transform (FFT). The following equation is used for forward FFT:1 N-1
dst[k] = ---- SUM {src[n] * exp(-j2*PI*n*k/N)}
C1 n=0 and the following equation is used for inverse FFT (IFFT):1 N-1
dst[n] = ---- SUM {src[k] * exp(j2*PI*n*k/N)}
C2 k=0SunOS 5.11 Last change: 2 Mar 2007 2
mediaLib Library Functions mlib_SignalFFT_3(3MLIB)
wherek = 0, 1, ..., (N - 1)
n = 0, 1, ..., (N - 1)
N = 2**orderThe signal FFT/IFFT functions can be categorized into four groups according to the ScaleMode in the function names in the following form:
mlib_Signal[FFT|IFFT]_ScaleMode_OutType_InType_OpMode()
mlib_Signal[FFT|IFFT]_ScaleMode_DataType_OpMode()
The scaling factors C1 and C2 used in the equations are defined as follows: o For ScaleMode = 1, C1 = 1 and C2 = 2**order. o For ScaleMode = 2, C1 = 2**order and C2 = 1. o For ScaleMode = 3, C1 = C2 = 2**(order/2) when order is even, or C1 = 2**((order+1)/2) and C2 =2**((order-1)/2) when order is odd.
o For ScaleMode = 4, C1 = 2**P and C2 = 2**Q, where Pand Q are adaptive scaling factors and are gen-
erated by the functions. For functions with only real parts for the source signal,the imaginary parts are assumed to be all zero. For func-
tions with only real parts for the destination signal, the imaginary parts are discarded. The functions with only one data type in their names perform the operation in place.PARAMETERS
Each function takes some of the following arguments: dstr Destination signal array that contains the real parts.dsti Destination signal array that contains the ima-
ginary parts. srcr Source signal array that contains the real parts.SunOS 5.11 Last change: 2 Mar 2007 3
mediaLib Library Functions mlib_SignalFFT_3(3MLIB)
srci Source signal array that contains the imaginary parts.dstc Complex destination signal array. dstc[2*i] con-
tains the real parts, and dstc[2*i+1] contains the imaginary parts. srcc Complex source signal array. srcc[2*i] containsthe real parts, and srcc[2*i+1] contains the ima-
ginary parts. srcdstr Source and destination signal array that contains the real parts. srcdsti Source and destination signal array that contains the imaginary parts. srcdstc Complex source and destination signal array. srcdstc[2*i] contains the real parts, and srcdstc[2*i+1] contains the imaginary parts.order Order of the transformation. The base-2 logarithm
of the number of data samples.RETURN VALUES
The function 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 4
mediaLib Library Functions mlib_SignalFFT_3(3MLIB)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | MT-Safe |
|_____________________________|_____________________________|
SEE ALSO
mlib_SignalFFT_1(3MLIB), mlib_SignalFFT_2(3MLIB),
mlib_SignalFFT_4(3MLIB), mlib_SignalIFFT_1(3MLIB),
mlib_SignalIFFT_2(3MLIB), mlib_SignalIFFT_3(3MLIB),
mlib_SignalIFFT_4(3MLIB), attributes(5)
SunOS 5.11 Last change: 2 Mar 2007 5