steve
/
winamp
mirror of https://github.com/WinampDesktop/winamp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
winamp/Src/external_dependencies/intel_ipp_6.1.1.035/em64t/include/ippac.h

6059 lines
289 KiB
C
Raw Permalink Normal View History

Initial community commit
2024-09-24 12:54:57 +00:00
/*
//
// INTEL CORPORATION PROPRIETARY INFORMATION
// This software is supplied under the terms of a license agreement or
// nondisclosure agreement with Intel Corporation and may not be copied
// or disclosed except in accordance with the terms of that agreement.
// Copyright (c) 2001-2009 Intel Corporation. All Rights Reserved.
//
// Intel(R) Integrated Performance Primitives
// Audio Coding (ippAC)
//
*/
#if !defined(__IPPAC_H__) || defined(_OWN_BLDPCS)
#define __IPPAC_H__
#if defined (_WIN32_WCE) && defined (_M_IX86) && defined (__stdcall)
#define _IPP_STDCALL_CDECL
#undef __stdcall
#endif
#include "ippdefs.h"
#ifdef __cplusplus
extern "C" {
#endif
/*
// Data Structures and Macro
*/
#if !defined(_OWN_BLDPCS)
/*
// FDP
*/
struct FDPState_32f;
typedef struct FDPState_32f IppsFDPState_32f;
/*
// FIR Block
*/
struct FIRBlockState_32f;
typedef struct FIRBlockState_32f IppsFIRBlockState_32f;
/*
// MDCT
*/
struct MDCTFwdSpec_32f;
typedef struct MDCTFwdSpec_32f IppsMDCTFwdSpec_32f;
struct MDCTInvSpec_32f;
typedef struct MDCTInvSpec_32f IppsMDCTInvSpec_32f;
struct MDCTFwdSpec_16s;
typedef struct MDCTFwdSpec_16s IppsMDCTFwdSpec_16s;
/*
// Filter_SBR
*/
struct IppsFilterContext_SBR_32f;
typedef struct IppsFilterContext_SBR_32f IppsFilterSpec_SBR_C_32fc;
typedef struct IppsFilterContext_SBR_32f IppsFilterSpec_SBR_C_32f;
typedef struct IppsFilterContext_SBR_32f IppsFilterSpec_SBR_R_32f;
struct IppsFilterContext_SBR_32s;
typedef struct IppsFilterContext_SBR_32s IppsFilterSpec_SBR_C_32sc;
typedef struct IppsFilterContext_SBR_32s IppsFilterSpec_SBR_R_32s;
/*
// Filter_PQMF
*/
struct IppsFilterContext_PQMF_MP3;
typedef struct IppsFilterContext_PQMF_MP3 IppsFilterSpec_PQMF_MP3;
/*
// Filter_DTS
*/
struct IppsFilterContext_DTS_32f;
typedef struct IppsFilterContext_DTS_32f IppsFilterSpec_DTS_32f;
/*
// MP3 codec defines
*/
#define IPP_MP3_GRANULE_LEN 576 /* maximum number of frequency
decoded lines */
#define IPP_MP3_SF_BUF_LEN 40 /* scalefactor buffer length */
#define IPP_MP3_V_BUF_LEN 512 /* V data buffers length (32-bit words) */
#define IPP_MP3_ID_MPEG2 0 /* MPEG-2 frame identifier */
#define IPP_MP3_ID_MPEG1 1 /* MPEG-1 frame identifier */
/*
// Scalefactor band table length for short block
*/
#define IPP_MP3_SFB_TABLE_LONG_LEN 138
typedef const Ipp16s IppMP3ScaleFactorBandTableLong[IPP_MP3_SFB_TABLE_LONG_LEN];
/*
// Scalefactor band table length for long block
*/
#define IPP_MP3_SFB_TABLE_SHORT_LEN 84
typedef const Ipp16s IppMP3ScaleFactorBandTableShort[IPP_MP3_SFB_TABLE_SHORT_LEN];
/*
// Mixed block partition table
*/
#define IPP_MP3_MBP_TABLE_LEN 12
typedef const Ipp16s IppMP3MixedBlockPartitionTable[IPP_MP3_MBP_TABLE_LEN];
/* Example mixed block partition table
For mixed blocks only, this partition table informs
the Huffman decoder of how many SFBs to count for region0.
IppMP3MixedBlockPartitionTable Modified_Mbp_Table =
{
// MPEG-2
// 22.050 kHz
// Long block SFBs Short block SFBs
6, 2,
// MPEG-2
// 24 kHz
// Long block SFBs Short block SFBs
6, 2,
// MPEG-2
// 16 kHz
// Long block SFBs Short block SFBs
6, 2,
// MPEG-1
// 44.1 kHz
// Long block SFBs Short block SFBs
8, 0,
// MPEG-1
// 48 kHz
// Long block SFBs Short block SFBs
8, 0,
// MPEG-1
// 32 kHz
// Long block SFBs Short block SFBs
8, 0
};
*/
typedef enum {
IPPAC_DTS_NONPERFECT = 0,
IPPAC_DTS_PERFECT = 1
} IppAC_DTS_SYNTHESIS;
typedef enum {
IPP_CDBK_UNKNOWN = 0,
IPP_CDBK_STANDARD = 1
} Ipp_Cdbk_VQ_Hint;
typedef enum {
IPPAC_PS_CONF0 = 0,
IPPAC_PS_CONF1 = 1,
IPPAC_PS_CONF2 = 2,
IPPAC_PS_CONF3 = 3,
IPPAC_PS_CONF4 = 4
} IppAC_PS_DEC_ANALYSIS;
typedef struct CdbkState_VQ_32f IppsVQCodeBookState_32f;
/*
// MPEG-1, MPEG-2 BC header, 32 bits.
// See ISO/IEC 11172-3, sect 2.4.1.3, 2.4.2.3, 2.4.2.4
*/
typedef struct {
int id; /* ID: 1 - MPEG-1, 0 - MPEG-2 */
int layer; /* layer index: 0x3 - Layer I
0x2 - Layer II
0x1 - Layer III */
int protectionBit; /* CRC flag 0: CRC on, 1: CRC off */
int bitRate; /* bit rate index */
int samplingFreq; /* sampling frequency index */
int paddingBit; /* padding flag:
0 - no padding,
1 - padding */
int privateBit; /* private_bit, no use */
int mode; /* mono/stereo select information */
int modeExt; /* extension to mode */
int copyright; /* copyright or not:
0 - no,
1 - yes */
int originalCopy; /* original bitstream or copy:
0 - copy,
1 - original */
int emphasis; /* flag indicates the type of de-emphasis
that shall be used */
int CRCWord; /* CRC-check word */
} IppMP3FrameHeader;
/*
// MP3 side information structure, for each granule.
// Other info main_data_begin, private_bits, scfsi are not included
// here.
// Please refer to reference ISO/IEC 11172-3:1993, 2.4.1.7, 2.4.2.7.
// ISO/IEC 13818-3:1998, 2.4.1.7 ).
*/
typedef struct {
int part23Len; /* the number of bits for scale factors
and Huffman data */
int bigVals; /* the half number of Huffman data whose
maximum amplitudes are greater than 1 */
int globGain; /* the quantizer step size information */
int sfCompress; /* information to select the number of
bits used for the transmission of the
scale factors */
int winSwitch; /* flag signals that the block uses an
other than normal window */
int blockType; /* flag indicates the window type */
int mixedBlock; /* flag indicates type of block:
0 - non mixed block,
1 - mixed block */
int pTableSelect[3]; /* Huffman table index for the 3 regions
in big-values field */
int pSubBlkGain[3]; /* gain offset from the global gain for
one subblock */
int reg0Cnt; /* the number of scale factor bands at
the boundary of the first region of
the big-values field */
int reg1Cnt; /* the number of scale factor bands at
the boundary of the second region of
the big-values field */
int preFlag; /* flag of high frequency amplification */
int sfScale; /* scale to the scale factors */
int cnt1TabSel; /* Huffman table index for the count1
region of quadruples */
} IppMP3SideInfo;
/*
// Global Macro Definitions for AAC codec
*/
#define IPP_AAC_ELT_NUM 16 /* maximum number of elements for
one program */
#define IPP_AAC_CR_ID_LEN 9 /* copyright id length */
#define IPP_AAC_LFE_ELT_NUM (1<<2) /* maximum Low Frequency
Enhance elements number for one
program */
#define IPP_AAC_DATA_ELT_NUM (1<<3) /* maximum data elements number
for one program */
#define IPP_AAC_COMMENTS_LEN (1<<8) /* maximum length of the comment
field in bytes */
#define IPP_AAC_TAG_LEN 4 /* length of AAC data element tag */
#define IPP_AAC_MAX_SFB 51 /* maximum scalefactor band for all
sampling frequencies */
#define IPP_AAC_GROUP_NUM_MAX 8 /* max groups number for one frame */
#define IPP_AAC_SF_MAX 60 /* max number of sfb in one window */
#define IPP_AAC_PRED_SFB_MAX 41 /* maximum prediction scalefactor
bands number for one frame */
#define IPP_AAC_SF_LEN 120 /* scale factor buffer length */
#define IPP_AAC_TNS_FILT_MAX 8 /* maximum filters number for one
frame */
#define ADIF_ID 0x41444946 /* ASCII-"ADIF" */
/*
// ADIF Header
*/
typedef struct {
Ipp32u ADIFId; /* 32-bit, "ADIF" ASCII code */
int copyIdPres; /* copy id flag:
0 - off,
1 - on */
int originalCopy; /* copyright bit:
0 - no copyright on the coded
bitstream,
1 - copyright protected */
int home; /* original/home bit:
0 - the bitstream is a copy,
1 - the bitstream is an original*/
int bitstreamType; /* bitstream flag:
0 - constant rate bitstream,
1 - variable rate bitstream */
int bitRate; /* bit rate; if 0, unkown bit rate */
int numPrgCfgElt; /* number of program configure
elements */
int pADIFBufFullness[IPP_AAC_ELT_NUM]; /* buffer fullness */
Ipp8u pCopyId[IPP_AAC_CR_ID_LEN]; /* copy id */
} IppAACADIFHeader;
/*
// AAC Program Config Element
*/
typedef struct {
int eltInsTag; /* element instance tag */
int profile; /* profile index:
0 - main,
1 - Low Complexity,
2 - Scaleable Sampling Rate,
3 - reserved */
int samplingRateIndex; /* sampling rate index */
int numFrontElt; /* number of front elements */
int numSideElt; /* number of side elements */
int numBackElt; /* number of back elements */
int numLfeElt; /* number of LFE elements */
int numDataElt; /* number of data elements */
int numValidCcElt; /* number of coupling channel
elements */
int monoMixdownPres; /* mono mixdown flag:
0 - off,
1 - on */
int monoMixdownEltNum; /* number of mono mixdown elements */
int stereoMixdownPres; /* stereo mixdown flag:
0 - off,
1 - on */
int stereoMixdownEltNum; /* number of stereo mixdown
elements */
int matrixMixdownIdxPres; /* matrix mixdown flag:
0 - off,
1 - on */
int matrixMixdownIdx; /* identifier of the surround
mixdown coefficient */
int pseudoSurroundEnable; /* pseudo surround:
0 - off,
1 - on */
int pFrontIsCpe[IPP_AAC_ELT_NUM]; /* channel pair flag for
front elements */
int pFrontTagSel[IPP_AAC_ELT_NUM]; /* instance tag for front
elements */
int pSideIsCpe[IPP_AAC_ELT_NUM]; /* channel pair flag for
side elements */
int pSideTagSel[IPP_AAC_ELT_NUM]; /* instance tag for side
elements */
int pBackIsCpe[IPP_AAC_ELT_NUM]; /* channel pair flag for
back elements */
int pBackTagSel[IPP_AAC_ELT_NUM]; /* instance tag for back
elements */
int pLfeTagSel[IPP_AAC_LFE_ELT_NUM]; /* channel pair flag for
LFE elements */
int pDataTagSel[IPP_AAC_DATA_ELT_NUM]; /* instance tag for data
elements */
int pCceIsIndSw[IPP_AAC_ELT_NUM]; /* independent flag for
coupling */
/* channel elements */
int pCceTagSel[IPP_AAC_ELT_NUM]; /* instance tag for coupling
channel elements */
int numComBytes; /* number of comment field
bytes */
Ipp8s pComFieldData[IPP_AAC_COMMENTS_LEN]; /* the comment buffer
field */
} IppAACPrgCfgElt;
/*
// MPEG-2 AAC ADTS frame header See ISO/IEC 13838-7, Table 6.5
*/
typedef struct {
/* ADTS fixed header */
int id; /* ID 1 */
int layer; /* layer index:
0x3 - Layer I,
0x2 - Layer II,
0x1 - Layer III */
int protectionBit; /* CRC flag:
0 - CRC on,
1 - CRC off */
int profile; /* profile:
0 - MP,
1 - LP,
2 - SSR */
int samplingRateIndex; /* sampling frequency index */
int privateBit; /* private_bit, no use */
int chConfig; /* channel configuration */
int originalCopy; /* copyright bit:
0 - no copyright on the coded
bitstream,
1 - copyright protected */
int home; /* original/home bit:
0 - the bitstream is a copy,
1 - the bitstream is an original */
int emphasis; /* no in ISO/IEC 13818-7, but used */
/* by ISO/IEC 14490-3 */
/* ADTS variable header */
int cpRightIdBit; /* copyright id bit */
int cpRightIdStart; /* copyright id start */
int frameLen; /* frame length in bytes */
int ADTSBufFullness; /* buffer fullness */
int numRawBlock; /* n of raw data blocks in the frame */
/* ADTS CRC error check, 16bits */
int CRCWord; /* CRC-check word */
} IppAACADTSFrameHeader;
/*
// Channel Pair Element Structure
*/
typedef struct {
int commonWin; /* common window flag:
0 - off,
1 - on */
int msMaskPres; /* MS stereo mask present flag */
Ipp8u ppMsMask[IPP_AAC_GROUP_NUM_MAX][IPP_AAC_SF_MAX];
/* MS stereo flag buffer for each
scalefactor band */
} IppAACChanPairElt;
/*
// Individual Channel Side Information Structure.
*/
typedef struct {
/* unpacked from the bitstream */
int icsReservedBit; /* reserved bit */
int winSequence; /* window sequence flag */
int winShape; /* window shape flag:
0 - sine window,
1 - KBD window */
int maxSfb; /* maximum effective scale factor bands */
int sfGrouping; /* scale factor grouping information */
int predDataPres; /* prediction data present flag for one
frame:
0 - prediction off,
1 - prediction on */
int predReset; /* prediction reset flag:
0 - off,
1 - on */
int predResetGroupNum; /* prediction reset group number */
Ipp8u pPredUsed[IPP_AAC_PRED_SFB_MAX+3];
/* prediction flag buffer for each scale
factor band:
0 - off,
1 - on buffer length 44 bytes, 4-byte
align */
/* decoded from the above info */
int numWinGrp; /* window group number */
int pWinGrpLen[IPP_AAC_GROUP_NUM_MAX]; /* buffer for number of
windows in each group */
} IppAACIcsInfo;
/*
// MPEG 4 Layer
*/
#define IPP_AAC_TNS_COEF_LEN 60 /* TNS coefficients buffer length */
#define IPP_AAC_MAX_LTP_SFB 40 /* maximum length of Long Term
Prediction buffer for long block */
#define IPP_AAC_WIN_MAX 8 /* maximum length of Long Term
Prediction buffer for short block */
#define IPP_AAC_CHAN_NUM 2 /* number of AAC channels */
#define NOISE_HCB 13 /* code of HCB noise in scalefactor code book */
#define IPP_AAC_FRAME_LEN 1024 /* size of data in one AAC frame */
#define IPP_LTP_BLOCK_LEN (1024*3) /* size of data in one AAC LTP block */
/*
// AAC Channel Information Structure
*/
typedef struct {
int tag; /* channel tag */
int id; /* element id */
int samplingRateIndex; /* sampling rate index */
int predSfbMax; /* maximum prediction scale factor bands */
int preWinShape; /* previous block window shape */
int winLen; /* 128: if short window, 1024: others */
int numWin; /* 1 for long block, 8 for short block */
int numSwb; /* decided by sampling frequency and
block type */
/* unpacking from the bitstream */
int globGain; /* global gain */
int pulseDataPres; /* pulse data present flag:
0 - off,
1 - on */
int tnsDataPres; /* TNS data present flag:
0 - off,
1 - on */
int gainContrDataPres; /* gain control data present flag:
0 - off,
1 - on */
/* Ics Info pointer */
IppAACIcsInfo *pIcsInfo; /* pointer to IppAACIcsInfo structure */
/* channel pair element pointer */
IppAACChanPairElt *pChanPairElt; /* pointer to IppAACChanPairElt
structure */
/* section data */
Ipp8u pSectCb[IPP_AAC_SF_LEN]; /* section code book buffer */
Ipp8u pSectEnd[IPP_AAC_SF_LEN]; /* end of scale factor offset
in each section */
int pMaxSect[IPP_AAC_GROUP_NUM_MAX]; /* maximum section number
for each group */
/* TNS data */
int pTnsNumFilt[IPP_AAC_GROUP_NUM_MAX]; /* TNS number filter
number buffer */
int pTnsFiltCoefRes[IPP_AAC_GROUP_NUM_MAX]; /* TNS coefficients
resolution flag */
int pTnsRegionLen[IPP_AAC_TNS_FILT_MAX]; /* TNS filter length */
int pTnsFiltOrder[IPP_AAC_TNS_FILT_MAX]; /* TNS filter order */
int pTnsDirection[IPP_AAC_TNS_FILT_MAX]; /* TNS filter direction
flag */
} IppAACChanInfo;
/*
// TNS Information Structure
*/
typedef struct {
int tnsDataPresent; /* if TNS is used */
int pTnsNumFilt[IPP_AAC_GROUP_NUM_MAX]; /* Number of TNS filter */
int pTnsFiltCoefRes[IPP_AAC_GROUP_NUM_MAX]; /* TNS coefficient
resolution */
int pTnsRegionLen[IPP_AAC_TNS_FILT_MAX]; /* TNS filter length */
int pTnsFiltOrder[IPP_AAC_TNS_FILT_MAX]; /* TNS filter order */
int pTnsDirection[IPP_AAC_TNS_FILT_MAX]; /* TNS filter direction
flag */
int pTnsCoefCompress[IPP_AAC_GROUP_NUM_MAX]; /* TNS compress
coefficients */
Ipp8s pTnsFiltCoef[IPP_AAC_TNS_COEF_LEN]; /* TNS filter
coefficients */
} IppAACTnsInfo;
/*
// Long Term Prediction (LTP) Structure
*/
typedef struct{
int ltpDataPresent; /* if LTP is used */
int ltpLag; /* optimal delay from 0 to 2047 */
Ipp16s ltpCoef; /* indicate the LTP coefficient */
int pLtpLongUsed[IPP_AAC_SF_MAX+1]; /* if long block use ltp */
int pLtpShortUsed[IPP_AAC_WIN_MAX]; /* if short block use ltp */
int pLtpShortLagPresent[IPP_AAC_WIN_MAX]; /* if short lag
is transmitted */
int pLtpShortLag[IPP_AAC_WIN_MAX]; /* relative delay
for short window */
} IppAACLtpInfo;
/*
// AAC Scalable Main Element Header
*/
typedef struct {
int windowSequence; /* the windows is short or long type */
int windowShape; /* what window is used for the right hand,
part of this analysis window */
int maxSfb; /* number of scale factor band transmitted */
int sfGrouping; /* grouping of short spectral data */
int numWinGrp; /* window group number */
int pWinGrpLen[IPP_AAC_GROUP_NUM_MAX]; /* length of every group */
int msMode; /* MS stereo flag:
0 - none,
1 - different for every sfb,
2 - all */
Ipp8u (*ppMsMask)[IPP_AAC_SF_MAX]; /* if MS's used in one sfb,
when msMode == 1 */
IppAACTnsInfo pTnsInfo[IPP_AAC_CHAN_NUM]; /* TNS structure for
two channels */
IppAACLtpInfo pLtpInfo[IPP_AAC_CHAN_NUM]; /* LTP structure for
two channels */
} IppAACMainHeader;
/*
// AAC Scalable Extension Element Header
*/
typedef struct{
int msMode; /* Mode:
0 - non,
1 - part,
2 - all */
int maxSfb; /* number of scale factor band for extension layer */
Ipp8u (*ppMsMask)[IPP_AAC_SF_MAX]; /* if MS is used */
IppAACTnsInfo pTnsInfo[IPP_AAC_CHAN_NUM]; /* TNS structure
for Stereo */
int pDiffControlLr[IPP_AAC_CHAN_NUM][IPP_AAC_MAX_SFB]; /*
FSS information for stereo */
} IppAACExtHeader;
/*
// MP3 encoder
*/
#define IPP_MP3_CHANNEL_NUM 2 /* Number MP3 channels */
#define IPP_MP3_PSY_BAND_LONG_NUM 63 /* Number MP3 partition energy for long blocks */
#define IPP_MP3_PSY_BAND_SHORT_NUM 42 /* Number MP3 partition energy for short blocks */
#define FIRST_6_CW 6 /* Number calculated lines are used for
unpredictability measure */
#define IPP_MP3_BIT_RATE_FREE 0 /* Type value for free bit rate */
#define IPP_MP3_BIT_RATE_32 1 /* Type value for 32 bit rate */
#define IPP_MP3_BIT_RATE_40 2 /* Type value for 40 bit rate */
#define IPP_MP3_BIT_RATE_48 3 /* Type value for 48 bit rate */
#define IPP_MP3_BIT_RATE_56 4 /* Type value for 56 bit rate */
#define IPP_MP3_BIT_RATE_64 5 /* Type value for 64 bit rate */
#define IPP_MP3_BIT_RATE_80 6 /* Type value for 80 bit rate */
#define IPP_MP3_BIT_RATE_96 7 /* Type value for 96 bit rate */
#define IPP_MP3_BIT_RATE_112 8 /* Type value for 112 bit rate */
#define IPP_MP3_BIT_RATE_128 9 /* Type value for 128 bit rate */
#define IPP_MP3_BIT_RATE_160 10 /* Type value for 160 bit rate */
#define IPP_MP3_BIT_RATE_192 11 /* Type value for 192 bit rate */
#define IPP_MP3_BIT_RATE_224 12 /* Type value for 224 bit rate */
#define IPP_MP3_BIT_RATE_256 13 /* Type value for 256 bit rate */
#define IPP_MP3_BIT_RATE_320 14 /* Type value for 320 bit rate */
#define IPP_MP3_SAMPLE_RATE_32000 2 /* Type value for 32000 sample rate */
#define IPP_MP3_SAMPLE_RATE_44100 0 /* Type value for 44100 sample rate */
#define IPP_MP3_SAMPLE_RATE_48000 1 /* Type value for 48000 sample rate */
#define IPP_MP3_NONINTERLEAVED_PCM 1 /* Type value for non interleaved PCM */
#define IPP_MP3_INTERLEAVED_PCM 2 /* Type value for interleaved PCM */
/*
// MP3 Huffman Table Structure
*/
typedef struct {
int tableSize; /* number of rows in table */
int linbits; /* variable used for encode if the
magnitude of encoded value is
greater or equal to 15 */
int maxBitsValue; /* maximum bit length of codewords */
Ipp16u *pHcod; /* pointer to Huffman code table */
Ipp8u *pSlen; /* pointer to Huffman length table */
} IppMP3HuffmanTable;
/*
// MP3 Quant Information Structure
*/
typedef struct {
int ScaleFactorBits; /* number of bits used to
encode scale factors */
Ipp32s pEnergy[IPP_MP3_SF_BUF_LEN]; /* energy of each scale
factor band */
Ipp32s pDistortion[IPP_MP3_SF_BUF_LEN]; /* allowed distortion
of each scale factor
band */
Ipp32s pXmin[IPP_MP3_SF_BUF_LEN]; /* allowed distortion of
each scale factor band */
Ipp32s pNMR[IPP_MP3_SF_BUF_LEN]; /* Noise-Mask-Ratio array */
int quantizeStepSize; /* quantization step */
int pSfbMaxIndex[40]; /* index array of Scalefactor
band maximum values */
int minBits; /* minimum bits decided by the bit reservoir
and used bits */
int maxBits; /* decided by estimatedBits and bit reservoir */
int count1; /* number of Huffman symbols whose magnitude
is no greater than 1 */
int hufSize; /* number of bits used for Huffman symbols */
int pRegionCount[3]; /* pointer to the number of Hufman symbols
in each region for the big values part */
} IppMP3QuantInfo;
/*
// MP3 Bit Reservoir
*/
typedef struct {
int BitsRemaining; /* bits currently remaining in the reservoir */
int MaxBits; /* maximum possible reservoir size, in bits,
determined as follows: min(7680-avg_frame_len,
2^9*8), where avg_frame_len is the average frame
length, in bits, including padding bits and
excluding side information bits */
} IppMP3BitReservoir;
/*
// Psychoacoustic Model Two State
*/
typedef struct {
Ipp64s pPrevMaskedThresholdLong[2][63]; /* long block masked
threshold history buffer; Contains masked threshold
estimates for the threshold calculation partitions
associated with the two most recent long blocks */
Ipp64s pPrevMaskedThresholdShort[IPP_MP3_PSY_BAND_SHORT_NUM]; /*
short block masked threshold history buffer; Contains
masked threshold estimates for the threshold
calculation partitions associated with the two most
recent long blocks */
Ipp32sc pPrevFFT[2][FIRST_6_CW]; /* FFT history buffer;
contains real and imaginary FFT components associated
with the two most recent long blocks */
Ipp32s pPrevFFTMag[2][FIRST_6_CW]; /* FFT magnitude history
buffer; contains FFT component magnitudes associated
with the two most recent long blocks */
int nextPerceptualEntropy; /* PE estimate for next
granule; one granule delay provided for synchronization
with analysis filterbank */
int nextBlockType; /* Expected block type for
next granule; either long (normal), short, or stop.
Depending upon analysis results for the granule
following the next, a long block could change to a
start block, and a stop block could change to a short
block. This buffer provides one granule of delay for
synchronization with the analysis filterbank */
Ipp32s pNextMSRLong[IPP_MP3_SF_BUF_LEN]; /* long block MSR
estimates for next granule. One granule delay provided
for synchronization with analysis filterbank */
Ipp32s pNextMSRShort[IPP_MP3_SF_BUF_LEN]; /* short block MSR
estimates for next granule. One granule delay provided
for synchronization with analysis filterbank */
} IppMP3PsychoacousticModelTwoState;
/*
// MP3 Psychoacoustic Model Two Analysis
*/
typedef struct {
Ipp32s pMSR[36]; /* MSRs for one granule/channel. For long blocks,
elements 0-20 represent the thresholds
associated with the 21 SFBs. For short blocks,
elements 0,3,6,..,33, elements 1,4,...,34, and
elements 2,5,...,35, respectively, represent
the thresholds associated with the 12 SFBs for
each of the 3 consecutive short blocks in one
granule/channel. That is, the block thresholds
are interleaved such that the thresholds are
grouped by SFB. */
Ipp32s PE; /* Estimated perceptual entropy, one
granule/channel */
} IppMP3PsychoacousticModelTwoAnalysis;
#endif /* _OWN_BLDPCS */
/*******************************************************************/
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippacGetLibVersion
//
// Purpose:
// Get the library version.
//
// Parameters:
//
// Returns:
// The structure of information about version of ippac library.
//
// Notes:
// Not necessary to release the returned structure.
*/
IPPAPI(const IppLibraryVersion*, ippacGetLibVersion, (void))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFDPReset_32f
//
// Purpose:
// Resets predictors for all spectral lines.
//
// Parameters:
// pFDPState Pointer to the predictor specific state structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pFDPState pointer is
// NULL.
// ippStsContextMatchErr Indicates an error when the state structure is
// invalid.
*/
IPPAPI(IppStatus, ippsFDPReset_32f, (IppsFDPState_32f *pFDPState))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFDPResetSfb_32f
//
// Purpose:
// Resets predictor-specific information in some scale factor bands.
//
// Parameters:
// pSfbOffset Pointer to the band offset vector.
// sfbNumber Number of bands.
// pResetFlag Array of flags showing whether predictors for
// spectral lines in a certain scale factor band
// need to be reset. pFDPState Pointer to the
// predictor specific state structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsSizeErr Indicates an error when sfbNumber is less than
// or equal to 0.
// ippStsContextMatchErr Indicates an error when the state structure is
// invalid.
*/
IPPAPI(IppStatus, ippsFDPResetSfb_32f, (const int* pSfbOffset, int sfbNumber, const Ipp8u* pResetFlag, IppsFDPState_32f* pFDPState))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFDPResetGroup_32f
//
// Purpose:
// Resets predictors for group of spectral lines.
//
// Parameters:
// resetGroupNumber Number of the group to be reset.
// step Distance between two neighboring spectral lines
// in the group.
// pFDPState Pointer to the predictor specific state structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pFDPState pointer is
// NULL.
// ippStsSizeErr Indicates an error when resetGroupNumber or step
// is less than or equal to 0.
// ippStsContextMatchErr Indicates an error when the state structure is
// invalid.
*/
IPPAPI(IppStatus, ippsFDPResetGroup_32f, (int resetGroupNumber, int step, IppsFDPState_32f* pFDPState))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFDPInitAlloc_32f
//
// Purpose:
// Creates and initializes predictor state.
//
// Parameters:
// ppFDPState Pointer to pointer to the FDP state structure to
// be created.
// len Number of spectral lines to be processed. Audio
// Coding Functions 10 10-29
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the ppFDPState pointer is
// NULL.
// ippStsSizeErr Indicates an error when the len is less than
// or equal to 0.
// ippStsMemAllocErr Indicates an error when no memory is allocated.
*/
IPPAPI(IppStatus, ippsFDPInitAlloc_32f, (IppsFDPState_32f** ppFDPState, int len))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFDPFree_32f
//
// Purpose:
// Closes FDP state.
//
// Parameters:
// pFDPState Pointer to the FDP state structure to be closed.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pFDPState pointer is
// NULL.
// ippStsContextMatchErr Indicates an error when the state structure is
// invalid.
*/
IPPAPI(IppStatus, ippsFDPFree_32f, (IppsFDPState_32f *pFDPState))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFDPFwd_32f
//
// Purpose:
// Performs frequency domain prediction procedure and calculates
// prediction error.
//
// Parameters:
// pSrc Pointer to the input data array.
// pDst Pointer to the data array to be filled with
// prediction errors.
// pFDPState Pointer to the predictor specific state structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pFDPState pointer is
// NULL.
// ippStsContextMatchErr Indicates an error when the state structure is
// invalid.
// ippStsMisalignedBuf Indicates misaligned arrays. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsFDPFwd_32f, (const Ipp32f* pSrc, Ipp32f* pDst, IppsFDPState_32f* pFDPState))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFDPInv_32f_I
//
// Purpose:
// Retrieves input signal from prediction error, using frequency domain
// prediction procedure.
//
// Parameters:
// pSrcDst Pointer to the input and output data array for
// the in-place operation.
// pBandsOffset Pointer to the band offset vector.
// predictorBandsNumber Number of scale factor bands.
// pPredictionUsed Pointer to array of flags showing whether
// prediction will be used in certain scale factor
// band.
// pFDPState Pointer to the predictor specific state structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsSizeErr Indicates an error when predictorBandsNumber is
// less than or equal to 0.
// ippStsContextMatchErr Indicates an error when the state structure is
// invalid.
// ippStsMisalignedBuf Indicates misaligned arrays. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsFDPInv_32f_I, (Ipp32f* pSrcDst, const int* pBandOffset, int predictorBandsNumber, const Ipp8u* pPredictionUsed, IppsFDPState_32f* pFDPState))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFDPInit_32f
//
// Purpose:
// Initializes predictor state.
//
// Parameters:
// ppFDPState Pointer to pointer to the FDP state structure to
// be initialized.
// len Number of spectral lines to be processed.
// pMemSpec Pointer to the area for FDP state structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when ppFDPState or pMemSpec
// is NULL.
// ippStsSizeErr Indicates an error when the len is less than
// or equal to 0.
*/
IPPAPI(IppStatus, ippsFDPInit_32f, (IppsFDPState_32f **ppFDPState, int len, Ipp8u *pMemSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFDPGetSize_32f
//
// Purpose:
// Gets size of FDP state structure.
//
// Parameters:
// len Number of spectral lines to be processed.
// pSizeState Address of size value in bytes of the frequency
// domain predictor state structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSizeState pointer
// is NULL.
// ippStsSizeErr Indicates an error when the length is less than
// or equal to 0.
*/
IPPAPI(IppStatus, ippsFDPGetSize_32f, (int len, int *pSizeState))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFIRBlockInitAlloc_32f
//
// Purpose:
// Initializes FIR block filter state.
//
// Parameters:
// pState Pointer to the FIR block filter state structure
// to be created.
// order Number of elements in the array containing the
// tap values.
// len Number of input signals.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pointers to data
// arrays are null.
// ippStsMemAllocErr Indicates an error when no memory is allocated.
// ippStsFIRLenErr Indicates an error when order or len is less
// than or equal to 0.
*/
IPPAPI(IppStatus, ippsFIRBlockInitAlloc_32f,(IppsFIRBlockState_32f** pState,
int order, int len))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFIRBlockFree_32f
//
// Purpose:
// Closes FIR block filter state.
//
// Parameters:
// pState Pointer to the FIR block filter state structure
// to be closed.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pointers to data
// arrays are null.
// ippStsContextMatchErr Indicates an error when the state structure is
// invalid.
*/
IPPAPI(IppStatus, ippsFIRBlockFree_32f,(IppsFIRBlockState_32f* pState))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsFIRBlockOne_32f
//
// Purpose:
// Filters vector of samples through FIR block filter.
//
// Parameters:
// pSrc Pointer to the input vector of samples to be
// filtered.
// pDst Pointer to the vector of filtered output samples.
// pState Pointer to the FIR filter state structure.
// pTaps Pointer to the vector of filter taps.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsContextMatchErr Indicates an error when the state structure is
// invalid.
// ippStsMisalignedBuf Indicates misaligned arrays. Supply aligned data
// for better performance.
// ippStsFIRLenErr Indicates an error when one of following conditions is true:
// 1)pState->len is less than or equal to 0;
// 2)pState->order is less than or equal to 0;
// 3)pState->queue_end is less than 0;
// 4)pState->queue_end is greater or equal to pState->order.
*/
IPPAPI(IppStatus, ippsFIRBlockOne_32f,(Ipp32f *pSrc, Ipp32f* pDst, IppsFIRBlockState_32f* pState, Ipp32f *pTaps))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwdInitAlloc_32f
//
// Purpose:
// Create and initialize modified discrete cosine transform specification
// structure.
//
// Parameters:
// ppMDCTSpec Pointer to pointer to MDCT specification
// structure to be created.
// len Number of samples in MDCT. Since this set of
// functions was designed specially for audio
// coding, only the following values of length are
// supported: 12, 36, and , where . These values
// are the only values that appear in audio coding.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the ppMDCTSpec pointer
// is NULL.
// ippStsSizeErr Indicates an error when len does not belong to
// the above set of admissible values.
// ippStsMemAllocErr Indicates an error when no memory is allocated.
*/
IPPAPI(IppStatus, ippsMDCTFwdInitAlloc_32f,(IppsMDCTFwdSpec_32f** ppMDCTSpec, int len))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTInvInitAlloc_32f
//
// Purpose:
// Create and initialize modified discrete cosine transform specification
// structure.
//
// Parameters:
// ppMDCTSpec Pointer to pointer to MDCT specification
// structure to be created.
// len Number of samples in MDCT. Since this set of
// functions was designed specially for audio
// coding, only the following values of length are
// supported: 12, 36, and , where . These values
// are the only values that appear in audio coding.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the ppMDCTSpec pointer
// is NULL.
// ippStsSizeErr Indicates an error when len does not belong to
// the above set of admissible values.
// ippStsMemAllocErr Indicates an error when no memory is allocated.
*/
IPPAPI(IppStatus, ippsMDCTInvInitAlloc_32f,(IppsMDCTInvSpec_32f** ppMDCTSpec, int len))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwdFree_32f
//
// Purpose:
// Closes modified discrete cosine transform specification structure.
//
// Parameters:
// pMDCTSpec Pointer to the MDCT specification structure to
// be closed.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pMDCTSpec pointer is
// NULL.
*/
IPPAPI(IppStatus, ippsMDCTFwdFree_32f,(IppsMDCTFwdSpec_32f* pMDCTSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTInvFree_32f
//
// Purpose:
// Closes modified discrete cosine transform specification structure.
//
// Parameters:
// pMDCTSpec Pointer to the MDCT specification structure to
// be closed.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pMDCTSpec pointer is
// NULL.
*/
IPPAPI(IppStatus, ippsMDCTInvFree_32f,(IppsMDCTInvSpec_32f* pMDCTSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwdGetBufSize_32f
//
// Purpose:
// Gets the size of MDCT work buffer.
//
// Parameters:
// pMDCTSpec Pointer to the MDCT specification structure.
// pSize Address of the MDCT work buffer size value in
// bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pMDCTSpec pointer or
// pSize value is NULL.
// ippStsContextMatchErr Indicates an error when the specification
// structure pMDCTSpec is invalid.
*/
IPPAPI(IppStatus, ippsMDCTFwdGetBufSize_32f,(const IppsMDCTFwdSpec_32f* pMDCTSpec,
int* pSize))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTInvGetBufSize_32f
//
// Purpose:
// Gets the size of MDCT work buffer.
//
// Parameters:
// pMDCTSpec Pointer to the MDCT specification structure.
// pSize Address of the MDCT work buffer size value in
// bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pMDCTSpec pointer or
// pSize value is NULL.
// ippStsContextMatchErr Indicates an error when the specification
// structure pMDCTSpec is invalid.
*/
IPPAPI(IppStatus, ippsMDCTInvGetBufSize_32f,(const IppsMDCTInvSpec_32f* pMDCTSpec,
int* pSize))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwd_32f
//
// Purpose:
// Computes forward or inverse modified discrete cosine transform (MDCT)
// of a signal.
//
// Parameters:
// pSrc Pointer to the input data array.
// pDst Pointer to the output data array.
// pSrcDst Pointer to the input and output data array for
// the in-place operations.
// pMDCTSpec Pointer to the MDCT specification structure.
// pBuffer Pointer to the MDCT work buffer.
// scaleFactor Scalefactor value.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsContextMatchErr Indicates an error when the specification
// structure pMDCTSpec is invalid.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsMDCTFwd_32f,(const Ipp32f* pSrc, Ipp32f* pDst,
const IppsMDCTFwdSpec_32f* pMDCTSpec, Ipp8u* pBuffer))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTInv_32f
//
// Purpose:
// Computes forward or inverse modified discrete cosine transform (MDCT)
// of a signal.
//
// Parameters:
// pSrc Pointer to the input data array.
// pDst Pointer to the output data array.
// pMDCTSpec Pointer to the MDCT specification structure.
// pBuffer Pointer to the MDCT work buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsContextMatchErr Indicates an error when the specification
// structure pMDCTSpec is invalid.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsMDCTInv_32f,(const Ipp32f* pSrc, Ipp32f* pDst,
const IppsMDCTInvSpec_32f* pMDCTSpec, Ipp8u* pBuffer))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwd_32f_I
//
// Purpose:
// Computes forward or inverse modified discrete cosine transform (MDCT)
// of a signal.
//
// Parameters:
// pSrcDst Pointer to the input and output data array for
// the in-place operations.
// pMDCTSpec Pointer to the MDCT specification structure.
// pBuffer Pointer to the MDCT work buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsContextMatchErr Indicates an error when the specification
// structure pMDCTSpec is invalid.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsMDCTFwd_32f_I,(Ipp32f* pSrcDst, const IppsMDCTFwdSpec_32f* pMDCTSpec, Ipp8u* pBuffer))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTInv_32f_I
//
// Purpose:
// Computes forward or inverse modified discrete cosine transform (MDCT)
// of a signal.
//
// Parameters:
// pSrcDst Pointer to the input and output data array for
// the in-place operations.
// pMDCTSpec Pointer to the MDCT specification structure.
// pBuffer Pointer to the MDCT work buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsContextMatchErr Indicates an error when the specification
// structure pMDCTSpec is invalid.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsMDCTInv_32f_I,(Ipp32f* pSrcDst, const IppsMDCTInvSpec_32f* pMDCTSpec, Ipp8u* pBuffer))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwd_16s_Sfs
//
// Purpose:
// Computes forward or inverse modified discrete cosine transform (MDCT)
// of a signal.
//
// Parameters:
// pSrc Pointer to the input data array.
// pDst Pointer to the output data array.
// pMDCTSpec Pointer to the MDCT specification structure.
// scaleFactor Scalefactor value.
// pBuffer Pointer to the MDCT work buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsContextMatchErr Indicates an error when the specification
// structure pMDCTSpec is invalid.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsMDCTFwd_16s_Sfs,
(const Ipp16s *pSrc, Ipp16s *pDst,
const IppsMDCTFwdSpec_16s* pMDCTSpec,
int scaleFactor, Ipp8u* pBuffer))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwdInitAlloc_16s
//
// Purpose:
// Create and initialize modified discrete cosine transform specification
// structure.
//
// Parameters:
// ppMDCTSpec Pointer to pointer to MDCT specification
// structure to be created.
// len Number of samples in MDCT. Since this set of
// functions was designed specially for audio
// coding, only the following values of length are
// supported: 12, 36, and 2**k, where k>=5. These
// values are the only values that appear in audio
// coding.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the ppMDCTSpec pointer
// is NULL.
// ippStsSizeErr Indicates an error when len does not belong to
// the above set of admissible values.
// ippStsMemAllocErr Indicates an error when no memory is allocated.
*/
IPPAPI(IppStatus, ippsMDCTFwdInitAlloc_16s, (IppsMDCTFwdSpec_16s** ppMDCTSpec, int len))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwdFree_32f
//
// Purpose:
// Closes modified discrete cosine transform specification structure.
//
// Parameters:
// pMDCTSpec Pointer to the MDCT specification structure to
// be closed.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pMDCTSpec pointer is
// NULL.
*/
IPPAPI(IppStatus, ippsMDCTFwdFree_16s, (IppsMDCTFwdSpec_16s* pMDCTSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwdGetSize_16s
//
// Purpose:
// Get the sizes of MDCT specification structure, MDCT initialization,
// and MDCT work buffer.
//
// Parameters:
// len Number of samples in MDCT. Since this set of
// functions is designed specially for audio
// coding, only the following values of length are
// supported: 12, 36, and 2**k, where k>=5. These
// values are the only values that appear in audio
// coding.
// pSizeSpec Address of the MDCT specification structure size
// value in bytes.
// pSizeInit Address of the MDCT initialization buffer size
// value in bytes.
// pSizeBuf Address of the MDCT work buffer size value in
// bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSizeSpec,
// pSizeInit, or pSizeBuf pointer is NULL.
// ippStsSizeErr Indicates an error when len does not belong to
// the above set of admissible values.
*/
IPPAPI(IppStatus, ippsMDCTFwdGetSize_16s, (int len, int* pSizeSpec, int* pSizeInit, int* pSizeBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwdGetBufSize_16s
//
// Purpose:
// Gets the size of MDCT work buffer.
//
// Parameters:
// pMDCTSpec Pointer to the MDCT specification structure.
// pSize Address of the MDCT work buffer size value in
// bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pMDCTSpec pointer or
// pSize value is NULL.
// ippStsContextMatchErr Indicates an error when the specification
// structure pMDCTSpec is invalid.
*/
IPPAPI(IppStatus, ippsMDCTFwdGetBufSize_16s,
(const IppsMDCTFwdSpec_16s *pMDCTSpec, int *pSize))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTInvGetSize_32f
//
// Purpose:
// Get the sizes of MDCT specification structure, MDCT initialization,
// and MDCT work buffer.
//
// Parameters:
// len Number of samples in MDCT. Since this set of
// functions is designed specially for audio
// coding, only the following values of length are
// supported: 12, 36, and 2**k, where k>=5. These
// values are the only values that appear in audio
// coding.
// pSizeSpec Address of the MDCT specification structure size
// value in bytes.
// pSizeInit Address of the MDCT initialization buffer size
// value in bytes.
// pSizeBuf Address of the MDCT work buffer size value in
// bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSizeSpec,
// pSizeInit, or pSizeBuf pointer is NULL.
// ippStsSizeErr Indicates an error when len does not belong to
// the above set of admissible values.
*/
IPPAPI(IppStatus, ippsMDCTInvGetSize_32f, (int len, int *pSizeSpec, int *pSizeInit, int *pSizeBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwdGetSize_32f
//
// Purpose:
// Get the sizes of MDCT specification structure, MDCT initialization,
// and MDCT work buffer.
//
// Parameters:
// len Number of samples in MDCT. Since this set of
// functions is designed specially for audio
// coding, only the following values of length are
// supported: 12, 36, and 2**k, where k>=5. These
// values are the only values that appear in audio
// coding.
// pSizeSpec Address of the MDCT specification structure size
// value in bytes.
// pSizeInit Address of the MDCT initialization buffer size
// value in bytes.
// pSizeBuf Address of the MDCT work buffer size value in
// bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSizeSpec,
// pSizeInit, or pSizeBuf pointer is NULL.
// ippStsSizeErr Indicates an error when len does not belong to
// the above set of admissible values.
*/
IPPAPI(IppStatus, ippsMDCTFwdGetSize_32f, (int len, int *pSizeSpec, int *pSizeInit, int *pSizeBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwdInit_32f
//
// Purpose:
// Initialize modified discrete cosine transform specification structure.
//
// Parameters:
// ppMDCTSpec Pointer to pointer to MDCT specification
// structure to be created.
// len Number of samples in MDCT. Since this set of
// functions was designed specially for audio
// coding, only the following values of length are
// supported: 12, 36, and 2**k, where k>=5. These
// values are the only values that appear in audio
// coding.
// pMemSpec Pointer to the area for MDCT specification
// structure.
// pMemInit Pointer to the buffer that is used for
// initialization.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the ppMDCTSpec, pMemSpec
// or pMemInit pointer is NULL.
// ippStsSizeErr Indicates an error when len does not belong to
// the above set of admissible values.
*/
IPPAPI(IppStatus, ippsMDCTFwdInit_32f, (IppsMDCTFwdSpec_32f** ppMDCTSpec, int len, Ipp8u* pMemSpec, Ipp8u* pMemInit))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTInvInit_32f
//
// Purpose:
// Initialize modified discrete cosine transform specification structure.
//
// Parameters:
// ppMDCTSpec Pointer to pointer to MDCT specification
// structure to be created.
// len Number of samples in MDCT. Since this set of
// functions was designed specially for audio
// coding, only the following values of length are
// supported: 12, 36, and 2**k, where k>=5. These
// values are the only values that appear in audio
// coding.
// pMemSpec Pointer to the area for MDCT specification
// structure.
// pMemInit Pointer to the buffer that is used for
// initialization.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the ppMDCTSpec, pMemSpec
// or pMemInit pointer is NULL.
// ippStsSizeErr Indicates an error when len does not belong to
// the above set of admissible values.
*/
IPPAPI(IppStatus, ippsMDCTInvInit_32f,(IppsMDCTInvSpec_32f** ppMDCTSpec, int len, Ipp8u* pMemSpec, Ipp8u* pMemInit))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwdInit_16s
//
// Purpose:
// Initialize modified discrete cosine transform specification structure.
//
// Parameters:
// ppMDCTSpec Pointer to pointer to MDCT specification
// structure to be created.
// len Number of samples in MDCT. Since this set of
// functions was designed specially for audio
// coding, only the following values of length are
// supported: 12, 36, and 2**k, where k>=5. These
// values are the only values that appear in audio
// coding.
// pMemSpec Pointer to the area for MDCT specification
// structure.
// pMemInit Pointer to the buffer that is used for
// initialization.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the ppMDCTSpec, pMemSpec
// or pMemInit pointer is NULL.
// ippStsSizeErr Indicates an error when len does not belong to
// the above set of admissible values.
*/
IPPAPI(IppStatus, ippsMDCTFwdInit_16s,(IppsMDCTFwdSpec_16s** ppMDCTSpec, int len, Ipp8u* pMemSpec, Ipp8u* pMemInit))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSpread_16s_Sfs
//
// Purpose:
// Computes spreading function.
//
// Parameters:
// Src1 Input data 1.
// Src2 Input data 2.
// inScaleFactor Input value scalefactor value.
// pDst Pointer to the output data vector, output data
// is in Q15 format.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pDst pointer is NULL.
*/
IPPAPI(IppStatus, ippsSpread_16s_Sfs,
(Ipp16s src1, Ipp16s src2, int inScaleFactor, Ipp16s* pDst))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsInterleave_16s
//
// Purpose:
// Converts signal from non-interleaved to interleaved format.
//
// Parameters:
// pSrc Array of pointers to the vectors [len]
// containing samples for particular channels.
// ch_num Number of channels.
// len Number of samples in each channel.
// pDst Pointer to the destination vector [ch_num * len]
// in interleaved format.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSrc or pDst pointer
// is NULL.
// ippStsSizeErr Indicates an error when len is less than or
// equal to 0.
// ippStsNumChannelsErr Indicates an error when ch_num is less than or
// equal to 0.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsInterleave_16s, (const Ipp16s **pSrc,
int ch_num,
int len,
Ipp16s *pDst))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsInterleave_32f
//
// Purpose:
// Converts signal from non-interleaved to interleaved format.
//
// Parameters:
// pSrc Array of pointers to the vectors [len]
// containing samples for particular channels.
// ch_num Number of channels.
// len Number of samples in each channel.
// pDst Pointer to the destination vector [ch_num * len]
// in interleaved format.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSrc or pDst pointer
// is NULL.
// ippStsSizeErr Indicates an error when len is less than or
// equal to 0.
// ippStsNumChannelsErr Indicates an error when ch_num is less than or
// equal to 0.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsInterleave_32f, (const Ipp32f **pSrc,
int ch_num,
int len,
Ipp32f *pDst))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDeinterleave_16s
//
// Purpose:
// Converts signal from interleaved to non-interleaved format.
//
// Parameters:
// pSrc Pointer to vector [ch_num * len] of interleaved
// samples.
// ch_num Number of channels.
// len Number of samples in each channel.
// pDst Array of pointers to the vectors [len] to be
// filled with samples of particular channels.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSrc or pDst pointer
// is NULL.
// ippStsSizeErr Indicates an error when len or ch_num is less
// than or equal to 0.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsDeinterleave_16s, (const Ipp16s* pSrc, int ch_num,
int len, Ipp16s** pDst))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDeinterleave_32f
//
// Purpose:
// Converts signal from interleaved to non-interleaved format.
//
// Parameters:
// pSrc Pointer to vector [ch_num * len] of interleaved
// samples.
// ch_num Number of channels.
// len Number of samples in each channel.
// pDst Array of pointers to the vectors [len] to be
// filled with samples of particular channels.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSrc or pDst pointer
// is NULL.
// ippStsSizeErr Indicates an error when len or ch_num is less
// than or equal to 0.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
*/
IPPAPI(IppStatus, ippsDeinterleave_32f, (const Ipp32f* pSrc, int ch_num,
int len, Ipp32f** pDst))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsPow34_32f16s
//
// Purpose:
// Raises a vector to the power of 3/4.
//
// Parameters:
// pSrc Pointer to the input data vector [len].
// pDst Pointer to the output data vector [len].
// len Number of elements in the input and output
// vectors.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSrc or pDst pointer
// is NULL.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
// ippStsSizeErr Indicates an error when len is less than or
// equal to 0.
*/
IPPAPI(IppStatus, ippsPow34_32f16s, (const Ipp32f* pSrc, Ipp16s* pDst, int len))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsPow43_16s32f
//
// Purpose:
// Raises a vector to the power of 4/3.
//
// Parameters:
// pSrc Pointer to the input data vector [len].
// pDst Pointer to the output data vector [len].
// len Number of elements in the input and output
// vectors.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSrc or pDst pointer
// is NULL.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data for
// better performance.
// ippStsSizeErr Indicates an error when len is less than or
// equal to 0.
*/
IPPAPI(IppStatus, ippsPow43_16s32f, (const Ipp16s* pSrc, Ipp32f* pDst, int len))
IPPAPI(IppStatus, ippsPow43Scale_16s32s_Sf, (const Ipp16s* pSrc, Ipp32s* pDst,
const Ipp16s *pScaleFactor, const Ipp32s *pBandOffset,
int offset, int bandsNumber, int groupLen, int scalef))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsPow34_32f
//
// Purpose:
// Raises a vector to the power of 3/4.
//
// Parameters:
// pSrc Pointer to the input data vector [len].
// pDst Pointer to the output data vector [len].
// len Number of elements in the input and output
// vectors.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSrc or pDst pointer
// is NULL.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
// ippStsSizeErr Indicates an error when len is less than or
// equal to 0.
*/
IPPAPI(IppStatus, ippsPow34_32f,(const Ipp32f* pSrc, Ipp32f* pDst, int len))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsPow34_16s_Sfs
//
// Purpose:
// Raises a vector to the power of 3/4.
//
// Parameters:
// pSrc Pointer to the input data vector [len].
// inscaleFactor Input data scalefactor value.
// pDst Pointer to the output data vector [len].
// scaleFactor Scalefactor value.
// len Number of elements in the input and output
// vectors.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSrc or pDst pointer
// is NULL.
// ippStsMisalignedBuf Indicates misaligned data. Supply aligned data
// for better performance.
// ippStsSizeErr Indicates an error when len is less than or
// equal to 0.
*/
IPPAPI(IppStatus, ippsPow34_16s_Sfs,(const Ipp16s* pSrc, int inScaleFactor, Ipp16s* pDst, int ScaleFactor, int len))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsCalcSF_16s32f
//
// Purpose:
// Restores actual scale factors from the bit stream values.
//
// Parameters:
// pSrc Pointer to the input data array.
// offset Scale factors offset.
// pDst Pointer to the output data array.
// len Number of elements in the vector.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSrc or pDst pointer
// is NULL.
// ippStsSizeErr Indicates an error when len is less than or
// equal to 0.
*/
IPPAPI(IppStatus,ippsCalcSF_16s32f, (const Ipp16s* pSrc, int offset,Ipp32f *pDst, int len))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsScale_32f_I
//
// Purpose:
// Applies scale factors to spectral bands in accordance with spectral
// bands boundaries.
//
// Parameters:
// pSrcDst Pointer to the input and output data array. The
// size of array must be not less than pBandOffset[
// bands_number].
// pSF Pointer to the data array containing scale
// factors. The size of the array must be not less
// than bands_number.
// pBandOffset Pointer to the vector of band offsets. The size
// of array must be not less than bands_number + 1.
// bandsNumber Number of bands to which scale factors are
// applied.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pSrcDst or
// pBandsOffset pointer is NULL.
// ippStsSizeErr Indicates an error when bandsNumber is less than
// or equal to 0.
*/
IPPAPI(IppStatus, ippsScale_32f_I, (Ipp32f* pSrcDst, Ipp32f* pSF, const Ipp32s* pBandOffset, int bandsNumber))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMakeFloat_16s32f
//
// Purpose:
// Converts mantissa and exponent arrays to float arrays.
//
// Parameters:
// inmant Array of mantissas.
// inexp Array of exponents.
// size Number of array elements.
// outfloat Array of resulting float arrays.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the inmant, inexp or
// outfloat pointer is NULL.
// ippStsSizeErr Indicates an error when size is less than or
// equal to 0.
*/
IPPAPI(IppStatus, ippsMakeFloat_16s32f, (Ipp16s* inmant, Ipp16s* inexp, Ipp32s size, Ipp32f* outfloat))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVQCodeBookInitAlloc_32f
//
// Purpose:
// Creates and initializes the codebook structure.
//
// Parameters:
// pInputTable Pointer to the codebook table of the size step *
// height containing height quantization vectors of
// the length step.
// ppCodeBook Pointer to pointer to the codebook structure to
// be created.
// step Step to the next line in the table InputTable,
// quantization vector length.
// height Table height, number of quantization vectors.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when ppCodeBook or
// pInputTable pointer is NULL.
// ippStsSizeErr Indicates an error when the step or height is
// less than or equal to 0.
// ippStsMemAllocErr Indicates an error when no memory is allocated.
*/
IPPAPI(IppStatus, ippsVQCodeBookInitAlloc_32f, (const Ipp32f* pInputTable, IppsVQCodeBookState_32f** ppCodeBooks, int step, int height))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVQCodeBookFree_32f
//
// Purpose:
// Closes the IppsVQCodeBookState_32f structure created by the function
// ippsVQCodeBookInitAlloc.
//
// Parameters:
// pCodeBook Pointer to specified IppsVQCodeBookState_32f
// structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pCodeBook pointer is
// NULL.
*/
IPPAPI(IppStatus, ippsVQCodeBookFree_32f, (IppsVQCodeBookState_32f* pCodeBook))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVQCodeBookInit_32f
//
// Purpose:
// Initializes the codebook structure.
//
// Parameters:
// pInputTable Pointer to the codebook table of the size step *
// height containing height quantization vectors of
// the length step.
// ppCodeBook Pointer to pointer to the codebook structure to
// be created.
// step Step to the next line in the table InputTable,
// quantization vector length.
// height Table height, number of quantization vectors.
// pMemSpec Pointer to the area for the codebook structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pInputTable, ppCodeBook
// or pMemSpec pointer is NULL.
// ippStsSizeErr Indicates an error when the step or height is
// less than or equal to 0.
*/
IPPAPI(IppStatus, ippsVQCodeBookInit_32f, (const Ipp32f* pInputTable, IppsVQCodeBookState_32f** ppCodeBook , int step, int height, Ipp8u* pMemSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVQPreliminarySelect_32f
//
// Purpose:
// Selects candidates for the nearest code vector of codebooks.
//
// Parameters:
// pSrc Source vector to be quantized.
// pWeights Pointer to the vector of weights.
// nDiv Number of fragmentations of the src and weights
// vectors.
// pLengths Pointer to an array of lengths of fragmentations.
// pIndx Pointer to the output vector of indexes of the
// nCand minimum candidates.
// pSign Pointer to the output vector of signs of nCand
// minimum candidates: - The value of 1 indicates
// that the minimal distortion appears when the
// norm is negative; - The value of 0 indicates
// that the minimal distortion appears when the
// norm is positive.
// nCand Number of output candidates.
// pPolbits Pointer to the polbits flag vector.
// pCodeBook Pointer to the specified IppsVQCodeBookState_32f
// structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pCodeBook or pSrc
// pointer is NULL.
*/
IPPAPI(IppStatus, ippsVQPreliminarySelect_32f, (const Ipp32f* pSrc, const Ipp32f* pWeights, int nDiv, const Ipp32s* pLengths, Ipp32s* pIndx, Ipp32s* pSign, int nCand, int* polbits, IppsVQCodeBookState_32f* pCodeBook))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVQMainSelect_32f
//
// Purpose:
// Finds optimal indexes with minimal distortion.
//
// Parameters:
// pSrc Source vector to be quantized.
// pWeights Pointer to the vector of weights.
// nDiv Number of fragmentations of the src and weights
// vectors.
// pLengths Pointer to an array of lengths of fragmentations.
// nCand Number of input candidates.
// ppIndexCand Pointer to pointer to the input vectors of
// indexes of nCand minimum candidates.
// ppSignCand Pointer to pointer to the input vectors of signs
// of nCand minimum candidates.
// ppIndx Pointer to pointer to the output vectors of
// indexes.
// ppSign Pointer to pointer to the output vectors of signs.
// ppCodeBooks Pointer to pointer to the specified
// IppsVQCodeBookState_32f structures.
// nCodeBooks Number of codebooks.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
*/
IPPAPI(IppStatus, ippsVQMainSelect_32f, (const Ipp32f* pSrc, const Ipp32f* pWeights, const Ipp32s* pLengths, int nDiv, int nCand, Ipp32s** ppIndexCand, Ipp32s** ppSignCand, Ipp32s** ppIndx, Ipp32s** ppSign, IppsVQCodeBookState_32f** ppCodeBooks, int nCodeBooks))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVQIndexSelect_32f
//
// Purpose:
// Finds optimal vector set for specified number of codebooks.
//
// Parameters:
// pSrc Source vector to be quantized.
// pWeights Pointer to the vector of weights.
// nDiv Number of fragmentations of the src and weights
// vectors.
// pLengths Pointer to an array of lengths of fragmentations.
// nCand Number of input candidates.
// ppPolbits Indicates whether one or two norms should be
// used to compute the optimal vector set for the
// specified number of codebooks.
// ppIndx Pointer to pointer to the output vectors of
// indexes.
// ppSign Pointer to pointer to the output vectors of signs.
// - The value of 1 indicates that the minimal
// distortion appears when the norm is negative.
// - The value of 0 indicates that the minimal
// distortion appears when the norm is positive.
// ppCodeBooks Pointer to pointer to the specified
// IppsVQCodeBookState_32f structures.
// nCodeBooks Number of codebooks.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
*/
IPPAPI(IppStatus, ippsVQIndexSelect_32f, (const Ipp32f* pSrc, const Ipp32f* pWeights, int nDiv, const Ipp32s* pLengths, int nCand, int** ppPolbits, Ipp32s** ppIndx, Ipp32s** ppSign, IppsVQCodeBookState_32f** ppCodeBooks, int nCodeBooks))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVQReconstruction_32f
//
// Purpose:
// Reconstructs vectors from indexes.
//
// Parameters:
// ppIndx Pointer to pointer to an array of input vectors
// of indexes for each codebook.
// ppSign Pointer to pointer to an array of input vectors
// of signs for each codebook containing either 1
// or -1.
// pLengths Pointer to an array of lengths of partitions of
// output vector.
// pDst Pointer to the reconstructed vector of spectrum
// values.
// nDiv Number of partitions of output vector.
// ppCodeBooks Pointer to pointer to an array of pointers to
// specified IppsVQCodeBookState_32f structures.
// nCodeBooks Number of codebooks.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
*/
IPPAPI(IppStatus, ippsVQReconstruction_32f, (const Ipp32s** ppIndx, const Ipp32s** ppSign, const Ipp32s* pLength, int nDiv, int nStream, Ipp32f* pDst, IppsVQCodeBookState_32f** ppCodeBooks))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVQCodeBookGetSize_32f
//
// Purpose:
// Gets the size of the codebook structure.
//
// Parameters:
// step Step to the next line in the codebook table,
// quantization vector length.
// height Table height, number of quantization vectors.
// pSizeState Address of the codebook structure size value in
// bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pSizeState pointer is
// NULL.
// ippStsSizeErr Indicates an error when the step or height is
// less than or equal to 0.
*/
IPPAPI(IppStatus, ippsVQCodeBookGetSize_32f, (int step, int height, int *pSizeState))
/****************************************************************************
* MPEG4-SBR AUDIO
****************************************************************************/
/*
// DECODER PART
*/
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterGetSize_SBR_RToC_32f,
// ippsAnalysisFilterGetSize_SBR_RToC_32f32fc,
// ippsAnalysisFilterGetSize_SBR_RToR_32f,
// ippsSynthesisFilterGetSize_SBR_CToR_32f,
// ippsSynthesisFilterGetSize_SBR_CToR_32fc32f,
// ippsSynthesisFilterGetSize_SBR_RToR_32f
// ippsSynthesisDownFilterGetSize_SBR_CToR_32f,
// ippsSynthesisDownFilterGetSize_SBR_CToR_32fc32f,
// ippsSynthesisDownFilterGetSize_SBR_RToR_32f
//
// Purpose:
// Returns size of QMF specification structures, init and work buffers.
//
// Parameters:
// pSizeSpec Address of the FilterSpec_SBR specification
// structure size value in bytes.
// pSizeInitBuf Address size of the buffer for initialization
// functions in bytes.
// pSizeWorkBuf Address of the work buffer size value in bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
*/
IPPAPI( IppStatus, ippsAnalysisFilterGetSize_SBR_RToC_32f, ( int* pSizeSpec, int* pSizeInitBuf, int* pSizeWorkBuf ))
IPPAPI( IppStatus, ippsAnalysisFilterGetSize_SBR_RToC_32f32fc, ( int* pSizeSpec, int* pSizeInitBuf, int* pSizeWorkBuf ))
IPPAPI( IppStatus, ippsAnalysisFilterGetSize_SBR_RToR_32f, ( int* pSizeSpec, int* pSizeInitBuf, int* pSizeWorkBuf ))
IPPAPI( IppStatus, ippsSynthesisFilterGetSize_SBR_CToR_32f, ( int* pSizeSpec, int* pSizeInitBuf, int* pSizeWorkBuf ))
IPPAPI(IppStatus, ippsSynthesisFilterGetSize_SBR_CToR_32fc32f, ( int* pSizeSpec, int* pSizeInitBuf, int* pSizeWorkBuf ))
IPPAPI( IppStatus, ippsSynthesisFilterGetSize_SBR_RToR_32f, ( int* pSizeSpec, int* pSizeInitBuf, int* pSizeWorkBuf ))
IPPAPI( IppStatus, ippsSynthesisDownFilterGetSize_SBR_CToR_32f, ( int* pSizeSpec, int* pSizeInitBuf, int* pSizeWorkBuf ))
IPPAPI( IppStatus, ippsSynthesisDownFilterGetSize_SBR_CToR_32fc32f, ( int* pSizeSpec, int* pSizeInitBuf, int* pSizeWorkBuf ))
IPPAPI( IppStatus, ippsSynthesisDownFilterGetSize_SBR_RToR_32f, ( int* pSizeSpec, int* pSizeInitBuf, int* pSizeWorkBuf ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterInit_SBR_RToC_32f
//
// Purpose:
// Initializes analysis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the FilterSpec_SBR
// specification structure is written. Onlt the
// main function uses this structure.
// pMemSpec Pointer to the area for the FilterSpec_SBR
// specification structure.
// pInitBuf Pointer to the Init buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsAnalysisFilterInit_SBR_RToC_32f,
( IppsFilterSpec_SBR_C_32f** ppFilterSpec, Ipp8u* pMemSpec, Ipp8u* pInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterInit_SBR_CToR_32fc32f
//
// Purpose:
// Initializes analysis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the FilterSpec_SBR
// specification structure is written. Onlt the
// main function uses this structure.
// pMemSpec Pointer to the area for the FilterSpec_SBR
// specification structure.
// pInitBuf Pointer to the Init buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsSynthesisFilterInit_SBR_CToR_32fc32f,
( IppsFilterSpec_SBR_C_32fc** ppFilterSpec, Ipp8u* pMemSpec, Ipp8u* pInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterInit_SBR_RToC_32f32fc
//
// Purpose:
// Initializes analysis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the FilterSpec_SBR
// specification structure is written. Onlt the
// main function uses this structure.
// pMemSpec Pointer to the area for the FilterSpec_SBR
// specification structure.
// pInitBuf Pointer to the Init buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsAnalysisFilterInit_SBR_RToC_32f32fc,
( IppsFilterSpec_SBR_C_32fc** ppFilterSpec, Ipp8u* pMemSpec, Ipp8u* pInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterInit_SBR_RToR_32f
//
// Purpose:
// Initializes analysis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the FilterSpec_SBR
// specification structure is written. Onlt the
// main function uses this structure.
// pMemSpec Pointer to the area for the FilterSpec_SBR
// specification structure.
// pInitBuf Pointer to the Init buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsAnalysisFilterInit_SBR_RToR_32f,
( IppsFilterSpec_SBR_R_32f** ppFilterSpec, Ipp8u* pMemSpec, Ipp8u* pInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterInit_SBR_CToR_32fc32f
//
// Purpose:
// Initializes synthesis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the FilterSpec_SBR
// specification structure is written. Onlt the
// main function uses this structure.
// pMemSpec Pointer to the area for the FilterSpec_SBR
// specification structure.
// pInitBuf Pointer to the Init buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsSynthesisFilterInit_SBR_CToR_32f,
( IppsFilterSpec_SBR_C_32f** ppFilterSpec, Ipp8u* pMemSpec, Ipp8u* pInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterInit_SBR_RToR_32f
//
// Purpose:
// Initializes synthesis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the FilterSpec_SBR
// specification structure is written. Onlt the
// main function uses this structure.
// pMemSpec Pointer to the area for the FilterSpec_SBR
// specification structure.
// pInitBuf Pointer to the Init buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsSynthesisFilterInit_SBR_RToR_32f,
( IppsFilterSpec_SBR_R_32f** ppFilterSpec, Ipp8u* pMemSpec, Ipp8u* pInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisDownFilterInit_SBR_CToR_32f
//
// Purpose:
// Initializes synthesis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the FilterSpec_SBR
// specification structure is written. Onlt the
// main function uses this structure.
// pMemSpec Pointer to the area for the FilterSpec_SBR
// specification structure.
// pInitBuf Pointer to the Init buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsSynthesisDownFilterInit_SBR_CToR_32f,
( IppsFilterSpec_SBR_C_32f** ppFilterSpec, Ipp8u* pMemSpec, Ipp8u* pInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisDownFilterInit_SBR_CToR_32fc32f
//
// Purpose:
// Initializes down sample synthesis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the FilterSpec_SBR
// specification structure is written. Onlt the
// main function uses this structure.
// pMemSpec Pointer to the area for the FilterSpec_SBR
// specification structure.
// pInitBuf Pointer to the Init buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsSynthesisDownFilterInit_SBR_CToR_32fc32f,
( IppsFilterSpec_SBR_C_32fc** ppFilterSpec, Ipp8u* pMemSpec, Ipp8u* pInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisDownFilterInit_SBR_RToR_32f
//
// Purpose:
// Initializes down sample synthesis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the FilterSpec_SBR
// specification structure is written. Onlt the
// main function uses this structure.
// pMemSpec Pointer to the area for the FilterSpec_SBR
// specification structure.
// pInitBuf Pointer to the Init buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsSynthesisDownFilterInit_SBR_RToR_32f,
( IppsFilterSpec_SBR_R_32f** ppFilterSpec, Ipp8u* pMemSpec, Ipp8u* pInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilter_SBR_RToC_32f_D2L
// ippsAnalysisFilter_SBR_RToC_32f32fc_D2L
// ippsAnalysisFilter_SBR_RToR_32f_D2L
//
// Purpose:
// Splits time domain signal output from the core decoder into 32
// subband signals.
//
// Parameters:
// pSrc Pointer to the input audio signal.
// pDst array of pointers, holds subband samples.
// pDstRe array of pointers that contains real parts of subband samples.
// pDstIm array of pointers that contains imaginary parts of subband
// samples.
// pSbrTableWindowDown Pointer to the window table that is used by decoder SBR Analysis Filter.
// offset Desired displacement in number of rows when the matrix pDst is calculated. offset >=0
// NumLoop Parameter equal to 32 if frame size of the core decoded signal is 1024
// 30 if frame size of the core decoded signal is 960.
// kx first SBR subband in the SBR range.
// pFilterSpec Pointer to the FilterSpec_SBR specification structure.
// pWorkBuf Pointer to the work buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsAnalysisFilter_SBR_RToC_32f_D2L,
(const Ipp32f* pSrc, Ipp32f* pDstRe[], Ipp32f* pDstIm[], const Ipp32f* pSbrTableWinDown,
int NumLoop, int offset, int kx,
const IppsFilterSpec_SBR_C_32f* pFilterSpec, Ipp8u* pWorkBuf))
IPPAPI( IppStatus, ippsAnalysisFilter_SBR_RToC_32f32fc_D2L,
(const Ipp32f* pSrc, Ipp32fc* pDst[], const Ipp32f* pSbrTableWinDown,
int NumLoop, int offset, int kx,
const IppsFilterSpec_SBR_C_32fc* pFilterSpec, Ipp8u* pWorkBuf))
IPPAPI( IppStatus, ippsAnalysisFilter_SBR_RToR_32f_D2L,
(const Ipp32f* pSrc, Ipp32f* pDst[], const Ipp32f* pSbrTableWinDown,
int NumLoop, int offset, int kx,
const IppsFilterSpec_SBR_R_32f* pFilterSpec, Ipp8u* pWorkBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilter_SBR_CToR_32f_D2L
// ippsSynthesisFilter_SBR_CToR_32fc32f_D2L
// ippsSynthesisFilter_SBR_RToR_32f_D2L
//
// Purpose:
// Transforms SBR-processed subband signals into time domain samples.
//
// Parameters:
// pSrc - array of pointers, holds SBR-processed subband signals.
// pSrcRe - array of pointers that contains real parts of SBR-processed subband signals.
// pSrcIm - array of pointers that contains imaginary parts of SBR-processed subband signals.
// pDst - Pointer to the output vector, holds time domain output samples.
// pSbrTableWindow - Pointer to the window table that is used by SBR Analysis Filter.
// NumLoop - Parameter equal to 32 if frame size of the core decoded signal is 1024
// 30 if frame size of the core decoded signal is 960.
// pFilterSpec- Pointer to the FilterSpec_SBR specification structure.
// pWorkBuf - Pointer to the work buffer used by the filter.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI( IppStatus, ippsSynthesisFilter_SBR_CToR_32f_D2L,
(const Ipp32f* pSrcRe[], const Ipp32f* pSrcIm[], Ipp32f* pDst, const Ipp32f* pSbrTableWindow,
int NumLoop, const IppsFilterSpec_SBR_C_32f* pFilterSpec, Ipp8u* pWorkBuf))
IPPAPI( IppStatus, ippsSynthesisFilter_SBR_CToR_32fc32f_D2L,
(const Ipp32fc* pSrc[], Ipp32f* pDst, const Ipp32f* pSbrTableWindow, int NumLoop,
const IppsFilterSpec_SBR_C_32fc* pFilterSpec, Ipp8u* pWorkBuf ))
IPPAPI( IppStatus, ippsSynthesisFilter_SBR_RToR_32f_D2L,
(const Ipp32f* pSrc[], Ipp32f* pDst, const Ipp32f* pSbrTableWindow, int NumLoop,
const IppsFilterSpec_SBR_R_32f* pFilterSpec, Ipp8u* pWorkBuf ))
/* ///////////////////////////////////////////////////////////////////////////
// Name: ippsSynthesisDownFilter_SBR_CToR_32f_D2L, ippsSynthesisDownFilter_SBR_CToR_32fc32f_D2L, ippsSynthesisDownFilter_SBR_RToR_32f_D2L
// Purpose: Transforms SBR-processed subband signals into time domain samples and
// performs downsampling at the same time.
//
// Parameters:
// pSrc - array of pointers, holds SBR-processed subband signals.
// pSrcRe - array of pointers that contains real parts of SBR-processed subband signals.
// pSrcIm - array of pointers that contains imaginary parts of SBR-processed subband signals.
// pDst - Pointer to the output vector, holds time domain output samples.
// pSbrTableWindowDown - Pointer to the window table that is used by SBR Analysis Filter.
// NumLoop- Parameter equal to 32 if frame size of the core decoded signal is 1024
// 30 if frame size of the core decoded signal is 960.
// pFilterSpec - Pointer to the FilterSpec_SBR specification structure.
// pWorkBuf - Pointer to the work buffer used by the filter.
//
// Return Values: status
*/
IPPAPI( IppStatus, ippsSynthesisDownFilter_SBR_CToR_32f_D2L,
(const Ipp32f* pSrcRe[],const Ipp32f* pSrcIm[], Ipp32f* pDst,
const Ipp32f* pSbrTableWindowDown, int NumLoop,
const IppsFilterSpec_SBR_C_32f* pFilterSpec, Ipp8u* pWorkBuf ))
IPPAPI( IppStatus, ippsSynthesisDownFilter_SBR_CToR_32fc32f_D2L,
(const Ipp32fc* pSrc[], Ipp32f* pDst, const Ipp32f* pSbrTableWindowDown, int NumLoop,
const IppsFilterSpec_SBR_C_32fc* pFilterSpec, Ipp8u* pWorkBuf ))
IPPAPI( IppStatus, ippsSynthesisDownFilter_SBR_RToR_32f_D2L,
(const Ipp32f* pSrc[], Ipp32f* pDst, const Ipp32f* pSbrTableWindowDown, int NumLoop,
const IppsFilterSpec_SBR_R_32f* pFilterSpec, Ipp8u* pWorkBuf ))
/* ///////////////////////////////////////////////////////////////////////////
// Name: ippsPredictCoef_SBR_R_32f_D2L, ippsPredictCoef_SBR_C_32fc_D2L, ippsPredictCoef_SBR_C_32f_D2L
// Purpose: Obtains prediction filter coefficients using covariance method.
//
// Parameters:
// pSrc - array of pointers holds input real or complex matrix ([40][32]),
// holds Low Frequency QMF-processed subband signals.
// pSrcRe - array of pointers ([40][32]) that contains real
// parts of Low Frequency SBR-processed subband signals.
// pSrcIm - array of pointers ([40][32]) that contains
// imaginary parts of Low Frequency SBR-processed subband signals.
// k0 - First QMF subband in the f_master table.
// len - Size autocorrelation.
// pAlpha0, pAlpha1 - Pointers to the arrays that contain complex
// or real Prediction filter coefficients used by High Frequency filter.
// pAlpha0Re, pAlpha1Re - Pointers to the arrays that contain real parts of the
// corresponding complex filter coefficients.
// pAlpha0Im, pAlpha1Im - Pointers to the arrays that contain imaginary parts of the
// corresponding complex filter coefficients.
//
// Return Values: status
*/
IPPAPI( IppStatus, ippsPredictCoef_SBR_R_32f_D2L,
(const Ipp32f* pSrc[], Ipp32f* pAlpha0, Ipp32f* pAlpha1, int k0, int len))
IPPAPI( IppStatus, ippsPredictCoef_SBR_C_32fc_D2L,
(const Ipp32fc* pSrc[], Ipp32fc* pAlpha0, Ipp32fc* pAlpha1, int k0, int len))
IPPAPI( IppStatus, ippsPredictCoef_SBR_C_32f_D2L,
(const Ipp32f* pSrcRe[], const Ipp32f* pSrcIm[],
Ipp32f* pAlpha0Re, Ipp32f* pAlpha0Im,
Ipp32f* pAlpha1Re, Ipp32f* pAlpha1Im,
int k0, int len))
IPPAPI( IppStatus, ippsPredictOneCoef_SBRHQ_32sc_D2L,
(const Ipp32sc* pSrc[], Ipp32sc* pAlpha0, Ipp32sc* pAlpha1, int k, int lenCorr))
IPPAPI( IppStatus, ippsPredictOneCoef_SBRLP_32s_D2L,
(const Ipp32s* pSrc[], Ipp32s* pAlpha0, Ipp32s* pAlpha1,
Ipp32s* pRefCoef, int k, int lenCorr, int flag))
/****************************************************************************
* FIXED-POINT VERSION
*
*
****************************************************************************/
/* <-------------------- HQ MODE --------------------------> */
/* GET SIZE */
IPPAPI( IppStatus, ippsAnalysisFilterGetSize_SBRHQ_32s32sc, ( int* pSizeSpec ))
IPPAPI( IppStatus, ippsSynthesisFilterGetSize_SBRHQ_32sc32s, ( int* pSizeSpec ))
IPPAPI( IppStatus, ippsSynthesisDownFilterGetSize_SBRHQ_32sc32s, ( int* pSizeSpec))
/* INIT */
IPPAPI( IppStatus, ippsAnalysisFilterInit_SBRHQ_32s32sc,
( IppsFilterSpec_SBR_C_32sc* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisFilterInit_SBRHQ_32sc32s,
( IppsFilterSpec_SBR_C_32sc* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisDownFilterInit_SBRHQ_32sc32s,
( IppsFilterSpec_SBR_C_32sc* pFilterSpec))
/* INITALLOC */
IPPAPI( IppStatus, ippsAnalysisFilterInitAlloc_SBRHQ_32s32sc,
( IppsFilterSpec_SBR_C_32sc** ppFilterSpec))
IPPAPI( IppStatus, ippsSynthesisFilterInitAlloc_SBRHQ_32sc32s,
( IppsFilterSpec_SBR_C_32sc** ppFilterSpec))
IPPAPI( IppStatus, ippsSynthesisDownFilterInitAlloc_SBRHQ_32sc32s,
( IppsFilterSpec_SBR_C_32sc** ppFilterSpec))
/* FREE */
IPPAPI( IppStatus, ippsAnalysisFilterFree_SBRHQ_32s32sc,
( IppsFilterSpec_SBR_C_32sc* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisFilterFree_SBRHQ_32sc32s,
( IppsFilterSpec_SBR_C_32sc* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisDownFilterFree_SBRHQ_32sc32s,
( IppsFilterSpec_SBR_C_32sc* pFilterSpec))
/* MAIN */
IPPAPI( IppStatus, ippsAnalysisFilter_SBRHQ_32s32sc,
(const Ipp32s* pSrc, Ipp32sc* pDst,int kx,
const IppsFilterSpec_SBR_C_32sc* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisFilter_SBRHQ_32sc32s,
(const Ipp32sc* pSrc, Ipp32s* pDst,
const IppsFilterSpec_SBR_C_32sc* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisDownFilter_SBRHQ_32sc32s,
(const Ipp32sc* pSrc, Ipp32s* pDst,
const IppsFilterSpec_SBR_C_32sc* pFilterSpec ))
/* <-----------------------LP MODE -----------------------> */
/* GET SIZE */
IPPAPI( IppStatus, ippsAnalysisFilterGetSize_SBRLP_32s, ( int* pSizeSpec ))
IPPAPI( IppStatus, ippsSynthesisFilterGetSize_SBRLP_32s, ( int* pSizeSpec ))
IPPAPI( IppStatus, ippsSynthesisDownFilterGetSize_SBRLP_32s, ( int* pSizeSpec ))
/* INIT */
IPPAPI( IppStatus, ippsAnalysisFilterInit_SBRLP_32s,
( IppsFilterSpec_SBR_R_32s* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisFilterInit_SBRLP_32s,
( IppsFilterSpec_SBR_R_32s* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisDownFilterInit_SBRLP_32s,
( IppsFilterSpec_SBR_R_32s* pFilterSpec))
/* INITALLOC */
IPPAPI( IppStatus, ippsAnalysisFilterInitAlloc_SBRLP_32s,
( IppsFilterSpec_SBR_R_32s** ppFilterSpec))
IPPAPI( IppStatus, ippsSynthesisFilterInitAlloc_SBRLP_32s,
( IppsFilterSpec_SBR_R_32s** ppFilterSpec))
IPPAPI( IppStatus, ippsSynthesisDownFilterInitAlloc_SBRLP_32s,
( IppsFilterSpec_SBR_R_32s** ppFilterSpec))
/* FREE */
IPPAPI( IppStatus, ippsAnalysisFilterFree_SBRLP_32s,
( IppsFilterSpec_SBR_R_32s* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisFilterFree_SBRLP_32s,
( IppsFilterSpec_SBR_R_32s* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisDownFilterFree_SBRLP_32s,
( IppsFilterSpec_SBR_R_32s* pFilterSpec))
/* MAIN */
IPPAPI( IppStatus, ippsAnalysisFilter_SBRLP_32s,
(const Ipp32s* pSrc, Ipp32s* pDst,int kx,
const IppsFilterSpec_SBR_R_32s* pFilterSpec))
IPPAPI( IppStatus, ippsSynthesisFilter_SBRLP_32s,
(const Ipp32s* pSrc, Ipp32s* pDst,
const IppsFilterSpec_SBR_R_32s* pFilterSpec ))
IPPAPI( IppStatus, ippsSynthesisDownFilter_SBRLP_32s,
(const Ipp32s* pSrc, Ipp32s* pDst,
const IppsFilterSpec_SBR_R_32s* pFilterSpec ))
/*
// ENCODER PART
*/
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterEncGetSize_SBR_32f
//
// Purpose:
// Returns size of FilterSpec_SBR specification structures & init buffer.
//
// Parameters:
// pSizeSpec Address of the FilterSpec_SBR specification
// structure size value in bytes.
// pSizeInitBuf Address size of the buffer for initialization
// functions in bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
*/
IPPAPI(IppStatus, ippsAnalysisFilterEncGetSize_SBR_32f,
(int *pSizeSpec,
int *pSizeInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterInitEnc_SBR_32f
//
// Purpose:
// Initializes analysis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to FilterSpec_SBR specification structure
//
// pInitBuf Pointer to the Init buffer.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
// ippStsContextMatchErr Indicates an error when the identifier pFilterSpec is
// incorrect.
*/
IPPAPI(IppStatus, ippsAnalysisFilterEncInit_SBR_32f,
(IppsFilterSpec_SBR_C_32fc *ppFilterSpec,
Ipp8u *pInitBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterEncInitAlloc_SBR_32f
//
// Purpose:
// Allocate memory for analysis specification structure and initializes it.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the IppsFilterSpec_SBR
// specification structure is written.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when ppFilterSpec is NULL.
*/
IPPAPI(IppStatus, ippsAnalysisFilterEncInitAlloc_SBR_32f, (IppsFilterSpec_SBR_C_32f **ppFilterSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterEncFree_SBR_32f
//
// Purpose:
// Frees memory allocated for internal IppsFilterSpec_SBR structure.
//
// Parameters:
// pFilterSpec Pointer to the IppsFilterSpec_SBR specification
// structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pFilterSpec is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI(IppStatus, ippsAnalysisFilterEncFree_SBR_32f, (IppsFilterSpec_SBR_C_32f *pFilterSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterEnc_SBR_32f32fc
//
// Purpose:
// Splits time domain signal output from the core decoder into 32 subband
// signals.
//
// Parameters:
// pSrc Pointer to the input audio signal.
//
// pDst Pointer to the output signal
//
// pFilterSpec Pointer to the FilterSpec_SBR specification
// structure.
//
// Returns:
// ippStsNoErr Indicates no error.
//
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
//
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI(IppStatus, ippsAnalysisFilterEnc_SBR_32f32fc,
(const Ipp32f *pSrc,
Ipp32fc *pDst,
const IppsFilterSpec_SBR_C_32f *pFilterSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDetectTransient_SBR_32f
//
// Purpose:
// Transient detection is done by function.
//
// Parameters:
// pSrc pointer to the vector which stores the spectrum component of audio signal.
//
// pInOutThr Pointer to the threshold of deviation.
//
// pDst pointer to the transient threshold
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
*/
IPPAPI( IppStatus, ippsDetectTransient_SBR_32f, (const Ipp32f* pSrc, Ipp32f* pInOutThr, Ipp32f* pDst))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsEstimateTNR_SBR_32f
//
// Purpose:
// Function estimates Tonality-To-Noise Ratio of audio signal.
//
// Parameters:
// pSrc pointer to the vector which stores the spectrum component of audio signal
//
// pTNR0 Pointer to first estimation of TNR.
//
// pTNR1 Pointer to second estimation of TNR
//
// pMeanNrg pointer
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
*/
IPPAPI( IppStatus, ippsEstimateTNR_SBR_32f, (const Ipp32fc* pSrc, Ipp32f* pTNR0, Ipp32f* pTNR1, Ipp32f* pMeanNrg))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsUnpackFrameHeader_MP3
//
// Purpose:
// Unpacks audio frame header.
//
// Parameters:
// ppBitStream Pointer to the pointer to the first byte of the
// MP3 frame header (*ppBitstream will be updated
// in the function).
// pFrameHeader Pointer to the MP3 frame header structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when ppBitStreamp or
// FrameHeader is NULL.
*/
IPPAPI( IppStatus, ippsAnalysisFilter_PS_32fc_D2, (const Ipp32fc* pSrc, Ipp32fc ppDst[32][12],
IppAC_PS_DEC_ANALYSIS config))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilter_PS_32fc_D2
//
// Purpose:
// Increases frequency resolution of the first few lower subbands by hybrid filtering
//
// Parameters:
// pSrc Pointer to the lower QMF subband
// ppDst Output matrix, contains hybrid subband samples
// config flag describing configuration of hybrid filtering
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the specified pointers is NULL.
// ippStsBadArgErr Indicates an error when config isn't correct
*/
IPPAPI(IppStatus, ippsUnpackFrameHeader_MP3, (
Ipp8u** ppBitStream,
IppMP3FrameHeader* pFrameHeader))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsUnpackSideInfo_MP3
//
// Purpose:
// Unpacks side information from input bitstream for use during decoding
// of associated frame.
//
// Parameters:
// ppBitStream Pointer to the pointer to the first byte of the
// side information associated with the current
// frame in the bit stream buffer. The function
// updates this parameter.
// pFrameHeader Pointer to the structure that contains the
// unpacked MP3 frame header. The header structure
// provides format information about the input
// bitstream. Both single- and dual-channel MPEG-1
// and MPEG-2 modes are supported.
// pDstSideInfo Pointer to the MP3 side information structure.
// The structure contains side information that
// applies to all granules and all channels for the
// current frame. One or more of the structures are
// placed contiguously in the buffer pointed to by
// pDstSideInfo in the following order:
// {granule 0 (channel 0, channel 1), granule 1 (channel
// channel 1)}.
// pDstMainDataBegin Pointer to the main_data_begin field.
// pDstPrivateBits Pointer to the private bits field.
// pDstScfsi Pointer to the scale factor selection
// information associated with the current frame.
// The data is organized contiguously in the buffer
// pointed to by pDstScfsi in the following order:
// {channel 0 (scfsi_band 0, scfsi_band 1, ...,
// scfsi_band 3), channel 1 (scfsi_band 0,
// scfsi_band 1, ..., [, fsi_band 3)}.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pDstSideInfo,
// pDstMainDataBegin, pDstPrivateBits, pDstScfsi,
// pFrameHeader, or ppBitStream is NULL.
// ippStsMP3FrameHeaderErr Indicates an error when some elements in the
// MP3 frame header structure are invalid:
// pFrameHeader->id != IPP_MP3_ID_MPEG1
// pFrameHeader->id != IPP_MP3_ID_MPEG2
// pFrameHeader->layer != 1 pFrameHeader->mode < 0
// pFrameHeader->mode > 3.
// ippStsMP3SideInfoErr Indicates an error when the value of block_type
// is zero when window_switching_flag is set.
*/
IPPAPI(IppStatus, ippsUnpackSideInfo_MP3, (
Ipp8u** ppBitStream,
IppMP3SideInfo* pDstSideInfo,
int* pDstMainDataBegin,
int* pDstPrivateBits,
int* pDstScfsi,
IppMP3FrameHeader* pFrameHeader))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsUnpackScaleFactors_MP3_1u8s
//
// Purpose:
// Unpacks scalefactors.
//
// Parameters:
// ppBitStream Pointer to the pointer to the first bitstream
// buffer byte associated with the scale factors
// for the current frame, granule, and channel. The
// function updates this parameter.
// pOffSet Pointer to the next bit in the byte referenced by *
// ppBitStream. Valid within the range of 0 to 7,
// where 0 corresponds to the most significant bit
// and 7 corresponds to the least significant bit.
// The function updates this parameter.
// pDstScaleFactor Pointer to the scalefactor vector for long and/
// or short blocks.
// pSideInfo Pointer to the MP3 side information structure
// associated with the current granule and channel.
// pScfsi Pointer to scale factor selection information
// for the current channel.
// pFrameHeader Pointer to MP3 frame header structure for the
// current frame.
// granule Granule index. Can take the values
// of either 0 or 1.
// channel Channel index. Can take the values of either 0
// or 1.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when ppBitStream, pOffset,
// pDstScaleFactor, pSideInfo, pScfsi, ppBitStream,
// or pFrameHeader is NULL.
*/
IPPAPI(IppStatus, ippsUnpackScaleFactors_MP3_1u8s, (
Ipp8u** ppBitStream,
int* pOffset,
Ipp8s* pDstScaleFactor,
IppMP3SideInfo* pSideInfo,
int* pScfsi,
IppMP3FrameHeader* pFrameHeader,
int granule,
int channel))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsHuffmanDecode_MP3_1u32s
//
// Purpose:
// Decodes Huffman data.
//
// Parameters:
// ppBitStream Pointer to the pointer to the first bit stream
// byte that contains the Huffman code words
// associated with the current granule and channel.
// The function updates this parameter.
// pOffset Pointer to the starting bit position in the bit
// stream byte pointed to by *ppBitStream.
// The parameter is valid within the
// range of 0 to 7, where 0 corresponds to the most
// significant bit, and 7 corresponds to the least
// significant bit. The function updates this
// parameter.
// pDstIs Pointer to the vector of decoded Huffman symbols
// used to compute the quantized values of the 576
// spectral coefficients associated with the
// current granule and channel.
// pDstNonZeroBound Pointer to the spectral region above which all
// coefficients are set to zero.
// pSideInfo Pointer to MP3 structure containing side
// information associated with the current granule
// and channel.
// pFrameHeader Pointer to MP3 structure containing the header
// associated with the current frame.
// hufSize The number of Huffman code bits associated with
// the current granule and channel.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pOffset, pDstIs,
// pDstNonZeroBound, pSideInfo, pFrameHeader, or
// ppBitStream is NULL or when pOffset < 0 or
// pOffset > 7.
// ippStsMP3FrameHeaderErr Indicates an error when some elements in the
// MP3 frame header structure are invalid.
// ippStsMP3SideInfoErr Indicates an error when some elements in the MP3
// side information structure are invalid or when
// hufSize < 0 or hufSize > pSideInfo->part23Len.
// ippStsErr Indicates unknown error.
*/
IPPAPI(IppStatus, ippsHuffmanDecode_MP3_1u32s, (
Ipp8u** ppBitStream,
int* pOffset,
Ipp32s* pDstIs,
int* pDstNonZeroBound,
IppMP3SideInfo* pSideInfo,
IppMP3FrameHeader* pFrameHeader,
int hufSize))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsHuffmanDecodeSfb_MP3_1u32s
//
// Purpose:
// Decodes Huffman data.
//
// Parameters:
// ppBitStream Pointer to the pointer to the first bit stream
// byte that contains the Huffman code words
// associated with the current granule and channel.
// The function updates this parameter.
// pOffset Pointer to the starting bit position in the bit
// stream byte pointed to by *ppBitStream.
// The parameter is valid within the
// range of 0 to 7, where 0 corresponds to the most
// significant bit, and 7 corresponds to the least
// significant bit. The function updates this
// parameter.
// pDstIs Pointer to the vector of decoded Huffman symbols
// used to compute the quantized values of the 576
// spectral coefficients associated with the
// current granule and channel.
// pDstNonZeroBound Pointer to the spectral region above which all
// coefficients are set to zero.
// pSideInfo Pointer to MP3 structure containing side
// information associated with the current granule
// and channel.
// pFrameHeader Pointer to MP3 structure containing the header
// associated with the current frame.
// hufSize The number of Huffman code bits associated with
// the current granule and channel.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pOffset, pDstIs,
// pDstNonZeroBound, pSideInfo, pFrameHeader, or
// ppBitStream is NULL or when pOffset < 0 or
// pOffset > 7.
// ippStsMP3FrameHeaderErr Indicates an error when some elements in the
// MP3 frame header structure are invalid.
// ippStsMP3SideInfoErr Indicates an error when some elements in the MP3
// side information structure are invalid or when
// hufSize < 0 or hufSize > pSideInfo->part23Len.
// ippStsErr Indicates unknown error.
*/
IPPAPI(IppStatus, ippsHuffmanDecodeSfb_MP3_1u32s, (
Ipp8u** ppBitStream,
int* pOffset,
Ipp32s* pDstIs,
int* pDstNonZeroBound,
IppMP3SideInfo* pSideInfo,
IppMP3FrameHeader* pFrameHeader,
int hufSize,
IppMP3ScaleFactorBandTableLong pSfbTableLong))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsHuffmanDecodeSfbMbp_MP3_1u32s
//
// Purpose:
// Decodes Huffman data.
//
// Parameters:
// ppBitStream Pointer to the pointer to the first bit stream
// byte that contains the Huffman code words
// associated with the current granule and channel.
// The function updates this parameter.
// pOffset Pointer to the starting bit position in the bit
// stream byte pointed to by *ppBitStream.
// The parameter is valid within the
// range of 0 to 7, where 0 corresponds to the most
// significant bit, and 7 corresponds to the least
// significant bit. The function updates this
// parameter.
// pDstIs Pointer to the vector of decoded Huffman symbols
// used to compute the quantized values of the 576
// spectral coefficients associated with the
// current granule and channel.
// pDstNonZeroBound Pointer to the spectral region above which all
// coefficients are set to zero.
// pSideInfo Pointer to MP3 structure containing side
// information associated with the current granule
// and channel.
// pFrameHeader Pointer to MP3 structure containing the header
// associated with the current frame.
// hufSize The number of Huffman code bits associated with
// the current granule and channel.
// pSfbTableLong Pointer to the scale factor bands table for a
// long block.
// pSfbTableShort Pointer to scale factor band table for short
// block. You can use the default table from
// MPEG-1, MPEG-2 standards.
// pMbpTable Pointer to the mixed block partition table.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pOffset, pDstIs,
// pDstNonZeroBound, pSideInfo, pFrameHeader, or
// ppBitStream is NULL or when pOffset < 0 or
// pOffset > 7.
// ippStsMP3FrameHeaderErr Indicates an error when some elements in the
// MP3 frame header structure are invalid.
// ippStsMP3SideInfoErr Indicates an error when some elements in the MP3
// side information structure are invalid or when
// hufSize < 0 or hufSize > pSideInfo->part23Len.
// ippStsErr Indicates unknown error.
*/
IPPAPI(IppStatus, ippsHuffmanDecodeSfbMbp_MP3_1u32s, (
Ipp8u** ppBitStream,
int* pOffset,
Ipp32s* pDstIs,
int* pDstNonZeroBound,
IppMP3SideInfo* pSideInfo,
IppMP3FrameHeader* pFrameHeader,
int hufSize,
IppMP3ScaleFactorBandTableLong pSfbTableLong,
IppMP3ScaleFactorBandTableShort pSfbTableShort,
IppMP3MixedBlockPartitionTable pMbpTable))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsReQuantize_MP3_32s_I
//
// Purpose:
// Requantizes the decoded Huffman symbols.
//
// Parameters:
// pSrcDstIsXr Pointer to the vector of the decoded Huffman
// symbols. For stereo and dual channel modes,
// right channel data begins at the address &(
// pSrcDstIsXr[576]). The function updates this
// vector.
// pNonZeroBound Pointer to the spectral bound above which all
// coefficients are set to zero. For stereo and
// dual channel modes, the left channel bound is
// pNonZeroBound [0], and the right channel bound is pNonZeroBound
// [,\.
// pScaleFactor Pointer to the scalefactor buffer. For stereo
// and dual channel modes, the right channel
// scalefactors begin at & (pScaleFactor [
// IPP_MP3_SF_BUF_LEN]).
// pSideInfo Pointer to the side information for the current
// granule.
// pFrameHeader Pointer to the frame header for the current frame.
// pBuffer Pointer to the workspace buffer. The buffer
// length must be 576 samples.
// pSfbTableLong Pointer to the scale factor bands table for a
// long block.
// pSfbTableShort Pointer to the scale factor bands table for a
// short block.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pSrcDstIsXr,
// pNonZeroBound, pScaleFactor, pSideInfo,
// pFrameHeader, or pBuffer is NULL.
// ippStsBadArgErr Indicates an error when pNonZeroBound exceeds [0
// , 576].
// ippStsMP3FrameHeaderErr Indicates an error when
// pFrameHeader->id != IPP_MP3_ID_MPEG1
// pFrameHeader->id != IPP_MP3_ID_MPEG2
// pFrameHeader->samplingFreq exceeds [0, 2],
// pFrameHeader->mode exceeds [0, 3],
// pFrameHeader->modeExt exceeds [0, 3].
// ippStsMP3SideInfoErr Indicates an error when the bitstream is in the
// stereo mode, but the block type of left is
// different from that of right, pSideInfo[ch].
// blockType exceeds [0, 3], pSideInfo[ch].
// mixedBlock exceeds [0, 1], pSideInfo[ch].
// globGain exceeds [0, 255], pSideInfo[ch].sfScale
// exceeds [0, 1], pSideInfo[ch].preFlag exceeds [0
// , 1], pSideInfo[ch].pSubBlkGain[w] exceeds [0, 7
// ], where ch is within the range of 0 to 1, and w
// is within the range of 0 to 2.
// ippStsErr Indicates an unknown error.
*/
IPPAPI(IppStatus, ippsReQuantize_MP3_32s_I, (
Ipp32s* pSrcDstIsXr,
int* pNonZeroBound,
Ipp8s* pScaleFactor,
IppMP3SideInfo* pSideInfo,
IppMP3FrameHeader* pFrameHeader,
Ipp32s* pBuffer))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsReQuantizeSfb_MP3_32s_I
//
// Purpose:
// Requantizes the decoded Huffman symbols.
//
// Parameters:
// pSrcDstIsXr Pointer to the vector of the decoded Huffman
// symbols. For stereo and dual channel modes,
// right channel data begins at the address &(
// pSrcDstIsXr[576]). The function updates this
// vector.
// pNonZeroBound Pointer to the spectral bound above which all
// coefficients are set to zero. For stereo and
// dual channel modes, the left channel bound is
// pNonZeroBound[0], and the right channel bound
// is pNonZeroBound[1].
// pScaleFactor Pointer to the scalefactor buffer. For stereo
// and dual channel modes, the right channel
// scalefactors begin at & (pScaleFactor [
// IPP_MP3_SF_BUF_LEN]).
// pSideInfo Pointer to the side information for the current
// granule.
// pFrameHeader Pointer to the frame header for the current frame.
// pBuffer Pointer to the workspace buffer. The buffer
// length must be 576 samples.
// pSfbTableLong Pointer to the scale factor bands table for a
// long block.
// pSfbTableShort Pointer to the scale factor bands table for a
// short block.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pSrcDstIsXr,
// pNonZeroBound, pScaleFactor, pSideInfo,
// pFrameHeader, or pBuffer is NULL.
// ippStsBadArgErr Indicates an error when pNonZeroBound exceeds
// [0, 576].
// ippStsMP3FrameHeaderErr Indicates an error when
// pFrameHeader->id != IPP_MP3_ID_MPEG1
// pFrameHeader->id != IPP_MP3_ID_MPEG2
// pFrameHeader->samplingFreq exceeds [0, 2],
// pFrameHeader->mode exceeds [0, 3],
// pFrameHeader->modeExt exceeds [0, 3].
// ippStsMP3SideInfoErr Indicates an error when the bitstream is in the
// stereo mode, but the block type of left is
// different from that of right, pSideInfo[ch].
// blockType exceeds [0, 3], pSideInfo[ch].
// mixedBlock exceeds [0, 1], pSideInfo[ch].
// globGain exceeds [0, 255], pSideInfo[ch].sfScale
// exceeds [0, 1], pSideInfo[ch].preFlag exceeds [0
// , 1], pSideInfo[ch].pSubBlkGain[w] exceeds [0, 7
// ], where ch is within the range of 0 to 1, and w
// is within the range of 0 to 2.
// ippStsErr Indicates an unknown error.
*/
IPPAPI(IppStatus, ippsReQuantizeSfb_MP3_32s_I, (
Ipp32s* pSrcDstIsXr,
int* pNonZeroBound,
Ipp8s* pScaleFactor,
IppMP3SideInfo* pSideInfo,
IppMP3FrameHeader* pFrameHeader,
Ipp32s* pBuffer,
IppMP3ScaleFactorBandTableLong pSfbTableLong,
IppMP3ScaleFactorBandTableShort pSfbTableShort))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTInv_MP3_32s
//
// Purpose:
// Performs the first stage of hybrid synthesis filter bank.
//
// Parameters:
// pSrcXr Pointer to the vector of requantized spectral
// samples for the current channel and granule,
// represented in Q5.26 format.
// pDstY Pointer to the vector of IMDCT outputs in Q7.24
// format for input to PQMF bank.
// pSrcDstOverlapAdd Pointer to the overlap-add buffer. Contains the
// overlapped portion of the previous granule IMDCT
// output in Q7.24 format. The function updates
// this buffer.
// nonZeroBound Limiting bound for spectral coefficients. All
// spectral coefficients exceeding this boundary
// become zero for the current granule and channel.
// pPrevNumOfImdct Pointer to the number of IMDCTs computed for the
// current channel of the previous granule. The
// function updates this parameter so that it
// references the number of IMDCTs for the current
// granule.
// blockType Block type indicator.
// mixedBlock Mixed block indicator.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsBadArgErr Indicates an error condition if at least one of
// the specified pointers is NULL.
// ippStsErr Indicates an error when one or more of the
// following input data errors are detected: either
// blockType exceeds [0,3], or mixedBlock exceeds [0
// ,1], or nonZeroBound exceeds [0,576], or *
// pPrevNumOfImdct exceeds [0,32].
*/
IPPAPI(IppStatus, ippsMDCTInv_MP3_32s, (
Ipp32s* pSrcXr,
Ipp32s* pDstY,
Ipp32s* pSrcDstOverlapAdd,
int nonZeroBound,
int* pPrevNumOfImdct,
int blockType,
int mixedBlock))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthPQMF_MP3_32s16s
//
// Purpose:
// Performs the second stage of hybrid synthesis filter bank.
//
// Parameters:
// pSrcY Pointer to the block of 32 IMDCT sub-band input
// samples in Q7.24 format.
// pDstAudioOut Pointer to the block of 32 reconstructed PCM
// output samples in 16-bit signed little-endian
// format. Left and right channels are interleaved
// according to the mode flag.
// pVBuffer Pointer to the input workspace buffer containing
// Q7.24 data. The function updates this parameter.
// NOTE. Note that the pointers pSrcXr and pDstY
// must reference different buffers. 10-104 10
// Intel Integrated Performance Primitives
// Reference Manual: Volume 1
// pVPosition Pointer to the internal workspace index. The
// function updates this parameter.
// mode Flag that indicates whether or not PCM audio
// output channels should be interleaved. 1
// indicates not interleaved, 2 indicates
// interleaved.
//
// Returns:
// ippStsNoErr Indicates no error. ippNullPtrErr Indicates an
// error when least one of the pointers pSrcY,
// pDstAudioOut, pVBuffer, or pVPosition is NULL.
// Audio Coding Functions 10 10-105
// ippStsBadArgErr Indicates an error when at least one of the
// specified pointers is NULL, or the value of mode
// is less than 1 or more than 2, or when the value
// of pVPosition exceeds [0, 15].
// ippStsErr Indicates an unknown error.
//
// Notes:
// Because the PQMF bank contains memory, the MP3 application must maintain
// two state variables in between calls to the primitive.
// First, the application must preallocate for the PQMF computation
// a workspace buffer of size 512 x Number of Channels. This buffer is
// referenced by the pointer pVBuffer, and its elements should be
// initialized to zero prior to the first call. During subsequent calls,
// the pVBuffer input for the current call should contain the pVbuffer
// output generated by the previous call. In addition to pVBuffer, the MP3
// application must also initialize to zero and thereafter preserve
// the value of the state variable pVPosition. The MP3 application should
// modify the values contained in pVBuffer or pVPosition only during
// decoder reset, and the reset values should always be zero.
*/
IPPAPI(IppStatus, ippsSynthPQMF_MP3_32s16s, (
Ipp32s* pSrcY,
Ipp16s* pDstAudioOut,
Ipp32s* pVBuffer,
int* pVPosition,
int mode))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsUnpackADIFHeader_AAC
//
// Purpose:
// Gets the AAC ADIF format header.
//
// Parameters:
// ppBitStream Double pointer to the current byte before the
// ADIF header.
// pADIFHeader Pointer to the IppACCADIFHeader structure.
// pPrgCfgElt Pointer to the IppAACPrgCfgElt structure. There
// must be prgCfgEltMax elements in the buffer.
// prgCfgEltMax Maximum program configure element number. Must
// be within the range of [1, 16].
//
// Returns:
// ippStsNoErr Indicates no error. Audio Coding Functions 10 10-
// 121
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pADIFHeader, pPrgCfgElt,
// or *ppBitStream is NULL.
// ippStsAacPrgNumErr Indicates an error when the decoded pADIFHeader->
// numPrgCfgElt > prgCfgEltMax, or prgCfgEltMax is
// outside the range of [1,IPP_AAC_MAX_ELT_NUM].
//
// Notes:
// 1. pADIFHeader->numPrgCfgElt is the number directly unpacked
// from bitstream plus 1.
// 2. It is assumed that it is known how many IppAACPrgCfgElt
// must be supported.
*/
IPPAPI(IppStatus, ippsUnpackADIFHeader_AAC,(Ipp8u **ppBitStream,
IppAACADIFHeader *pADIFHeader, IppAACPrgCfgElt *pPrgCfgElt,
int prgCfgEltMax ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodePrgCfgElt_AAC
//
// Purpose:
// Gets program configuration element from the input bitstream.
//
// Parameters:
// ppBitStream Double pointer to the current byte after
// decoding the program configuration element.
// pOffset Pointer to the bit position in the byte pointed
// to by *ppBitStream. Valid within 0 to 7: 0
// stands for the most significant bit of the byte;
// 7 stands for the least significant bit of the
// byte.
// pPrgCfgElt Pointer to IppAACPrgCfgElt structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pOffset, pPrgCfgElt, or *
// ppBitStream is NULL.
// ippStsAacBitOffsetErr Indicates an error when pOffset is out of the
// range of [0,7].
*/
IPPAPI(IppStatus, ippsDecodePrgCfgElt_AAC,(Ipp8u **ppBitStream, int *pOffset,
IppAACPrgCfgElt *pPrgCfgElt ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsUnpackADTSFrameHeader_AAC
//
// Purpose:
// Gets ADTS frame header from the input bitstream.
//
// Parameters:
// ppBitStream Double pointer to the current byte after
// unpacking the ADTS frame header.
// pADTSFrameHeader Pointer to the IppAACADTSFrameHeader structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pADTSFrameHeader, or
// *ppBitStream is NULL.
*/
IPPAPI(IppStatus, ippsUnpackADTSFrameHeader_AAC, (Ipp8u **ppBitStream,
IppAACADTSFrameHeader *pADTSFrameHeader))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodeDatStrElt_AAC
//
// Purpose:
// Gets data stream element from the input bitstream.
//
// Parameters:
// ppBitStream Double pointer to the current byte.
// pOffset Pointer to the bit position in the byte pointed
// to by *ppBitStream. Valid within 0 to 7. 0
// stands for the most significant bit of the byte.
// 7 stands for the least significant bit of the
// byte.
// ppBitStream Double pointer to the current byte after the
// decode data stream element.
// pOffset Pointer to the bit position in the byte pointed
// to by *ppBitStream. Valid within 0 to 7. 0
// stands for the most significant bit of the byte.
// 7 stands for the least significant bit of the
// byte.
// pDataTag Pointer to element_instance_tag. See Table 6.20
// of ISO/IEC 13818-7:1997. pDataCn Pointer to the
// value of data length in bytes.
// pDstDataElt Pointer to the data stream buffer that contains
// the data stream extracted from the input
// bitstream. There are 512 elements in the buffer
// pointed to by pDstDataElt.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pOffset, *ppBitStream,
// pDataTag, pDataCnt, or pDstDataElt is NULL.
// ippStsAacBitOffsetErr Indicates an error when *pOffset is out of range
// [0,7].
*/
IPPAPI(IppStatus, ippsDecodeDatStrElt_AAC,(Ipp8u **ppBitStream, int *pOffset,
int *pDataTag, int *pDataCnt, Ipp8u *pDstDataElt ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodeFillElt_AAC
//
// Purpose:
// Gets the fill element from the input bitstream.
//
// Parameters:
// ppBitStream Pointer to the pointer to the current byte after
// the decode fill element.
// pOffset Pointer to the bit position in the byte pointed
// to by *ppBitStream. Valid within 0 to 7. 0
// stands for the most significant bit of the byte.
// 7 stands for the least significant bit of the
// byte.
// pFillCnt Pointer to the value of the length of total fill
// data in bytes.
// pDstFillElt Pointer to the fill data buffer whose length
// must be equal to or greater than 270.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pOffset, pFillCnt, or
// pDstFillElt is NULL.
// ippStsAacBitOffsetErr Indicates an error when *pOffset is out of the
// range of [0,7].
*/
IPPAPI(IppStatus, ippsDecodeFillElt_AAC,(Ipp8u **ppBitStream, int *pOffset,
int *pFillCnt, Ipp8u *pDstFillElt ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodeChanPairElt_AAC
//
// Purpose:
// Gets channel_pair_element from the input bitstream.
//
// Parameters:
// ppBitStream Double pointer to the current byte after
// decoding the channel pair element.
// pOffset Pointer to the bit position in the byte pointed
// to by *ppBitStream. Valid within 0 to 7: 0
// stands for the most significant bit of the byte;
// 7 stands for the least significant bit of the
// byte.
// pIcsInfo Pointer to IppAACIcsInfo structure. If pIcsInfo->
// predDataPres = 0, set pIcsInfo->predReset = 0.
// Only the first pIcsInfo->numWinGrp elements in
// pIcsInfo-> pWinGrpLen are meaningful. You should
// not change some members of the structure, as
// shown in Table 10-5.
// pChanPairElt Pointer to IppAACChanPairElt structure. You
// should not change some members of the structure,
// as shown in Table 10-5.
// predSfbMax Maximum prediction scale factor bands. For LC
// profile, set predSfbMax = 0.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pOffset, *ppBitStream,
// pIcsInfo, or pChanPairElt is NULL.
// ippStsAacBitOffsetErr Indicates an error when pOffset is out of the
// range of [0,7].
// ippStsAacMaxSfbErr Indicates an error when pIcsInfo->maxSfb decoded
// from bitstream is greater than IPP_AAC_MAX_SFB,
// the maximum scale factor band for all sampling
// frequencies.
// ippStsAacPredSfbErr Indicates an error when predSfbMax is out of
// the range of [0, IPP_AAC_PRED_SFB_MAX].
*/
IPPAPI(IppStatus, ippsDecodeChanPairElt_AAC, (Ipp8u **ppBitStream,
int *pOffset,
IppAACIcsInfo *pIcsInfo,
IppAACChanPairElt *pChanPairElt,
int predSfbMax))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsNoiselessDecoder_LC_AAC
//
// Purpose:
// Decodes all data for one channel.
//
// Parameters:
// ppBitStream Double pointers to bitstream buffer.
// pOffset Pointer to the offset in one byte.
// pChanInfo Pointer to the channel information.
// IppAACChanInfo structure. Denotes pIcsInfo as
// pChanInfo->pIcsInfo as shown in Table 10-6.
// commonWin Common window indicator.
// pDstScalefactor Pointer to the scalefactor or intensity position
// buffer. Buffer length is more than or equal to
// 120. Only maxSfb elements are stored for each
// group. There is no space between sequence groups.
// pDstQuantizedSpectralCoef Pointer to the quantized spectral
// coefficients data. For short block, the
// coefficients are interleaved by scale factor
// window bands in each group. Buffer length is
// more than or equal to 1024.
// pDstSfbCb Pointer to the scale factor band codebook.
// Buffer length must be more than or equal to 120.
// Store maxSfb elements for each group. There is
// no space between the sequence groups.
// pDstTnsFiltCoef Pointer to TNS coefficients. Buffer length must
// be more than or equal to 60. The store sequence
// is TNS order elements for each filter for each
// window. The elements are not changed if the
// corresponding TNS order is zero.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers ppBitStream, pOffset, pChanInfo,
// pDstScalefactor, pDstQuantizedSpectralCoef,
// pDstSfbCb, pDstTnsFiltCoef, pChanInfo->pIcsInfo,
// or *ppBitStream is NULL.
// ippStsAacBitOffsetErr Indicates an error when pOffset is out of range
// [0,7].
// ippStsAacComWinErr Indicates an error when commonWin exceeds [0,1].
// ippStsAacSmplRateIdxErr Indicates an error when pChanInfo->
// samplingRateIndex exceeds [0,11].
// ippStsAacPredSfbErr Indicates an error when pChanInfo->predSfbMax is
// not equal to 0.
// ippStsAacMaxSfbErr Indicates an error when pChanInfo->pIcsInfo->
// maxSfb > pChanInfo->numSwb.
// ippStsAacSectCbErr Indicates an error when the codebook pointed to
// by pChanInfo->pSectCb is illegal or when (
// pChanInfo->pSectCb)==12, 13. pTnsRegionLen As
// output. Pointer to the length of the region in
// units of scale factor bands to which one filter
// is applied in each window. pTnsFiltOrder As
// output. Pointer to the order of the temporal
// noise shaping filter applied to each window.
// pTnsDirection As output. Pointer to the token
// that indicates whether the filter is applied in
// the upward or downward direction. 0 stands for
// upward and 1 for downward. pIcsInfo As input if
// commonWin == 1. As output if commonWin == 0. If
// pIcsInfo->predDataPres == 0, set pIcsInfo->
// predReset = 0. Only the first pIcsInfo->
// numWinGrp elements in pIcsInfo-> pWinGrpLen are
// meaningful. Under specific conditions, some
// members of the structure must remain unchanged.
// ippStsAacPlsDataErr Indicates an error when the pChanInfo->pIcsInfo->
// winSequence indicates a short sequence and
// pChanInfo->pulsePres indicates pulse data present
// . The start scale factor band for pulse data >=
// pChanInfo->numSwb, or pulse data position offset
// >= winLen.
// ippStsAacGainCtrErr Indicates an error when pChanInfo->
// gainControlPres is decoded as 1, which means
// that gain control data is present. Gain control
// data is not currently supported.
// ippStsAacCoefValErr Indicates an error when the quantized
// coefficients value pointed to by pDstCoef
// exceeds range [-8191, 8191].
//
// Notes:
// User must set pChanInfo->samplingRateIndex, predSfbMax, pIcsInfo,
// before calling this function.
*/
IPPAPI(IppStatus, ippsNoiselessDecoder_LC_AAC,(Ipp8u **ppBitStream,
int *pOffset, int commonWin, IppAACChanInfo *pChanInfo,
Ipp16s *pDstScalefactor, Ipp32s *pDstQuantizedSpectralCoef,
Ipp8u *pDstSfbCb, Ipp8s *pDstTnsFiltCoef ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsQuantInv_AAC_32s_I
//
// Purpose:
// Performs inverse quantization of Huffman symbols for current channel
// inplace.
//
// Parameters:
// pSrcDstSpectralCoef On input, pointer to the input quantized
// coefficients. For short block the coefficients
// are interleaved by scale factor window bands in
// each group. Buffer length must be more than or
// equal to 1024. On output, pointer to the
// destination inverse quantized coefficient in Q13.
// 18 format. For short block, the coefficients are
// interleaved by scale factor window bands in each
// group. Buffer length must be more than or equal
// to 1024. The maximum error of output.
// pSrcDstSpectralCoef[i] is listed in Table 10-7.
// pScalefactor Pointer to the scalefactor buffer. Buffer length
// must be more than or equal to 120.
// numWinGrp Group number.
// pWinGrpLen Pointer to the number of windows in each group.
// Buffer length must be more than or equal to 8.
// maxSfb Maximal scale factor bands number for the
// current block.
// pSfbCb Pointer to the scale factor band codebook,
// buffer length must be more than or equal to 120.
// Only maxSfb elements for each group are
// meaningful. There are no spaces between the
// sequence groups.
// samplingRateIndex Sampling rate index. Valid within [0, 11]. See
// Table 6.5 of ISO/IEC 13818-7:1997.
// winLen Data number in one window.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacSmplRateIdxErr Indicates an error when pChanInfo->
// samplingRateIndex exceeds [0, 11].
// ippStsAacMaxSfbErr Indicates an error when maxSfb exceeds [0,
// IPP_AAC_MAX_SFB].
// ippStsAacWinGrpErr Indicates an error when numWinGrp exceeds [0, 8]
// for long window or is not equal to 1 for short
// window.
// ippStsAacWinLenErr Indicates an error when winLen is not equal to
// 128 or 1024;
// ippStsAacCoefValErr Indicates an error when the quantized
// coefficients value pointed to by
// pSrcDstSpectralCoef exceeds [-8191,8191].
*/
IPPAPI(IppStatus, ippsQuantInv_AAC_32s_I,(Ipp32s *pSrcDstSpectralCoef,
const Ipp16s *pScalefactor, int numWinGrp,
const int *pWinGrpLen, int maxSfb, const Ipp8u *pSfbCb,
int samplingRateIndex, int winLen ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodeMsStereo_AAC_32s_I
//
// Purpose:
// Processes mid-side (MS) stereo for pair channels in-place.
//
// Parameters:
// pSrcDstL On input, pointer to left channel data in Q13.18
// format. For short block, the coefficients are
// interleaved by scale factor window bands in each
// group. Buffer length must be more than or equal
// to 1024. On output, pointer to left channel data
// in Q13.18 format. For short blocks, the
// coefficients are interleaved by scale factor
// window bands in each group. Buffer length must
// be more than or equal to 1024.
// pSrcDstR On input, pointer to right channel data in Q13.
// 18 format. For short block, the coefficients are
// interleaved by scale factor window bands in each
// group. Buffer length must be more than or equal
// to 1024. On output, pointer to right channel
// data in Q13.18 format. For short blocks, the
// coefficients are interleaved by scale factor
// window bands in each group. Buffer length must
// be more than or equal to 1024.
// msMaskPres MS stereo mask flag: - 0: MS off; - 1: MS on; - 2:
// MS all bands on.
// pMsUsed Pointer to the MS Stereo flag buffer. Buffer
// length must be more than or equal to 120.
// pSfbCbPointer Pointer to the scale factor band
// codebook, buffer length must be more than or
// equal to 120. Store maxSfb elements for each
// group.There is no space between the sequence
// groups.
// numWinGrp Group number.
// pWinGrpLen Pointer to the number of windows in each group.
// Buffer length must be more than or equal to 8.
// maxSfb Maximal scale factor bands number for the
// current block.
// samplingRateIndex Sampling rate index. Valid within [0, 11]. See
// Table 6.5 of ISO/IEC 13818-7:1997.
// winLen Data number in one window.
// pSrcDstR Pointer to right channel data in Q13.18 format.
// For short blocks, the coefficients are
// interleaved by scale factor window bands in each
// group. Buffer length must be more than or equal
// to 1024.
// pSfbCb Pointer to the scale factor band codebook. If
// invert_intensity (group, sfb) = -1, and if
// *pSfbCb = INTERITY_HCB, let
// *pSfbCb = INTERITY_HCB2.
// If *pSfbCb = INTERITY_HCB2, let
// *pSfbCb = INTERITY_HCB. Buffer length must be more
// than or equal to 120. Store maxSfb elements for
// each group. There is no space between the
// sequence groups.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacMaxSfbErr Indicates an error when the coefficient index
// calculated from samplingFreqIndex and maxSfb
// exceeds winLen in each window.
// ippStsAacSamplRateIdxErr Indicates an error when pChanInfor->
// samplingRateIndex exceeds [0,11].
// ippStsAacWinGrpErr Indicates an error when numWinGrp exceeds [0,8]
// for long window or is not equal to 1 for short
// window.
// ippStsAacWinLenErr Indicates an error when winLen is not equal 128
// or 1024.
// ippStsStereoMaskErr Indicates an error when the stereo mask flag is
// not equal 1 or 2.
//
// Notes:
// Input and output data are in interleaving mode, only for CPE.
*/
IPPAPI(IppStatus, ippsDecodeMsStereo_AAC_32s_I,(Ipp32s *pSrcDstL,
Ipp32s *pSrcDstR, int msMaskPres, const Ipp8u *pMsUsed,
Ipp8u *pSfbCb, int numWinGrp, const int *pWinGrpLen,
int maxSfb, int samplingRateIndex, int winLen ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodeIsStereo_AAC_32s
//
// Purpose:
// Processes intensity stereo for pair channels.
//
// Parameters:
// pSrcL Pointer to left channel data in Q13.18 format.
// For short block, the coefficients are
// interleaved by scale factor window bands in each
// group. Buffer length must be more than or equal
// to 1024.
// pDstR Pointer to right channel data in Q13.18 format.
// For short block, the coefficients are
// interleaved by scale factor window bands in each
// group. Buffer length must be more than or equal
// to 1024.
// pScalefactor Pointer to the scalefactor buffer. Buffer length
// must be more than or equal to 120.
// pSfbCb Pointer to the scale factor band codebook,
// buffer length must be more than or equal to 120.
// Store maxSfb elements for each group.There is no
// space between the sequence groups. Respective
// values of pSfbCb[sfb] equal to 1, -1, or 0
// indicate the intensity stereo mode, that is,
// direct, inverse, or none.
// numWinGrp Group number.
// pWinGrpLen Pointer to the number of windows in each group.
// Buffer length must be more than or equal to 8.
// maxSfbMax Maximal scale factor bands number for
// the current block.
// samplingRateIndex Sampling rate index. Valid within [0, 11]. See
// Table 6.5 of ISO/IEC 13818-7:1997.
// winLen Data number in one window.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacMaxSfbErr Indicates an error when the coefficient index
// calculated from samplingFreqIndex and maxSfb
// exceeds winLen in each window.
// ippStsAacSamplRateIdxErr Indicates an error when pChanInfor->
// samplingRateIndex exceeds [0,11].
*/
IPPAPI(IppStatus, ippsDecodeIsStereo_AAC_32s,(const Ipp32s *pSrcL,
Ipp32s *pDstR, const Ipp16s *pScalefactor,
const Ipp8u *pSfbCb, int numWinGrp, const int *pWinGrpLen,
int maxSfb, int samplingRateIndex, int winLen ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDeinterleaveSpectrum_AAC_32s
//
// Purpose:
// Deinterleaves the coefficients for short block.
//
// Parameters:
// pSrc Pointer to source coefficients buffer. The
// coefficients are interleaved by scale factor
// window bands in each group. Buffer length must
// be more than or equal to 1024.
// pDst Pointer to the output of coefficients. Data
// sequence is ordered in pDst[w*128+sfb*sfbWidth[
// sfb]+i], where w is window index, sfb is scale
// factor band index, sfbWidth is the scale factor
// band width table, i is the index within scale
// factor band. Buffer length must be more than or
// equal to 1024.
// numWinGrp Group number.
// pWinGrpLen Pointer to the number of windows in each group.
// Buffer length must be more than or equal to 8.
// maxSfb Maximal scale factor bands number for
// the current block.
// samplingRateIndex Sampling rate index. Valid in [0, 11]. See Table
// 6.5 of ISO/IEC 13818-7:1997.
// winLen Data number in one window.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacMaxSfbErr Indicates an error when the coefficient index
// calculated from samplingFreqIndex and maxSfb
// exceeds winLen in each window.
// ippStsAacSamplRateIdxErr Indicates an error when pChanInfor->
// samplingRateIndex exceeds [0,11].
// ippStsAacWinGrpErr Indicates an error when numWinGrp exceeds [0,8].
// ippStsAacWinLenErr Indicates an error when winLen is not equal to
// 128.
*/
IPPAPI(IppStatus, ippsDeinterleaveSpectrum_AAC_32s,(const Ipp32s *pSrc,
Ipp32s *pDst, int numWinGrp, const int *pWinGrpLen,
int maxSfb, int samplingRateIndex, int winLen ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodeTNS_AAC_32s_I
//
// Purpose:
// Decodes for Temporal Noise Shaping in-place.
//
// Parameters:
// pSrcDstSpectralCoefs On input, pointer to the input spectral
// coefficients to be filtered by the all-pole
// filters in Q13.18 format. There are 1024
// elements in the buffer pointed to by
// pSrcDstSpectralCoefs. On output, pointer to the
// output spectral coefficients after filtering by
// the all-pole filters in Q13.18 format.
// pTnsNumFilt Pointer to the number of noise shaping filters
// used for each window of the current frame. There
// are 8 elements in the buffer pointed to by
// pTnsNumFilt which are arranged as follows:pTnsNumFilt[w]:
// the number of noise shaping filters used for
// window w, w = 0 to numWin-1.
// pTnsRegionLen Pointer to the length of the region in units of
// scale factor bands to which one filter is
// applied in each window of the current frame.
// There are 8 elements in the buffer pointed to by
// pTnsRegionLen, which are arranged as follows:
// pTnsRegionLen[i]: the length of the region to
// which filter filt is applied in window w w = 0
// to numWin-1, filt=0 to pTnsNumFilt[w]-1.
// pTnsFiltOrder Pointer to the order of one noise shaping filter
// applied to each window of the current frame.
// There are 8 elements in the buffer pointed to by
// pTnsFiltOrder, which are arranged as follows:
// pTnsFiltOrder[i]: the order of one noise shaping
// filter filt, which is applied to window w w = 0
// to numWin-1, filt=0 to pTnsNumFilt[w]-1.
// pTnsFiltCoefRes Pointer to the resolution of 3 bits or 4 bits of
// the transmitted filter coefficients for each
// window of the current frame. There are 8
// elements in the buffer pointed to by
// pTnsFiltCoefRes, which are arranged as follows:
// pTnsFiltCoefRes[w]: the resolution of the
// transmitted filter coefficients for window w, w
// = 0 to numWin-1.
// pTnsFiltCoef Pointer to the coefficients of one noise shaping
// filter applied to each window of the current
// frame. There are 60 elements in the buffer
// pointed to by pTnsFiltCoef, which are arranged
// as follows: pTnsFiltCoef[i], pTnsFiltCoef[i+1],
// ..., pTnsFiltCoef[i+order-1]: the coefficients of
// one noise shaping filter filt, which is applied
// to window w. The order is the same as that of
// the noise shaping filter filt as applied to
// window w, w = 0 to numWin-1, filt=0 to
// pTnsNumFilt[w]-1. For example, pTnsFiltCoef[0],
// pTnsFiltCoef[1], ..., pTnsFiltCoef[order0-1] are
// the coefficients of the noise shaping filter 0,
// which is applied to window 0, if present. If so,
// pTnsFiltCoef[order0], pTnsFiltCoef[order0+1], ...,
// pTnsFiltCoef[order0+order1-1] are the
// coefficients of the noise shaping filter 1
// applied to window 0, if present, and so on.
// order0 is the same as that of the noise shaping
// filter 0 applied to window 0, and order1 is the
// order of the noise shaping filter 1 applied to
// window 0. After window 0 is processed, process
// window 1, then window 2 until all numWin windows
// are processed.
// pTnsDirection Pointer to the token that indicates whether the
// filter is applied in the upward or downward
// direction. 0 stands for upward and 1 for downward
// . There are 8 elements in the buffer pointed to
// by pTnsDirection which are arranged as follows:
// pTnsDirection[i]: the token indicating whether
// the filter filt is applied in upward or downward
// direction to window w w = 0 to numWin-1, filt=0
// to pTnsNumFilt[w]-1.
// maxSfb Number of scale factor bands transmitted per
// window group of the current frame.
// profile Profile index from Table 7.1 in ISO/IEC 13818-7:
// 1997.
// samplingRateIndex Index indicating the sampling rate of the
// current frame.
// winLen Data number in one window.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL. IppStsTnsProfielErr Indicates
// an error when profile != 1.
// ippStsAacTnsNumFiltErr Indicates an error when a data error occurs:
// for a short window sequence pTnsNumFilt[w]
// exceeds [0,1]; Table 10-8 Computation Error List
// for pSrcDstSpectralCoefs MAX(error(
// pSrcDstSpectralCoefs[i])) Condition 4095 8 ==
// numWin 32767 1 == numWin NOTE. This function
// supports LC profile only. 10-142 10 Intel
// Integrated Performance Primitives Reference
// Manual: Volume 1 for a long window sequence,
// pTnsNumFilt[w] exceeds [0,3].
// ippStsAacTnsLenErr Indicates an error when pTnsRegionLen exceeds
// [0, numSwb].
// ippStsAacTnsOrderErr Indicates an error when a data error occurs: for
// a short window sequence, pTnsFiltOrder exceeds
// [0,7]; for a long window sequence, pTnsFiltOrder
// exceeds [0,12].
// ippStsAacTnsCoefResErr Indicates an error when pTnsFiltCoefRes[w]
// exceeds [3, 4].
// ippStsAacTnsCoefErr Indicates an error when *pTnsFiltCoef exceeds
// [-8, 7].
// ippStsAacTnsDirectErr Indicates an error when *pTnsDirection exceeds
// [0, 1].
//
// Notes:
// Input/Output data(pSrcDstSpectralCoefs[]) are in Q3.
*/
IPPAPI(IppStatus, ippsDecodeTNS_AAC_32s_I,(Ipp32s *pSrcDstSpectralCoefs,
const int *pTnsNumFilt, const int *pTnsRegionLen,
const int *pTnsFiltOrder, const int *pTnsFiltCoefRes,
const Ipp8s *pTnsFiltCoef, const int *pTnsDirection,
int maxSfb, int profile, int samplingRateIndex, int winLen ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTInv_AAC_32s16s
//
// Purpose:
// Maps time-frequency domain signal into time domain and generates 1024
// reconstructed 16-bit signed little-endian PCM samples.
//
// Parameters:
// pSrcSpectralCoefs Pointer to the input time-frequency domain
// samples in Q13.18 format. There are 1024
// elements in the buffer pointed to by
// pSrcSpectralCoefs.
// pSrcDstOverlapAddBuf Pointer to the overlap-add buffer that contains
// the second half of the previous block windowed
// sequence in Q13.18. There are 1024 elements in
// this buffer.
// winSequence Flag that indicates which window sequence is
// used for current block.
// winShape Flag that indicates which window function is
// selected for current block.
// prevWinShape Flag that indicates which window function is
// selected for previous block.
// pcmMode Flag that indicates whether the PCM audio output
// is interleaved, that is has the pattern LRLRLR...
// or not. 1 stands for not interleaved. 2 stands
// for interleaved
// pDstPcmAudioOut Pointer to the output 1024 reconstructed 16-bit
// signed little-endian PCM samples in Q15,
// interleaved, if needed. The maximum computation
// error for pDstPcmAudioOut is less than 1 for
// each vector element. The total quadratic error
// for the vector is less than 96.
// pSrcDstOverlapAddBuf Pointer to the overlap-add buffer which contains
// the second half of the current block windowed
// sequence in Q13.18. The maximum computation
// error for pDstPcmAudioOut is less than 4 for
// each vector element. The total quadratic error
// for the vector is less than 1536.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsAacWinSeqErr Indicates an error when winSequence exceeds [0,3].
// ippStsAacWinShapeErr Indicates an error when winShape or prevWinShape
// exceeds [0,1].
// ippStsAacPcmModeErr Indicates an error when pcmMode exceeds [1,2].
//
// Notes:
// Input data (pSrcSpectralCoefs[]) is in Q = _IPP_AAC_FB_Q;
// data (pSrcDstOverlapAdd[]) is in Q = _IPP_AAC_FB_Q.
*/
IPPAPI(IppStatus, ippsMDCTInv_AAC_32s16s,(Ipp32s *pSrcSpectralCoefs,
Ipp16s *pDstPcmAudioOut, Ipp32s *pSrcDstOverlapAddBuf,
int winSequence, int winShape, int prevWinShape, int pcmMode ))
IPPAPI(IppStatus, ippsMDCTInv_AAC_32s_I,(Ipp32s *tst_SrcDst, Ipp32s *tst_OverlapBuf,
int winSeq, int winShape, int prewinShape, int len))
IPPAPI(IppStatus, ippsMDCTFwd_AAC_32s_I,(Ipp32s *tst_SrcDst, int winSeq, int winShape,
int prewinShape, int len))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodeMainHeader_AAC
//
// Purpose:
// Gets main header information and main layer information from bit stream.
//
// Parameters:
// ppBitStream Double pointer to bitstream buffer. *ppBitStream
// will be updated after decoding.
// pOffset Pointer to the offset in one byte. *pOffset will
// be updated after decoding.
// channelNum Number of channels.
// monoStereoFlag Current frame has mono and stereo layers.
// pAACMainHeader Pointer to the main element header.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacBitOffsetErr Indicates an error when pOffset exceeds [0,7].
// ippStsAacChanErr Indicates an error when channelNum exceeds [1,2].
// ippStsAacMonoStereoErr Indicates an error when monoStereoFlag exceeds
// [0,1].
*/
IPPAPI(IppStatus, ippsDecodeMainHeader_AAC,(Ipp8u **ppBitStream,
int *pOffset, IppAACMainHeader *pAACMainHeader, int channelNum,
int monoStereoFlag ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodeExtensionHeader_AAC
//
// Purpose:
// Gets extension header information and extension layer information from
// bit stream.
//
// Parameters:
// ppBitStream Double pointer to bitstream buffer. *ppBitStream
// will be updated after decoding.
// pOffset Pointer to the offset in one byte. *pOffset will
// be updated after decoding.
// monoStereoFlag Flag indicating that the current frame has mono
// and stereo layers.
// thisLayerStereo Flag indicating that the current layer is stereo.
// monoLayerFlag Flag indicating that the current frame has a
// mono layer.
// preStereoMaxSfb Previous stereo layer maxSfb.
// hightstMonoMaxSfb Last mono layer maxSfb.
// winSequence Window type, short or long.
// pAACExtHeader Pointer to the extension element header.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacBitOffsetErr Indicates an error when pOffset is out of the
// range of [0,7].
// ippStsAacStereoLayerErr Indicates an error when thisLayerStereo
// exceeds [0,1].
// ippStsAacMonoLayerErr Indicates an error when monoLayerFlag exceeds
// [0,1].
// ippStsAacMaxSfbErr Indicates an error when at least one of
// preStereoMaxSfb, hightstMonoMaxSfb or number of
// scale factor bands used in this layer exceeds
// [0,IPP_AAC_MAX_SFB].
// ippStsAacMonoStereoErr Indicates an error when monoStereoFlag exceeds
// [0,1].
// ippStsAacWinSeqErr Indicates an error when winSequence exceeds
// [0,3].
//
*/
IPPAPI(IppStatus, ippsDecodeExtensionHeader_AAC,(Ipp8u **ppBitStream,
int *pOffset, IppAACExtHeader *pAACExtHeader, int monoStereoFlag,
int thisLayerStereo, int monoLayerFlag, int preStereoMaxSfb,
int hightstMonoMaxSfb, int winSequence ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodePNS_AAC_32s
//
// Purpose:
// Implements perceptual noise substitution (PNS) coding within
// individual channel stream (ICS).
//
// Parameters:
// pSrcDstSpec Pointer to spectrum coefficients for perceptual
// noise substitution (PNS).
// pSrcDstLtpFlag Pointer to long term predict (LTP) flag.
// pSfbCb Pointer to the scale factor codebook.
// pScaleFactor Pointer to the scalefactor value.
// maxSfb Number of scale factor bands used in this layer.
// numWinGrp Number of window groups.
// pWinGrpLen Pointer to the length of every window group.
// samplingFreqIndex Sampling frequency index.
// winLen Window length. 1024 for long windows, 128 for
// short windows.
// pRandomSeed Random seed for PNS.
// pSrcDstSpec Pointer to the output spectrum substituted by
// perceptual noise.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacMaxSfbErr Indicates an error when maxSfb exceeds [0,
// IPP_AAC_MAX_SFB].
// ippStsAacSmplRateIdxErr Indicates an error when pChanInfo->
// samplingRateIndex exceeds [0,12].
// ippStsAacWinLenErr Indicates an error when winLen is not equal to
// 128 or 1024.
*/
IPPAPI(IppStatus, ippsDecodePNS_AAC_32s,(Ipp32s *pSrcDstSpec,
int *pSrcDstLtpFlag, Ipp8u *pSfbCb, Ipp16s *pScaleFactor,
int maxSfb, int numWinGrp, int *pWinGrpLen, int samplingFreqIndex,
int winLen, int *pRandomSeed ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodeMsPNS_AAC_32s
//
// Purpose:
// Implements perceptual noise substitution coding within an ICS.
//
// Parameters:
// pSrcDstSpec Pointer to spectrum coefficients before PNS.
// pSrcDstLtpFlag Pointer to the LTP flag.
// pSfbCb Pointer to the scalefactor code book.
// pScaleFactor Pointer to the scalefactor coefficients.
// maxSfb Number of max scalefactor band.
// numWinGrp Number groups of windows.
// pWinGrpLen Pointer to the group length.
// samplingFreqIndex Sampling frequency index.
// winLen Length of windows.
// pRandomSeed Random seed.
// channel Index of current channel:
// 0: left;
// 1: right.
// pMsUsed Pointer to MS used buffer in CPE structure.
// pNoiseState Pointer to noise state buffer, which stores
// the left channel's noise random seed for
// every scalefactor band. When pMsUsed[sfb]==1,
// the content in this buffer will be used for
// right channel.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacMaxSfbErr Indicates an error when maxSfb exceeds [0,
// IPP_AAC_MAX_SFB].
// ippStsAacWinGrpErr Indicates an error when numWinGrp exceeds [0,8].
// ippStsAacSmplRateIdxErr Indicates an error when samplingFreqIndex
// exceeds [0,16].
// ippStsAacWinLenErr Indicates an error when winLen is not equal to
// 128 or 1024.
*/
IPPAPI(IppStatus, ippsDecodeMsPNS_AAC_32s,(Ipp32s *pSrcDstSpec,
int *pSrcDstLtpFlag, Ipp8u *pSfbCb, Ipp16s *pScaleFactor,
int maxSfb, int numWinGrp, int *pWinGrpLen, int samplingFreqIndex,
int winLen, int *pRandomSeed, int channel, Ipp8u *pMsUsed, int *pNoiseState ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsLongTermReconstruct_AAC_32s
//
// Purpose:
// Uses Long Term Reconstruct (LTR) to reduce signal redundancy between
// successive coding frames.
//
// Parameters:
// pSrcDstSpec Pointer to spectral coefficients for LTP.
// pSrcEstSpec Pointer to the frequency domain vector.
// winSequence Window type, long or short.
// samplingFreqIndex Sampling frequency index.
// pLtpFlag Pointer to the LTP flag.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacSmplRateIdxErr Indicates an error when pChanInfo->
// samplingRateIndex exceeds [0,12].
// ippStsAacWinSeqErr Indicates an error when winSequence exceeds
// [0,3].
*/
IPPAPI(IppStatus, ippsLongTermReconstruct_AAC_32s,(Ipp32s *pSrcEstSpec,
Ipp32s *pSrcDstSpec, int *pLtpFlag, int winSequence,
int samplingFreqIndex ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsEncodeTNS_AAC_32s_I
//
// Purpose:
// Performs reversion of TNS in the Long Term Reconstruct loop in-place.
//
// Parameters:
// pSrcDst On input, pointer to the spectral coefficients
// for the TNS encoding operation. On output,
// pointer to the spectral coefficients after the
// TNS encoding operation.
// pTnsNumFilt Pointer to the number of TNS filters.
// pTnsRegionLen Pointer to the length of TNS filter.
// pTnsFiltOrder Pointer to the TNS filter order.
// pTnsFiltCoefRes Pointer to the TNS coefficient resolution flag.
// pTnsFiltCoef Pointer to the TNS filter coefficients.
// pTnsDirection Pointer to the TNS direction flag.
// maxSfb Maximum scale factor number.
// profile Audio profile.
// samplingFreqIndex Sampling frequency index.
// winLen Window length.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsTnsProfileErr Indicates an error when profile != 1.
// ippStsAacTnsNumFiltErr Indicates an error when *pTnsNumFilt exceeds
// [0, 1] for the short window sequence or [0, 3]
// for the long window sequence.
// ippStsAacTnsLenErr Indicates an error when *pTnsRegionLen exceeds
// [0, numSwb].
// ippStsAacTnsOrderErr Indicates an error when *pTnsFiltOrder exceeds
// [0, 7] for the short window sequence or [0, 12]
// for the long window sequence.
// ippStsAacTnsCoefResErr Indicates an error when *pTnsFiltCoefRes
// exceeds [3, 4].
// ippStsAacTnsCoefErr Indicates an error when *pTnsFiltCoef exceeds
// [-8, 7].
// ippStsAacTnsDirectErr Indicates an error when *pTnsDirection exceeds
// [0, 1].
// ippStsAacSmplRateIdxErr Indicates an error when samplingRateIndex
// exceeds [0, 12].
// ippStsAacWinLenErr Indicates an error when winLen is not equal to
// 128 or 1024.
//
// Notes:
// Input/Output data(pSrcDstSpectralCoefs[]) are in Q3.
*/
IPPAPI(IppStatus, ippsEncodeTNS_AAC_32s_I,(Ipp32s *pSrcDstSpectralCoefs,
const int *pTnsNumFilt, const int *pTnsRegionLen,
const int *pTnsFiltOrder, const int *pTnsFiltCoefRes,
const Ipp8s *pTnsFiltCoef, const int *pTnsDirection,
int maxSfb, int profile, int samplingRateIndex, int winLen ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsLongTermPredict_AAC_32s
//
// Purpose:
// Gets the predicted time domain signals in the Long Term Reconstruct
// (LTP) loop.
//
// Parameters:
// pSrcTimeSignal Pointer to the temporal signals to be predicted
// in the temporary domain.
// pDstEstTimeSignal Pointer to the output of samples after LTP.
// pAACLtpInfo Pointer to the LTP information.
// winSequence Window type, short or long.
// pDstEstTimeSignal Pointer to the prediction output in time domain.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers is NULL.
// ippStsAacWinSeqErr Indicates an error when winSequence exceeds
// [0,3].
*/
IPPAPI(IppStatus, ippsLongTermPredict_AAC_32s,(Ipp32s *pSrcTimeSignal,
Ipp32s *pDstEstTimeSignal, IppAACLtpInfo *pAACLtpInfo,
int winSequence ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsNoiseLessDecode_AAC
//
// Purpose:
// Performs noiseless decoding.
//
// Parameters:
// ppBitStream Double pointer to the bitstream to be parsed.
// *ppBitStream will be updated after decoding.
// pOffset Pointer to the offset in one byte. *pOffset will
// be updated after decoding.
// pAACMainHeader Pointer to main header information. Not used for
// scalable objects. When commonWin == 0 &&
// scaleFlag==0, you need to decode LTP information
// and save it in pAACMainHeader->pLtpInfo[].
// pChanInfo Pointer to channel information structure.
// windowSequence Window type, short or long.
// maxSfb Number of scale factor bands.
// commonWin Indicates if the channel pair uses the same ICS
// information.
// scaleFlag Flag indicating whether the scalable type is used.
// audioObjectType Audio object type indicator: 1 indicates the
// main type 2 indicates the LC type 6 indicates
// the scalable mode.
// pDstScaleFactor Pointer to the parsed scalefactor.
// pDstQuantizedSpectralCoef Pointer to the quantized spectral
// coefficients after Huffman decoding.
// pDstSfbCb Pointer to the scale factor codebook index.
// pDstTnsFiltCoef Pointer to TNS filter coefficients. Not used for
// scalable objects.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacBitOffsetErr Indicates an error when pOffset is out of the
// range [0,7].
// ippStsAacComWinErr Indicates an error when commonWin exceeds [0,1].
// ippStsAacMaxSfbErr Indicates an error when maxSfb exceeds [0,
// IPP_AAC_MAX_SFB].
// ippStsAacSmplRateIdxErr Indicates an error when pChanInfo->
// samplingRateIndex exceeds [0,11].
// ippStsAacCoefValErr Indicates an error when the quantized
// coefficients value pointed to by pDstCoef
// exceeds the range of [-8191,8191].
//
// Notes:
// User must set pChanInfo,winSequence, maxSfb, commonWin and
// scaleflag before calling this function; commonWin and scaleFlag
// are 1 in condition of scaleable;
// In comparison with AAC LC, only decode section data has little
// changes when get dpcm_noise_nrg or hcod_sf[dpcm_noise_nrg]
// information (all are stored in pDstScalefactor).
*/
IPPAPI(IppStatus, ippsNoiselessDecode_AAC,(Ipp8u **ppBitStream, int *pOffset,
IppAACMainHeader *pAACMainHeader, Ipp16s *pDstScalefactor,
Ipp32s *pDstQuantizedSpectralCoef, Ipp8u *pDstSfbCb,
Ipp8s *pDstTnsFiltCoef, IppAACChanInfo *pChanInfo,
int winSequence, int maxSfb, int commonWin,
int scaleFlag, int audioObjectType ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsLtpUpdate_AAC_32s
//
// Purpose:
// Performs required buffer update in the Long Term Reconstruct (LTP) loop.
//
// Parameters:
// pSpecVal Pointer to spectral value after TNS decoder in
// LTP loop.
// pLtpSaveBuf Pointer to save buffer for LTP. Buffer length
// should be 3*frameLength. The value is saved for
// next frame.
// winSequence Window type:
// - 0 stands for long
// - 1 stands for long start
// - 2 stands for short
// - 3 stands for long stop.
// winShape KBD or SIN window shape.
// preWinShape Previous window shape.
// pWorkBuf Work buffer for LTP update, length of pWorkBuf
// should be at least 2048*3 = 6144 words.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacWinSeqErr Indicates an error when winSequence exceeds [0,3].
// ippStsAacWinShapeErr Indicates an error when winShape or preWinShape
// exceeds [0,1].
*/
IPPAPI(IppStatus, ippsLtpUpdate_AAC_32s,(Ipp32s *pSpecVal,
Ipp32s *pLtpSaveBuf, int winSequence, int winShape,
int preWinShape, Ipp32s *pWorkBuf ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwd_AAC_32s
//
// Purpose:
// Generates spectrum coefficient of PCM samples.
//
// Parameters:
// pSrc Pointer to temporal signals to do MDCT.
// pDst Output of MDCT, the spectral coefficients of PCM
// samples.
// pOverlapAdd Pointer to overlap buffer. Not used for MPEG-4
// AAC decoding.
// winSequence Window sequence indicating if the block is long
// or short.
// winShape Current window shape.
// preWinShape Previous window shape.
// pWindowedBuf Work buffer for MDCT. Should be at least 2048
// words.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacWinSeqErr Indicates an error when winSequence exceeds [0,3].
// ippStsAacWinShapeErr Indicates an error when preWinShape exceeds
// [0,1].
*/
IPPAPI(IppStatus, ippsMDCTFwd_AAC_32s,(Ipp32s *pSrc, Ipp32s *pDst,
Ipp32s *pOverlapAdd, int winSequence, int winShape,
int preWinShape, Ipp32s *pWindowedBuf ))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsDecodeChanPairElt_MP4_AAC
//
// Purpose:
// Gets channel_pair_element from the input bitstream.
//
// Parameters:
// ppBitStream Double pointer to the current byte.*ppBitStream
// will be updated after decoding.
// pOffset Pointer to the bit position in the byte pointed
// to by *ppBitStream. Valid within 0 to 7: 0
// stands for the most significant bit of the byte;
// 7 stands for the least significant bit of the
// byte.
// pIcsInfo Pointer to IppAACIcsInfo structure.
// pChanPairElt Pointer to IppAACChanPairElt structure.
// pAACMainHeader Pointer to the main element header.
// predSfbMax Maximum prediction scale factor bands.
// audioObjectType Audio object type indicator: 1 indicates the
// main type 2 indicates the LC type 6 indicates
// the scalable mode.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// specified pointers is NULL.
// ippStsAacBitOffsetErr Indicates an error when pOffset is out of the
// range of [0,7].
// ippStsAacMaxSfbErr Indicates an error when pIcsInfo->maxSfb decoded
// from bitstream is greater than IPP_AAC_MAX_SFB,
// the maximum scale factor band for all sampling
// frequencies.
*/
IPPAPI(IppStatus, ippsDecodeChanPairElt_MP4_AAC,(Ipp8u **ppBitStream, int *pOffset,
IppAACIcsInfo *pIcsInfo, IppAACChanPairElt *pChanPairElt,
IppAACMainHeader *pAACMainHeader, int predSfbMax,
int audioObjectType))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVLCDecodeEscBlock_MP3_1u16s
//
// Purpose:
// Parses the bitstream and decodes variable length code for MP3.
//
// Parameters:
// ppBitStream Pointer to pointer to the current byte in the
// bitstream buffer. *ppBitStream is updated by the
// function.
// pBitOffset Pointer to the bit position in the byte pointed
// by *ppBitStream.
// *pBitOffset is updated by the function.
// linbits Length of escape sequence.
// pData Pointer to the array of decoded values.
// len Number of values to decode into array pData.
// pVLCSpec Pointer to VLCDecoder specification structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one or more pointers
// passed to the function is NULL.
// ippStsVLCInputDataErr Indicates an error when incorrect input is used.
// For decode functions it can indicate that
// bitstream contains code that is not specified
// inside the used table.
// ippStsBitOffsetErr Indicates an error when *pBitOffset is less
// than 0 or more than 7.
// ippStsContextMatchErr Indicate an error when pVLCSpec struct was not
// created by ippsVLCDecodeInit_32s or
// ippsVLCDecodeInitAlloc_32s functions.
*/
IPPAPI(IppStatus, ippsVLCDecodeEscBlock_MP3_1u16s,(Ipp8u **ppBitStream,
int *pBitOffset,
int linbits,
Ipp16s *pData,
int len,
const IppsVLCDecodeSpec_32s *pVLCSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVLCDecodeEscBlock_AAC_1u16s
//
// Purpose:
// Parses the bitstream and decodes variable length code for AAC.
//
// Parameters:
// ppBitStream Pointer to pointer to the current byte in the
// bitstream buffer. *ppBitStream is updated by
/ the function.
// pBitOffset Pointer to the bit position in the byte pointed
// by *ppBitStream.
// *pBitOffset is updated by the function.
// pData Pointer to the array of decoded values.
// len Number of values to decode into array pData.
// pVLCSpec Pointer to VLCDecoder specification structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one or more pointers
// passed to the function is NULL.
// ippStsVLCInputDataErr Indicates an error when incorrect input is used.
// For decode functions it can indicate that
// bitstream contains code that is not specified
// inside the used table.
// ippStsBitOffsetErr Indicates an error when *pBitOffset is less
// than 0 or more than 7.
// ippStsVLCAACEscCodeLengthErr Indicates an error when bitstream
// contains AAC-Esc code with the length more than
// 21.
// ippStsContextMatchErr Indicate an error when pVLCSpec struct was not
// created by ippsVLCDecodeInit_32s or
// ippsVLCDecodeInitAlloc_32s functions.
*/
IPPAPI(IppStatus, ippsVLCDecodeEscBlock_AAC_1u16s,(Ipp8u **ppBitStream,
int *pBitOffset,
Ipp16s *pData,
int len,
const IppsVLCDecodeSpec_32s *pVLCSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVLCEncodeEscBlock_MP3_16s1u
//
// Purpose:
// Encodes an array of values into destination bitstream in MP3 format
// and advances bitstream pointer.
//
// Parameters:
// pInputData Pointer to the array of source values.
// len Size of values array pInputData.
// linbits Length of escape sequence.
// ppBitStream Pointer to pointer to the current byte in the
// bitstream buffer. *ppBitStream is updated by
// the function.
// pBitOffset Ppointer to the bit position in the byte pointed
// by *ppBitStream.
// *pBitOffset is updated by the function.
// pVLCSpec Pointer to VLCEncoder specification structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pointers to data
// arrays are NULL.
// ippStsBitOffsetErr Indicates an error when *pBitOffset is less
// than 0 or more than 7.
// ippStsContextMatchErr Indicate an error when pVLCSpec struct was not
// created by ippsVLCEncodeInit_32s or
// ippsVLCEncodeInitAlloc_32s functions.
*/
IPPAPI(IppStatus, ippsVLCEncodeEscBlock_MP3_16s1u,(const Ipp16s *pInputData,
int len,
int linbits,
Ipp8u **ppBitStream,
int *pBitOffset,
const IppsVLCEncodeSpec_32s *pVLCSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVLCEncodeEscBlock_AAC_16s1u
//
// Purpose:
// Encodes an array of values into destination bitstream in AAC format
// and advances bitstream pointer.
//
// Parameters:
// pInputData Pointer to the array of source values.
// len Size of values array pInputData.
// ppBitStream Pointer to pointer to the current byte in the
// bitstream buffer.
// *ppBitStream is updated by the function.
// pBitOffset Pointer to the bit position in the byte pointed
// by *ppBitStream.
// *pBitOffset is updated by the function.
// pVLCSpec Pointer to VLCEncoder specification structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pointers to data
// arrays are NULL.
// ippStsBitOffsetErr Indicates an error when *pBitOffset is less
// than 0 or more than 7.
// ippStsContextMatchErr Indicate an error when pVLCSpec struct was not
// created by ippsVLCEncodeInit_32s or
// ippsVLCEncodeInitAlloc_32s functions.
*/
IPPAPI(IppStatus, ippsVLCEncodeEscBlock_AAC_16s1u,(const Ipp16s *pInputData,
int len,
Ipp8u **ppBitStream,
int *pBitOffset,
const IppsVLCEncodeSpec_32s *pVLCSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVLCCountEscBits_MP3_16s32s
//
// Purpose:
// Calculates the number of bits necessary for encoding in MP3 format.
//
// Parameters:
// pInputData Pointer to the array of source values.
// len Size of values array pInputData.
// linbits Length of escape sequence. pCounBits Pointer to
// calculated length in bits to encode pInputData.
// pVLCSpec Pointer to VLCEncoder specification structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pointers to data
// arrays are NULL.
// ippStsContextMatchErr Indicate an error when pVLCSpec struct was not
// created by ippsVLCEncodeInit_32s or
// ippsVLCEncodeInitAlloc_32s functions.
*/
IPPAPI(IppStatus, ippsVLCCountEscBits_MP3_16s32s,(const Ipp16s *pInputData,
int len,
int linbits,
Ipp32s *pCountBits,
const IppsVLCEncodeSpec_32s *pVLCSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsVLCCountEscBits_AAC_16s32s
//
// Purpose:
// Calculates the number of bits necessary for encoding in AAC format.
//
// Parameters:
// pInputData Pointer to the array of source values.
// len Size of values array pInputData.
// pCountBits Pointer to calculated length in bits to encode
// pInputData.
// pVLCSpec Pointer to VLCEncoder specification structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when the pointers to data
// arrays are NULL.
// ippStsContextMatchErr Indicate an error when pVLCSpec struct was not
// created by ippsVLCEncodeInit_32s or
// ippsVLCEncodeInitAlloc_32s functions.
*/
IPPAPI(IppStatus, ippsVLCCountEscBits_AAC_16s32s,(const Ipp16s *pInputData,
int len,
Ipp32s *pCountBits,
const IppsVLCEncodeSpec_32s *pVLCSpec))
/*******************************************************************/
/*
// Name: ippsVLCDecodeUTupleEscBlock_MP3_1u16s
// Purpose: decodes a len element encoded by VLC code from the source data
// *ppBitStream with *pBitOffset bits offset and stores the result in
// the destination *pData
//
// Arguments:
// ppBitStream Pointer to pointer to the current byte in the
// bitstream buffer. *ppBitStream is updated by the function.
// pBitOffset Pointer to the bit position in the byte pointed by
// *ppBitStream. Valid within the range 0 to 7.
// *pBitOffset is updated by the function.
// linbits Length of escape sequence.
// pData Pointer to the array of decoded values.
// len Number of values to decode into array pData.
// pVLCSpec pointer to VLCDecoder specification structure
//
// Return:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one or more pointers
// passed to the function is NULL.
// ippStsVLCInputDataErr Indicates an error when incorrect input is used.
// For decode functions it can indicate that bitstream
// contains code that is not specified inside the used table.
// ippStsBitOffsetErr Indicate an error when offset less than 0 or more then 7.
// ippStsContextMatchErr Indicate an error when pVLCSpec struct was not created by
// ippsVLCDecodeInit_32s or ippsVLCDecodeInitAlloc_32s functions.
//
*/
IPPAPI(IppStatus, ippsVLCDecodeUTupleEscBlock_MP3_1u16s,(Ipp8u **ppBitStream,
int *pBitOffset,
int linbits,
Ipp16s *pData,
int len,
const IppsVLCDecodeUTupleSpec_32s *pVLCSpec))
/*******************************************************************/
/*
// Name: ippsVLCDecodeUTupleEscBlock_AAC_1u16s
// Purpose: decodes a len element encoded by VLC code from the source data
// *ppBitStream with *pBitOffset bits offset and stores the result in
// the destination *pData
//
// Arguments:
// ppBitStream Pointer to pointer to the current byte in the
// bitstream buffer. *ppBitStream is updated by the function.
// pBitOffset Pointer to the bit position in the byte pointed by
// *ppBitStream. Valid within the range 0 to 7.
// *pBitOffset is updated by the function.
// pData Pointer to the array of decoded values.
// len Number of values to decode into array pData.
// pVLCSpec pointer to VLCDecoder specification structure
//
// Return:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one or more pointers
// passed to the function is NULL.
// ippStsVLCInputDataErr Indicates an error when incorrect input is used.
// For decode functions it can indicate that bitstream
// contains code that is not specified inside the used table.
// ippStsVLCAACEscCodeLengthErr Indicates an error when bitstream contains AAC-Esc code
// with the length more than 21.
// ippStsBitOffsetErr Indicate an error when offset less than 0 or more then 7.
// ippStsContextMatchErr Indicate an error when pVLCSpec struct was not created by
// ippsVLCDecodeInit_32s or ippsVLCDecodeInitAlloc_32s functions.
//
*/
IPPAPI(IppStatus, ippsVLCDecodeUTupleEscBlock_AAC_1u16s,(Ipp8u **ppBitStream,
int *pBitOffset,
Ipp16s *pData,
int len,
const IppsVLCDecodeUTupleSpec_32s *pVLCSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsPackFrameHeader_MP3
//
// Purpose:
// Packs the content of the frame header into the bitstream.
//
// Parameters:
// pSrcFrameHeader Pointer to the IppMP3FrameHeader structure. This
// structure contains all the header information
// associated with the current frame. All structure
// fields must contain valid data upon function
// entry.
// ppBitStream Pointer to the encoded bitstream buffer - a
// double pointer to the first byte in the
// bitstream buffer intended to receive the packed
// frame header bits generated by this function.
// The frame header bits are sequentially written
// into the stream buffer starting from the bit
// indexed by the combination of byte pointer
// ppBitStream. The frame header bits
// are formatted according to the bitstream syntax
// given in ISO/IEC 11172-3.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pSrcFrameHeader or
// ppBitStream is NULL.
*/
IPPAPI(IppStatus, ippsPackFrameHeader_MP3, (
IppMP3FrameHeader* pSrcFrameHeader,
Ipp8u** ppBitStream))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsPackSideInfo_MP3
//
// Purpose:
// Packs the side information into the bitstream buffer.
//
// Parameters:
// pSrcSideInfo Pointer to the IppMP3SideInfo structures. This
// should contain twice the channel number of
// elements. The order is the following: - granule 1
// , channel 1; - granule 1, channel 2; - granule 2,
// channel 1; - granule 2, channel 2. All fields of
// all set elements should contain valid data upon
// the function entry.
// mainDataBegin Negative bitstream offset, in bytes. The
// parameter value is typically the number of bytes
// remaining in the bit reservoir before the start
// of quantization for the current frame. When
// computing mainDataBegin, you should exclude the
// header and side information bytes. The side
// information formatter packs the 9-bit value of
// mainDataBegin into the main_data_begin field of
// the output bitstream.
// privateBits Depending on the number of channels, the
// function extracts the appropriate number of
// least significant bits from the parameter
// privateBits and packs them into the private_bits
// field of the output bitstream. The ISO/IEC 11172-3
// bitstream syntax reserves a channel-dependent
// number of application-specific (private) bits in
// the layer III bitstream audio data section
// immediately following the parameter
// main_data_begin. See ISO/IEC 11172-3:1993. For
// dualand single-channel streams, respectively,
// three and five bits are reserved.
// pSrcScfsi Pointer to the scale factor selection
// information table. This vector contains a set of
// binary flags that indicate whether scalefactors
// are shared across granules of a frame within
// predefined scale factor selection groups. For
// example, bands 0,1,2,3,4,5 form one group and
// bands 6,7,8,9,10 form the second group, as
// defined in ISO/IEC 11172-3.
// The vector is indexed as
// pDstScfsi[ch][scfsi_band], where:
// - ch is the channel index, 0 stands for
// channel 1, 1 stands for channel 2;
// - scfsi_band is the scale factor selection group
// number. Group 0 includes SFBs 0-5, group 1
// includes SFBs 6-10, group 2 includes SFBs 11-15,
// and group 3 includes SFBs 16-20.
// pFrameHeader Pointer to the IppMP3FrameHeader structure. Only
// MPEG-1 (id = 1) is supported. Upon the function
// entry, the structure fields id, mode, and layer
// should contain, respectively, the algorithm id
// (MPEG-1 or MPEG-2), the mono or stereo mode, and
// the MPEG layer specifier. All other pFrameHeader
// fields are ignored.
// ppBitStream Pointer to the encoded bitstream buffer. The
// parameter is a double pointer to the first byte
// in the bitstream buffer intended to receive the
// packed side information bits generated by this
// function. The side information bits are
// sequentially written into the stream buffer
// starting from the byte-aligned location
// referenced by *ppBitStream.
// ppBitStream Updated bitstream byte pointer. The parameter *
// ppBitStream points to the first available
// bitstream buffer byte immediately following the
// packed side information bits. The frame header
// bits are formatted according to the bitstream
// syntax given in ISO/IEC 11172-3:1993. Description
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pSrcSideInfo,
// ppBitStream, pSrcScfsi, or pFrameHeader is NULL.
// ippStsMP3FrameHeaderErr Indicates an error when
// pFrameHeader->id != IPP_MP3_ID_MPEG1
// pFrameHeader->id != IPP_MP3_ID_MPEG2
// pFrameHeader->mode exceeds [0, 3].
*/
IPPAPI(IppStatus, ippsPackSideInfo_MP3, (
IppMP3SideInfo* pSrcSideInfo,
Ipp8u** ppBitStream,
int mainDataBegin,
int privateBits,
int* pSrcScfsi,
IppMP3FrameHeader* pFrameHeader))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsPackScalefactors_MP3_8s1u
//
// Purpose:
// Applies noiseless coding to scalefactors and packs output into
// bitstream buffer.
//
// Parameters:
// pSrcScaleFactor Pointer to a vector of scalefactors generated
// during the quantization process for one channel
// of one granule. Scale factor vector lengths
// depend on the block mode. Short block granule
// scale factor vectors contain 36 elements, or
// 12 elements for each subblock. Long block
// granule scale factor vectors contain 21 elements.
// Thus short block scale factor vectors are indexed
// as follows: pSrcScaleFactor[sb*12+sfb], where
// - sb is the subblock index. 0 stands for subblock
// 1, 1 stands for subblock 2, 2 stands for subblock
// 3.
// - sfb is the scale factor band index (0-11).
// Long block scale factor vectors are indexed as
// follows:
// pSrcScaleFactor[sfb], where sfb is the scale
// factor band index (0-20).
// The associated side information for an individual
// granule/channel can be used to select the
// appropriate indexing scheme.
// ppBitStream Updated bitstream byte pointer. This parameter
// points to the first available bitstream buffer
// byte immediately following the bits generated by
// the scale factor Huffman encoder and
// sequentially written into the stream buffer. The
// scale factor bits are formatted according to the
// bitstream syntax given in ISO/IEC 11172-3.
// pOffset Updated bitstream bit pointer. The pOffset
// parameter indexes the next available bit in the
// next available byte referenced by the updated
// bitstream buffer byte pointer ppBitStream. This
// parameter is valid within the range of 0 to 7,
// where 0 corresponds to the most significant bit
// and 7 corresponds to the least significant bit.
// pFrameHeader Pointer to the IppMP3FrameHeader structure for
// this frame. Upon the function entry, the
// structure fields id and modeExt should contain,
// respectively, the algorithm id (MPEG-1 or MPEG-2
// ) and the joint stereo coding commands generated
// by the psychoacoustic model. All other
// pFrameHeader fields are ignored. Only MPEG-1 (id
// = 1) is supported.
// pSideInfo Pointer to the IppMP3SideInfo structure for the
// current granule and channel. Upon function entry
// , the structure fields blockType, mixedBlock,
// and sfCompress should contain, respectively, the
// block type indicator start, short, or stop,
// filter bank mixed block analysis mode specifier,
// and scale factor bit allocation. All other *
// pSideInfo fields are ignored by the scale factor
// encoder.
// pScfsi Pointer to the scale factor selection
// information table that contains the set of
// binary flags that indicate whether scalefactors
// are shared across granules of a frame within the
// predefined scale factor selection groups. For
// example, bands 0,1,2,3,4,5 form one group and
// bands 6,7,8,9,10 form a second group (as defined
// in ISO/IEC 11172-3). The vector is indexed as
// follows: pScfsi[ch][scfsi_band], where - ch is
// the channel index. 0 stands for channel 1, 1
// stands for channel 2. - scfsi_band is the scale
// factor selection group number. Group 0 includes
// SFBs 0-5, group 1 includes SFBs 6-10, group 2
// includes SFBs 11-15, and group 3 includes SFBs
// 16-20.
// granule Index of the current granule. 0 stands for
// granule 1, 1 stands for granule 2.
// channel Index of the current channel. 0 stands for
// channel 1, 1 stands for channel 2.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsMP3SideInfoErr Indicates an error when
// pFrameHeader->id == IPP_MP3_ID_MPEG1 and
// pSideInfo->sfCompress exceeds [0..15];
// pFrameHeader->id == IPP_MP3_ID_MPEG2 and
// pSideInfo->sfCompress exceeds [0..511].
// ippStsMP3FrameHeaderErr Indicates an error when pFrameHeader->id ==
// IPP_MP3_ID_MPEG2 and pFrameHeader->modeExt
// exceeds [0..3].
*/
IPPAPI(IppStatus, ippsPackScaleFactors_MP3_8s1u, (
const Ipp8s* pSrcScaleFactor,
Ipp8u** ppBitStream,
int* pOffset,
IppMP3FrameHeader* pFrameHeader,
IppMP3SideInfo* pSideInfo,
int* pScfsi,
int granule,
int channel))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsHuffmanEncode_MP3_32s1u
//
// Purpose:
// Applies lossless Huffman encoding to quantized samples and packs
// output into bitstream buffer.
//
// Parameters:
// pSrcIx Pointer to the quantized samples of a granule.
// The buffer length is 576. Depending on which
// type of joint coding has been applied, if any,
// the coefficient vector might be associated with
// either the L, R, M, S, and/or intensity channel
// of the quantized spectral data.
// ppBitStream Updated bitstream byte pointer. The parameter *
// ppBitStream points to the first available
// bitstream buffer byte immediately following the
// bits generated by the spectral coefficient
// Huffman encoder and sequentially written into
// the stream buffer. The Huffman symbol bits are
// formatted according to the bitstream syntax
// given in ISO/IEC 11172-3.
// pOffset Updated bitstream bit pointer. The pOffset
// parameter indexes the next available bit in the
// next available byte referenced by the updated
// bitstream buffer byte pointer ppBitStream. This
// parameter is valid within the range of 0 to 7,
// where 0 corresponds to the most significant bit
// and 7 corresponds to the least significant bit.
// pFrameHeader Pointer to the IppMP3FrameHeader structure for
// this frame. The Huffman encoder uses the frame
// header id field in connection with the side
// information (as described below) to compute the
// Huffman table region boundaries for the big
// value spectral region. The Huffman encoder
// ignores all other frame header fields.Only
// MPEG-1 (id = 1) is supported.
// pSideInfo Pointer to the IppMP3SideInfo structure for the
// current granule and channel. The structure
// elements bigVals, pTableSelect[0]-[2], reg0Cnt,
// and reg1Cnt are used to control coding of
// spectral coefficients in the big value region.
// The structure element cnt1TabSel is used to
// select the appropriate Huffman table for the (-1,
// 0,+1)-valued 4-tuples in the count1 region. For
// detailed descriptions of all side information
// elements, see the structure definition header
// file.
// count1Len The count1 region length specifier. Indicates
// the number of spectral samples for the current
// granule/channel above the big value region that
// can be combined into 4-tuples in which all
// elements are of magnitude less than or equal to 1.
// hufSize Huffman coding bit allocation specifier.
// Indicates the total number of bits that are
// required to represent the Huffman-encoded
// quantized spectral coefficients for the current
// granule/channel in both the bigvals and count1
// regions. Whenever necessary, this bit count
// should be augmented to include the number of
// bits required to manage the bit reservoir. For
// frames in which the reservoir has reached
// maximum capacity, the surplus bits are expended
// by padding with additional bits the Huffman
// representation of the spectral samples. The
// HufSize result returned by the function
// Quantize_MP3_32s_I reflects these padding
// requirements. That is, HufSize[i] is equal to
// the total of the number of bits required for
// Huffman symbols and the number of padding bits.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the specified
// pointers is NULL.
// ippStsBadArgErr Indicates an error when pOffset exceeds [0,7].
// ippStsMP3SideInfoErr Indicates an error when pSideInfo->bigVals*2>
// IPP_MP3_GRANULE_LEN (pSideInfo->reg0Cnt +
// pSideInfo->reg1Cnt + 2) >= 23, pSideInfo->
// cnt1TabSel exceeds [0,1], pSideInfo->pTableSelect
// [i] exceeds [0..31].
// ippStsMP3FrameHeader Indicates an error when
// pFrameHeader->id != IPP_MP3_ID_MPEG1
// pFrameHeader->layer != 1
// pFrameHeader->samplingFreq exceeds [0..2].
*/
IPPAPI(IppStatus, ippsHuffmanEncode_MP3_32s1u, (
Ipp32s *pSrcIx,
Ipp8u **ppBitStream,
int *pOffset,
IppMP3FrameHeader *pFrameHeader,
IppMP3SideInfo *pSideInfo,
int count1Len,
int hufSize))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsBitReservoirInit_MP3
//
// Purpose:
// Initializes all elements of the bit reservoir state structure.
//
// Parameters:
// pFrameHeader Pointer to the IppMP3FrameHeader structure that
// contains the header information associated with
// the current frame. The frame header fields
// bitRate and id, bit rate index and algorithm
// identification, respectively, must contain valid
// data prior to calling the function
// BitReservoirInit_MP3 since both are used to
// generate the bit reservoir initialization
// parameters. All other frame header parameters
// are ignored by the bit reservoir initialization
// function. Only MPEG-1 (id = 1) is supported.
// pDstBitResv Pointer to the initialized IppMP3BitReservoir
// state structure. The structure element
// BitsRemaining is initialized as 0. The structure
// element MaxBits is initialized to reflect the
// maximum number of bits that can be contained in
// the reservoir at the start of any given frame.
// The appropriate value of MaxBits is directly
// determined by the selected algorithm (MPEG-1 or
// MPEG-2) and the stream bit rate indicated by the
// rate index parameter pFrameHeader.bitRate.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pDstBitResv or
// pFrameHeader is NULL.
// ippStsMP3FrameHeaderErr Indicates an error when
// pFrameHeader->id != IPP_MP3_ID_MPEG1.
*/
IPPAPI(IppStatus, ippsBitReservoirInit_MP3, (
IppMP3BitReservoir* pDstBitResv,
IppMP3FrameHeader* pFrameHeader))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTFwd_MP3_32s
//
// Purpose:
// Implements stage 2 of the MP3 hybrid analysis filterbank.
//
// Parameters:
// pSrc Pointer to the start of the 576-element block
// PQMF analysis output vector containing 18
// consecutive blocks of 32 subband samples that
// are indexed as follows:
// pDstS[32*i+sb], where i = 0,1,...,17 is time series
// index, sb = 0,1,...,31 is the subband index. All
// coefficients are represented using the Q7.24
// format.
// pDst Pointer to the 576-element spectral coefficient
// output vector generated by the analysis
// filterbank.
// blockType Block type indicator: 0 stands for normal block;
// 1 stands for start block; 2 stands for short
// block; 3 stands for stop block.
// mixedBlock Mixed block indicator: 0 stands for not mixed; 1
// stands for mixed.
// pFrameHeader Pointer to the IppMP3FrameHeader structure that
// contains the header associated with the current
// frame. Only MPEG-1 (id = 1) is supported.
// pOverlapBuf Pointer to the MDCT overlap buffer that contains
// a copy of the most recent 576-element block of
// PQMF bank outputs. Prior to processing a new
// audio stream with the analysis filterbank, all
// elements of the buffer pOverlapBuf should be
// initialized to the constant value 0.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the pointers
// pSrcXs, pDstXr, pFrameHeader, or pOverlapBuf is
// NULL.
*/
IPPAPI(IppStatus, ippsMDCTFwd_MP3_32s, (
const Ipp32s* pSrc,
Ipp32s* pDst,
int blockType,
int mixedBlock,
IppMP3FrameHeader* pFrameHeader,
Ipp32s* pOverlapBuf))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsMDCTInvWindow_MP3_32s
//
// Purpose:
// Performs 36 or 18 points IMDCT and windowing depending on blockType.
// Parameters:
// pSrc pointer to the input buffer which is the
// output of alias reduction.
//
// pDst pointer to the output buffer of IMDCT for
// long block (36 points) and short block (18 points).
//
// blockType Block type indicator: 0 stands for normal window,
// 1 stands for start block,
// 2 stands for short block,
// 3 stands for stop block.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when one of the pointers
// pSrc or pDst is NULL.
*/
IPPAPI(IppStatus, ippsMDCTInvWindow_MP3_32s,(
Ipp32s* pSrc,
Ipp32s* pDst,
int blockType))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisPQMF_MP3_16s32s
//
// Purpose:
// Implements stage 1 of MP3 hybrid analysis filterbank.
//
// Parameters:
// pSrcPcm Pointer to the start of the buffer containing
// the input PCM audio vector. The samples conform
// to the following guidelines: - must be in 16-bit,
// signed, little-endian, Q15 format; - most
// recent 480 (512-32) samples should be contained
// in the vector pSrcPcm[pcmMode*i], where i = 0,1
// ,..,479; - samples associated with the current
// granule should be contained in the vector pSrcPcm
// [pcmMode*j], where j = 480,481,..,1055.
// pcmMode PCM mode flag. Communicates to PQMF filterbank
// the type of input PCM vector organization to
// expect: - pcmMode = 1 denotes non-interleaved
// PCM input samples; - pcmMode = 2 denotes
// interleaved PCM input samples.
// pDstS Pointer to the start of the 576-element block
// PQMF analysis output vector containing 18
// consecutive blocks of 32 subband samples under
// the following index: pDstXs[32*i + sb], where i
// = 0,1,...,17 is time series index sb = 0,1,...,31 is
// the subband index.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pSrcPcm or pDstXs is NULL.
// ippStsErr Indicates an error when pcmMode exceeds [1,2].
*/
IPPAPI(IppStatus, ippsAnalysisPQMF_MP3_16s32s, (
const Ipp16s* pSrcPcm,
Ipp32s* pDstS,
int mode))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsJointStereoEncode_MP3_32s_I
//
// Purpose:
// Transforms independent left and right channel spectral coefficient
// vectors into combined mid/side and/or intensity mode coefficient
// vectors suitable for quantization.
//
// Parameters:
// pSrcDstXrL Pointer to the 576-element joint stereo spectral
// coefficient output vector associated with the M
// channel, as well as the intensity coded
// coefficients above the intensity lower SFB bound.
// All elements are represented using the Q5.26
// format.
// pSrcDstXrR Pointer to the 576-element joint stereo spectral
// coefficient output vector associated with the S
// channel. All elements are represented using the
// Q5.26 format.
// pDstScaleFactorR Pointer to the vector of scalefactors associated
// with one granule of the right/S channel. If
// intensity coding has been enabled by the
// psychoacoustic model above a certain SFB lower
// bound, as indicated by the frame header and the
// vector pointed to by pIsSfbBound, the function
// StereoEncode_MP3_32s_I updates with the
// appropriate scalefactors those elements of
// pDstScaleFactorR[] that are associated with
// intensity coded scale factor bands. Other SFB
// entries in the scale factor vector remain
// unmodified. The length of the vector referenced
// by pDstScaleFactorR varies as a function of
// block size. The vector contains 21 elements for
// long block granules, or 36 elements for short
// block granules.
// pFrameHeader Pointer to the IppMP3FrameHeader structure that
// contains the header information associated with
// the current frame. Upon function entry, the
// structure fields samplingFreq, id, mode, and
// modeExt should contain, respectively, the sample
// rate associated with the current input audio,
// the algorithm id (MPEG-1 or MPEG-2), and the
// joint stereo coding commands generated by the
// psychoacoustic model. All other pFrameHeader
// fields are ignored. Only MPEG-1 (id = 1) is
// supported.
// pSideInfo Pointer to the pair of IppMP3SideInfo structures
// associated with the channel pair to be jointly
// encoded. The number of elements in the set is 2,
// and ordering of the set elements is as follows:
// pSideInfo[0] describes channel 1, and pSideInfo[1
// ] describes channel 2. Upon the function entry,
// the blockType side information fields for both
// channels should reflect the analysis modes (
// short or long block) selected by the
// psychoacoustic model on each channel. All other
// fields in the pSideInfo[0] and pSideInfo[1]
// structures are ignored.
// pIsSfbBound Pointer to the list of intensity coding SFB
// lower bounds for both channels of the current
// granule above which all L/R channel spectral
// coefficients are combined into an intensity-
// coded representation. The number of elements
// depends on the block type associated with the
// current granule. For short blocks, the SFB
// bounds are represented in the following order:
// pIsSfbBound[0] describes block 1, pIsSfbBound[1]
// describes block 2, and pIsSfbBound[2] describes
// block 3. For long blocks, only a single SFB
// lower bound decision is required and is
// represented in pIsSfbBound[0]. If both MS and
// intensity coding are enabled, the SFB intensity
// coding lower bound simultaneously represents the
// upper bound SFB for MS coding. If only MS coding
// is enabled, the SFB bound represents the lowest
// non-MS SFB.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers pSrcDstXrL, pSrcDstXrR, pDstScaleFactorR,
// pFrameHeader, pSideInfo, or pIsSfbBound is NULL.
// ippStsMP3SideInfoErr Indicates an error if pSideInfo[0].blockType!=
// pSideInfo[1].blockType when IS or MS is used.
*/
IPPAPI(IppStatus, ippsJointStereoEncode_MP3_32s_I, (
Ipp32s* pSrcDstXrL,
Ipp32s* pSrcDstXrR,
Ipp8s* pDstScaleFactorR,
IppMP3FrameHeader* pFrameHeader,
IppMP3SideInfo* pSideInfo,
int* pIsSfbBound))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsQuantize_MP3_32s_I
//
// Purpose:
// Quantizes spectral coefficients generated by analysis filterbank.
//
// Parameters:
// pSrcDstXrIx Pointer to the output set of quantized spectral
// coefficient vectors. These are suitable for
// input to the Huffman encoder. The coefficients
// are indexed as follows: pSrcDstXrIx[gr*1152 + ch*
// 576 + i] for stereophonic and dual-mono input
// sources, and pSrcDstXrIx[gr*576 + i] for single
// channel input sources, where: - i=0,1,...,575 is
// the spectral coefficient index; - gr is the
// granule index. 0 stands for granule 1, 1 stands
// for granule 2; - ch is the channel index. 0
// stands for channel 1, 1 stands for channel 2.
// pDstScaleFactor Pointer to the output set of
// scalefactors generated during the quantization
// process. These scalefactors determine the
// quantizer granularity. Scale factor vector
// lengths depend on the block mode associated with
// each granule. The order of the elements is: 1. (
// granule 1, channel 1); 2. (granule 1, channel 2);
// 3. (granule 2, channel 1); 4. (granule 2,
// channel 2). Given this general organization, the
// side information for each granule/channel in
// conjunction with the flags contained in the vector
// pDstScfsi can be used to determine the precise
// scale factor vector indices and lengths.
// pDstScfsi Pointer to the output vector of scale factor
// selection information. This vector contains a
// set of binary flags that indicate whether or not
// scalefactors are shared across granules of a
// frame within predefined scale factor selection
// groups. For example, bands 0,1,2,3,4,5 form one
// group; bands 6,7,8,9,10 form a second group, as
// defined in ISO/IEC 11172-3. The vector is
// indexed as follows: pDstScfsi[ch][scfsi_band],
// where: - ch is the channel index. 0 stands for
// channel 1, 1 stands for channel 2; - scfsi_band
// is the scale factor selection group number.
// Group 0 includes SFBs 0-5, group 1 includes SFBs
// 6-10, group 2 includes SFBs 11-15, and group 3
// includes SFBs 16-20.
// pDstCount1Len Pointer to an output vector of count1 region
// length specifiers. For the purposes of Huffman
// coding spectral coefficients of a higher
// frequency than the bigvals region, the count1
// parameter indicates the size of the region in
// which spectral samples can be combined into
// quadruples for which all elements are of
// magnitude less than or equal to 1. The vector
// contains 2*nchan, elements and is indexed as
// follows: pDstCount1Len[gr*nchan + ch], where: -
// gr is the granule index. 0 stands for granule 1,
// 1 stands for granule 2; - nchan is the number of
// channels; - ch is the channel index. 0 stands
// for channel 1, 1 stands for channel 2.
// pDstHufSize Pointer to an output vector of Huffman coding
// bit allocation specifiers. For each granule/
// channel, the specifiers indicate the total
// number of Huffman bits required to represent the
// quantized spectral coefficients in the bigvals
// and count1 regions. Whenever necessary, each
// HufSize bit count is augmented to include the
// number of bits required to manage the bit
// reservoir. For frames in which the reservoir has
// reached the maximum capacity, the quantizer
// expends the surplus bits by padding with
// additional bits the Huffman representation of
// the spectral samples. The HufSize result
// returned by the quantizer reflects these padding
// requirements. That is, HufSize[i] is equal to
// the sum of the number of bits required for
// Huffman symbols and the number of padding bits.
// The vector contains 2*nchan, elements and is
// indexed as follows: pDstHufSize[gr*nchan+ch],
// where: - gr is the granule index. 0 stands for
// granule 1, 1 stands for granule 2; - nchan is
// the number of channels; - ch is the channel index.
// 0 stands for channel 1, 1 stands for channel 2.
// pFrameHeader Pointer to the IppMP3FrameHeader structure that
// contains the header information associated with
// the current frame. Upon the function entry, the
// structure fields samplingFreq, id, mode, and
// modeExt should contain, respectively, the sample
// rate associated with the current input audio,
// the algorithm id, that is, MPEG-1 or MPEG-2, and
// the joint stereo coding commands generated by
// the psychoacoustic model. All other *
// pFrameHeader fields are ignored. Only MPEG-1 (id
// = 1) is supported.
// pSideInfo Pointer to the set of IppMP3SideInfo structures
// associated with all granules and channels. The
// set should contain 2*nchan, elements and should
// be indexed as follows: pSideInfo[gr*nchan + ch],
// where: - gr is the granule index. 0 stands for
// granule 1, 1 stands for granule 2; - nchan is
// the number of channels; - ch is the channel index.
// 0 stands for channel 1, 1 stands for channel 2.
// Upon the function entry, in all set elements
// the structure fields blockType, mixedBlock, and
// winSwitch should contain, respectively, the
// block type indicator (start, short, or stop),
// filter bank mixed block analysis mode specifier,
// and window switching flags (normal
// or blockType) associated with the current
// input audio. All other *pSideInfo fields are
// ignored upon the function entry and updated upon
// function exit, as described below under the
// description of output arguments.
// pPsychoInfo Pointer to the first element in a set of
// PsychoacousticModelTwoAnalysis structures
// associated with the current frame. Each set
// member contains the MSR and PE estimates for one
// channel of one granule. The set should contain 2*
// nchan, elements and is indexed as: pPsychoaInfo[
// gr*nchan+ ch], where: - gr is the granule index.
// 0 stands for granule 1, 1 stands for granule 2;
// - nchan is the number of channels; - ch is the
// channel index. 0 stands for channel 1, 1 stands
// for channel 2.
// pFramePsyState Pointer to the first element in a set of
// IppMP3PsychoacousticModelTwoState structures
// that contains the psychoacoustic model state
// information associated with both the current
// frame and next frame. The number of elements in
// the set is equal to the number of channels
// contained in the input audio. That is, a
// separate analysis is carried for each channel.
// The quantizer uses the frame type look ahead
// information nextBlockType to manage the bit
// reservoir. All other structure elements are
// ignored by the quantizer.
// pResv Pointer to the updated IppMP3BitReservoir
// structure. The quantizer updates the
// BitsRemaining field to add or remove bits as
// necessary. All other fields are unmodified by
// the quantizer.
// meanBits The number of bits allocated on an average basis
// for each frame of spectral coefficients and
// scalefactors given the target bit rate (kilobits
// per second) specified in the frame header. This
// number excludes the bits allocated for the frame
// header and side information. The quantizer uses
// meanBits as a target allocation for the current
// frame. Given perceptual bit allocation
// requirements greater than this target, the
// quantizer makes use of the surplus bits held in
// the bit reservoir to satisfy frame-instantaneous
// demands. Similarly, given perceptual bit
// allocation requirements below this target, the
// quantizer will store surplus bits in the bit
// reservoir for use by future frames.
// pIsSfbBound Pointer to the list of SFB lower bounds above
// which all L/R channel spectral coefficients have
// been combined into an intensity-coded
// representation. The number of valid elements
// pointed to by pIsSfbBound
// depends upon the block types associated with the
// granules of the current frame. In particular,
// the list of SFB bounds pointed to by pIsSfbBound
// is indexed as follows: pIsSfbBound[3*gr] for
// long block granules, and pIsSfbBound[3*gr + w]
// for short block granules, where: - gr is the
// granule index. 0 stands for granule 1, 1 stands
// for granule 2; - w is the block index. 0 stands
// for block 1, 1 stands for block 2, 2 stands for
// block 3. For example, given short-block analysis
// in granule 1 followed by long block analysis in
// granule 2, the list of SFB bounds would be
// expected in the following order: pIsSfbBound[] =
// {granule 1/block 1, granule 1/block 2, granule 1/
// block 2, granule 2/long block}. If a granule is
// configured for long block analysis, then only a
// single SFB lower bound decision is expected,
// whereas three are expected for short block
// granules. If both MS and intensity coding have
// been enabled, then the SFB intensity coding
// lower bound simultaneously represents the upper
// bound SFB for MS coding. If only MS coding has
// been enabled, then the SFB bound represents the
// lowest non-MS SFB.
// pWorkBuffer Pointer to the workspace buffer internally used
// by the quantizer for storage of intermediate
// results and other temporary data. The buffer
// length should be at least 2880 bytes, that is,
// 720 words of 32-bits each.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pSrcDstXrIx,
// pDstScaleFactor, pDstScfsi, pDstCount1Len,
// pDstHufSize, pFrameHeader, pSideInfo, pPsychInfo,
// pFramePsyState, pResv, pIsSfbBound, or
// pWorkBuffer is NULL.
// ippStsMP3SideInfo Indicates an error when pSideInfo->winSwitch and
// pSideInfo->mixedBlock are both defined.
// ippStsMP3FrameHeaderErr Indicates an error when pFrameHeader->samplingFreq or
// pFrameHeader->id is not correct.
*/
IPPAPI(IppStatus, ippsQuantize_MP3_32s_I, (
Ipp32s* pSrcDstXrIx,
Ipp8s* pDstScaleFactor,
int* pDstScfsi,
int* pDstCount1Len,
int* pDstHufSize,
IppMP3FrameHeader* pFrameHeader,
IppMP3SideInfo* pSideInfo,
IppMP3PsychoacousticModelTwoAnalysis* pPsychInfo,
IppMP3PsychoacousticModelTwoState* pFramePsyState,
IppMP3BitReservoir* pResv,
int meanBits,
int* pIsSfbBound,
Ipp32s* pWorkBuffer))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsPsychoacousticModelTwo_MP3_16s
//
// Purpose:
// Implements ISO/IEC 11172-3 psychoacoustic model recommendation 2 to
// estimate masked threshold and perceptual entropy associated with a
// block of PCM audio input.
//
// Parameters:
// pSrcPcm Pointer to the start of the buffer containing
// the input PCM audio vector, the samples of which
// should conform to the following format
// specification: - 16-bits per sample, signed,
// little-endian, Q15; - pSrcPcm buffer should
// contain 1152 samples, that is, two granules of
// 576 samples each, if the parameter pFrameHeader
// -> mode has the value 1 (mono), or 2304 samples,
// that is, two granules of 576 samples each, if
// the parameter pFrameHeader -> mode has the value
// of 2 (stereo, dual mono); - In the stereophonic
// case, the PCM samples associated with the left
// and right channels should be organized according
// to the pcmMode flag. Failure to satisfy any of
// the above PCM format and/or buffer requirements
// results in undefined model outputs.
// pDstPsyInfo Pointer to the first element in a
// set of PsychoacousticModelTwoAnalysis structures.
// Each set member contains the MSR and PE
// estimates for one granule. The number of
// elements in the set is equal to the number of
// channels, with the outputs arranged as follows: (
// Analysis[0] = granule 1, channel 1), (...Analysis[1]
// = granule 1, channel 2), (...Analysis[2] =
// granule 2, channel 1), (...Analysis[3] = granule 2,
// channel 2).
// pDstIsSfbBound If intensity coding has been enabled,
// pDstIsSfbBound points to the list of SFB lower
// bounds above which all spectral coefficients
// should be processed by the joint stereo
// intensity coding module. Since the intensity
// coding SFB lower bound is block-specific, the
// number of valid elements pointed to by
// pDstIsSfbBound varies depending upon the
// individual block types associated with each
// granule. In particular, the list of SFB bounds
// is indexed as follows: - pIsSfbBound[3*gr] for
// long block granules; - pIsSfbBound[3*gr + w] for
// short block granules, where gr is the granule
// index (0 indicates granule 1 and 1 indicates
// granule 2), and w is the block index (0
// indicates block 1, 1 indicates block 2, 2
// indicates block 3). For example, given short-
// block analysis in granule 1 followed by long
// block analysis in granule 2, the list of SFB:
// bounds would be generated in the following order
// pIsSfbBound[] = {granule 1/block 1, granule 1/
// block 2, granule 1/block 2, granule 2/long
// block}. Only one SFB lower bound decision is
// generated for long block granules, whereas three
// are generated for short block granules. If both
// MS and intensity coding are enabled, then the
// SFB intensity coding lower bound simultaneously
// represents the upper bound SFB for MS coding. If
// only MS coding has been enabled, then the SFB
// bound represents the lowest non-MS SFB.
// pDstSideInfo Pointer to the updated set of IppMP3SideInfo
// structures associated with all granules and
// channels. The model updates the following fields
// in all set elements: blockType, winSwitch, and
// mixedBlock. The number of elements in the set is
// equal to 2 times the number of channels.
// Ordering of the set elements is the same as
// pDstPsyInfo.
// pFrameHeader Pointer to the IppMP3FrameHeader structure that
// contains the header associated with the current
// frame. The samplingFreq, id, and mode fields of
// the structure pFrameHeader control the behavior
// of the psychoacoustic model. All three fields
// must be appropriately initialized prior to
// calling this function. All other frame header
// fields are ignored. Only MPEG-1 (id = 1) is
// supported.
// pFramePsyState Pointer to the first element in a set of
// IppMP3PsychoacousticModelTwoState structures
// that contains the updated psychoacoustic model
// state information associated with both the
// current frame and next frame. The number of
// elements in the set is equal to the number of
// channels contained in the input audio. That is,
// a separate analysis is carried for each channel.
// Prior to encoding a new audio stream, all
// elements of the psychoacoustic model state
// structure pPsychoacousticModelState should be
// initialized to contain the value 0. In the
// signal processing domain, this could be
// accomplished using the function ippsZero_16s as
// follows: ippsZero_16s ((Ipp16s *)
// pPsychoacousticModelState,sizeof(
// IppMP3PsychoacousticModelTwoState)
// /sizeof(Ipp16s)).
// pcmMode PCM mode flag. Communicates the psychoacoustic
// model which type of PCM vector organization to
// expect: - pcmMode = 1 denotes non-interleaved
// PCM input samples, that is, pSrcPcm[0..1151]
// contains the input samples associated with the
// left channel, and pSrcPcm[1152..2303] contains
// the input samples associated with the right
// channel; - pcmMode = 2 denotes interleaved PCM
// input samples, that is, pSrcPcm[2*i] and pSrcPcm[
// 2*i+1] contain the samples associated with the
// left and right channels, respectively, where i =
// 0,1,...,1151. You can also use appropriately
// typecast elements ippMP3NonInterleavedPCM and
// ippMP3InterleavedPCM of the enumerated type
// IppMP3PcmMode as an alternative to the constants
// 1 and 2 for pcmMode.
// pWorkBuffer Pointer to the workspace buffer internally used
// by the psychoacoustic model for storage of
// intermediate results and other temporary data.
// The buffer length must be at least 25,200 bytes,
// that is, 6300 elements of type Ipp32s.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when at least one of the
// pointers pSrcPcm, pDstPsyInfo, pDstSideInfo,
// pDstIsSfbBound, pFrameHeader, pDstPsyState, or
// pWorkBuffer is NULL.
*/
IPPAPI(IppStatus, ippsPsychoacousticModelTwo_MP3_16s, (
const Ipp16s* pSrcPcm,
IppMP3PsychoacousticModelTwoAnalysis* pDstPsyInfo,
int* pDstIsSfbBound,
IppMP3SideInfo* pDstSideInfo,
IppMP3FrameHeader* pFrameHeader,
IppMP3PsychoacousticModelTwoState* pFramePsyState,
int pcmMode,
Ipp32s* pWorkBuffer))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilter_PQMF_MP3_32f
//
// Purpose:
// Transforms PQMF MP3-processed subband signals into time domain samples.
//
// Parameters:
// pSrc Array of pointers, holds PQMF MP3-processed subband
// signals.
// pDst Pointer to the output vector, holds time domain
// output samples.
// pFilterSpec Pointer to the IppsFilterSpec_PQMF_MP3 specification
// structure.
// mode Flag that indicates whether or not MP3 audio
// output channels should be interleaved.
// 1 - indicates not interleaved,
// 2 - indicates interleaved.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
// ippStsBadArgErr Indicates an error when mode exceeds [1, 2].
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI(IppStatus, ippsSynthesisFilter_PQMF_MP3_32f, (const Ipp32f *pSrc,
Ipp32f *pDst,
const IppsFilterSpec_PQMF_MP3 *pFilterSpec,
int mode))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterGetSize_PQMF_MP3_32f
//
// Purpose:
// Returns size of IppsFilterSpec_PQMF_MP3 specification structure.
//
// Parameters:
// pSizeSpec Address of the IppsFilterSpec_PQMF_MP3 specification
// structure size value in bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pSizeSpec is NULL.
*/
IPPAPI(IppStatus, ippsSynthesisFilterGetSize_PQMF_MP3_32f, (int *pSizeSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterInit_PQMF_MP3_32f
//
// Purpose:
// Initializes synthesis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the IppsFilterSpec_PQMF_MP3
// specification structure is written. Only the
// main function uses this structure.
// pMemSpec Pointer to the area for the IppsFilterSpec_PQMF_MP3
// specification structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
*/
IPPAPI(IppStatus, ippsSynthesisFilterInit_PQMF_MP3_32f, (IppsFilterSpec_PQMF_MP3 **ppFilterSpec,
Ipp8u *pMemSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterInitAlloc_PQMF_MP3_32f
//
// Purpose:
// Allocate memory for synthesis specification structure and initializes it.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the IppsFilterSpec_PQMF_MP3
// specification structure is written.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when ppFilterSpec is NULL.
*/
IPPAPI(IppStatus, ippsSynthesisFilterInitAlloc_PQMF_MP3_32f, (IppsFilterSpec_PQMF_MP3 **ppFilterSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterFree_PQMF_MP3_32f
//
// Purpose:
// Frees memory allocated for internal IppsFilterSpec_PQMF_MP3 structure.
//
// Parameters:
// pFilterSpec Pointer to the IppsFilterSpec_PQMF_MP3 specification
// structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pFilterSpec is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI(IppStatus, ippsSynthesisFilterFree_PQMF_MP3_32f, (IppsFilterSpec_PQMF_MP3 *pFilterSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilter_PQMF_MP3_32f
//
// Purpose:
// Transforms time domain samples into PQMF MP3-processed subband signals .
//
// Parameters:
// pSrc Array of pointers, holds PQMF MP3-processed subband
// signals.
// pDst Pointer to the output vector, holds time domain
// output samples.
// pFilterSpec Pointer to the IppsFilterSpec_PQMF_MP3 specification
// structure.
// mode Flag that indicates whether or not MP3 audio
// output channels should be interleaved.
// 1 - indicates not interleaved,
// 2 - indicates interleaved.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
// ippStsBadArgErr Indicates an error when mode exceeds [1, 2].
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI(IppStatus, ippsAnalysisFilter_PQMF_MP3_32f, (const Ipp32f *pSrc,
Ipp32f *pDst,
const IppsFilterSpec_PQMF_MP3 *pFilterSpec,
int mode))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterGetSize_PQMF_MP3_32f
//
// Purpose:
// Returns size of IppsFilterSpec_PQMF_MP3 specification structure.
//
// Parameters:
// pSizeSpec Address of the IppsFilterSpec_PQMF_MP3 specification
// structure size value in bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pSizeSpec is NULL.
*/
IPPAPI(IppStatus, ippsAnalysisFilterGetSize_PQMF_MP3_32f, (int *pSizeSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterInit_PQMF_MP3_32f
//
// Purpose:
// Initializes analysis specification structure.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the IppsFilterSpec_PQMF_MP3
// specification structure is written. Only the
// main function uses this structure.
// pMemSpec Pointer to the area for the IppsFilterSpec_PQMF_MP3
// specification structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
*/
IPPAPI(IppStatus, ippsAnalysisFilterInit_PQMF_MP3_32f, (IppsFilterSpec_PQMF_MP3 **ppFilterSpec,
Ipp8u *pMemSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterInitAlloc_PQMF_MP3_32f
//
// Purpose:
// Allocate memory for analysis specification structure and initializes it.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the IppsFilterSpec_PQMF_MP3
// specification structure is written.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when ppFilterSpec is NULL.
*/
IPPAPI(IppStatus, ippsAnalysisFilterInitAlloc_PQMF_MP3_32f, (IppsFilterSpec_PQMF_MP3 **ppFilterSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsAnalysisFilterFree_PQMF_MP3_32f
//
// Purpose:
// Frees memory allocated for internal IppsFilterSpec_PQMF_MP3 structure.
//
// Parameters:
// pFilterSpec Pointer to the IppsFilterSpec_PQMF_MP3 specification
// structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pFilterSpec is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI(IppStatus, ippsAnalysisFilterFree_PQMF_MP3_32f, (IppsFilterSpec_PQMF_MP3 *pFilterSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilter_DTS_32f
//
// Purpose:
// Transforms QMF DTS processed subband signals into time domain samples.
//
// Parameters:
// pSrc Array of pointers, holds QMF DTS processed subband
// signals.
// pDst Pointer to the output vector, holds time domain
// output samples.
// pFilterSpec Pointer to the IppsFilterSpec_DTS_32f specification
// structure.
// filtType Flag, indicates filter bank.
// IPPAC_DTS_PERFECT - perfect reconstruction
// IPPAC_DTS_NONPERFECT - nonperfect reconstruction.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
// ippStsBadArgErr Indicates an error when filtType is neither
// IPPAC_DTS_PERFECT nor IPPAC_DTS_NONPERFECT.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI(IppStatus, ippsSynthesisFilter_DTS_32f, (const Ipp32f *pSrc,
Ipp32f *pDst,
Ipp32s filt_type,
const IppsFilterSpec_DTS_32f *pFilterSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterGetSize_DTS_32f
//
// Purpose:
// Returns size of IppsFilterSpec_DTS_32f specification structure.
//
// Parameters:
// pSizeSpec Address of the IppsFilterSpec_DTS_32f specification
// structure size value in bytes.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pSizeSpec is NULL.
*/
IPPAPI(IppStatus, ippsSynthesisFilterGetSize_DTS_32f, (int *pSizeSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterInit_DTS_32f
//
// Purpose:
// Initializes DTS synthesis specification structure.
//
// Parameters:
// pFilterSpec Pointer to the IppsFilterSpec_DTS_32f
// specification structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when any of the specified
// pointers is NULL.
*/
IPPAPI(IppStatus, ippsSynthesisFilterInit_DTS_32f, (IppsFilterSpec_DTS_32f *pFilterSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterInitAlloc_DTS_32f
//
// Purpose:
// Allocate memory for synthesis specification structure and initializes it.
//
// Parameters:
// ppFilterSpec Pointer to where pointer to the IppsFilterSpec_DTS_32f
// specification structure is written.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when ppFilterSpec is NULL.
*/
IPPAPI(IppStatus, ippsSynthesisFilterInitAlloc_DTS_32f, (IppsFilterSpec_DTS_32f **ppFilterSpec))
/* ///////////////////////////////////////////////////////////////////////////
// Name:
// ippsSynthesisFilterFree_DTS_32f
//
// Purpose:
// Frees memory allocated for internal IppsFilterSpec_DTS_32f structure.
//
// Parameters:
// pFilterSpec Pointer to the IppsFilterSpec_DTS_32f specification
// structure.
//
// Returns:
// ippStsNoErr Indicates no error.
// ippStsNullPtrErr Indicates an error when pFilterSpec is NULL.
// ippStsContextMatchErr Indicates an error when the identifier
// pFilterSpec is incorrect.
*/
IPPAPI(IppStatus, ippsSynthesisFilterFree_DTS_32f, (IppsFilterSpec_DTS_32f *pFilterSpec))
#ifdef __cplusplus
}
#endif
#if defined (_IPP_STDCALL_CDECL)
#undef _IPP_STDCALL_CDECL
#define __stdcall __cdecl
#endif
#endif /* #if !defined(__IPPAC_H__ ) || defined(_OWN_BLDPCS ) */