summaryrefslogtreecommitdiffstats
path: root/libPCMutils
diff options
context:
space:
mode:
authorMatthias P. Braendli <matthias.braendli@mpb.li>2016-09-10 20:15:44 +0200
committerMatthias P. Braendli <matthias.braendli@mpb.li>2016-09-10 20:15:44 +0200
commit14c7b800eaa23e9da7c92c7c4df397d0c191f097 (patch)
treed840b6ec41ff74d1184ca1dcd7731d08f1e9ebbb /libPCMutils
parent78a801e4d716c6f2403cc56cf6c5b6f138f24b2f (diff)
downloadODR-AudioEnc-14c7b800eaa23e9da7c92c7c4df397d0c191f097.tar.gz
ODR-AudioEnc-14c7b800eaa23e9da7c92c7c4df397d0c191f097.tar.bz2
ODR-AudioEnc-14c7b800eaa23e9da7c92c7c4df397d0c191f097.zip
Remove FDK-AAC
Diffstat (limited to 'libPCMutils')
-rw-r--r--libPCMutils/include/pcmutils_lib.h282
-rw-r--r--libPCMutils/src/pcmutils_lib.cpp1278
2 files changed, 0 insertions, 1560 deletions
diff --git a/libPCMutils/include/pcmutils_lib.h b/libPCMutils/include/pcmutils_lib.h
deleted file mode 100644
index 5ba74be..0000000
--- a/libPCMutils/include/pcmutils_lib.h
+++ /dev/null
@@ -1,282 +0,0 @@
-
-/* -----------------------------------------------------------------------------------------------------------
-Software License for The Fraunhofer FDK AAC Codec Library for Android
-
-© Copyright 1995 - 2013 Fraunhofer-Gesellschaft zur Förderung der angewandten Forschung e.V.
- All rights reserved.
-
- 1. INTRODUCTION
-The Fraunhofer FDK AAC Codec Library for Android ("FDK AAC Codec") is software that implements
-the MPEG Advanced Audio Coding ("AAC") encoding and decoding scheme for digital audio.
-This FDK AAC Codec software is intended to be used on a wide variety of Android devices.
-
-AAC's HE-AAC and HE-AAC v2 versions are regarded as today's most efficient general perceptual
-audio codecs. AAC-ELD is considered the best-performing full-bandwidth communications codec by
-independent studies and is widely deployed. AAC has been standardized by ISO and IEC as part
-of the MPEG specifications.
-
-Patent licenses for necessary patent claims for the FDK AAC Codec (including those of Fraunhofer)
-may be obtained through Via Licensing (www.vialicensing.com) or through the respective patent owners
-individually for the purpose of encoding or decoding bit streams in products that are compliant with
-the ISO/IEC MPEG audio standards. Please note that most manufacturers of Android devices already license
-these patent claims through Via Licensing or directly from the patent owners, and therefore FDK AAC Codec
-software may already be covered under those patent licenses when it is used for those licensed purposes only.
-
-Commercially-licensed AAC software libraries, including floating-point versions with enhanced sound quality,
-are also available from Fraunhofer. Users are encouraged to check the Fraunhofer website for additional
-applications information and documentation.
-
-2. COPYRIGHT LICENSE
-
-Redistribution and use in source and binary forms, with or without modification, are permitted without
-payment of copyright license fees provided that you satisfy the following conditions:
-
-You must retain the complete text of this software license in redistributions of the FDK AAC Codec or
-your modifications thereto in source code form.
-
-You must retain the complete text of this software license in the documentation and/or other materials
-provided with redistributions of the FDK AAC Codec or your modifications thereto in binary form.
-You must make available free of charge copies of the complete source code of the FDK AAC Codec and your
-modifications thereto to recipients of copies in binary form.
-
-The name of Fraunhofer may not be used to endorse or promote products derived from this library without
-prior written permission.
-
-You may not charge copyright license fees for anyone to use, copy or distribute the FDK AAC Codec
-software or your modifications thereto.
-
-Your modified versions of the FDK AAC Codec must carry prominent notices stating that you changed the software
-and the date of any change. For modified versions of the FDK AAC Codec, the term
-"Fraunhofer FDK AAC Codec Library for Android" must be replaced by the term
-"Third-Party Modified Version of the Fraunhofer FDK AAC Codec Library for Android."
-
-3. NO PATENT LICENSE
-
-NO EXPRESS OR IMPLIED LICENSES TO ANY PATENT CLAIMS, including without limitation the patents of Fraunhofer,
-ARE GRANTED BY THIS SOFTWARE LICENSE. Fraunhofer provides no warranty of patent non-infringement with
-respect to this software.
-
-You may use this FDK AAC Codec software or modifications thereto only for purposes that are authorized
-by appropriate patent licenses.
-
-4. DISCLAIMER
-
-This FDK AAC Codec software is provided by Fraunhofer on behalf of the copyright holders and contributors
-"AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, including but not limited to the implied warranties
-of merchantability and fitness for a particular purpose. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
-CONTRIBUTORS BE LIABLE for any direct, indirect, incidental, special, exemplary, or consequential damages,
-including but not limited to procurement of substitute goods or services; loss of use, data, or profits,
-or business interruption, however caused and on any theory of liability, whether in contract, strict
-liability, or tort (including negligence), arising in any way out of the use of this software, even if
-advised of the possibility of such damage.
-
-5. CONTACT INFORMATION
-
-Fraunhofer Institute for Integrated Circuits IIS
-Attention: Audio and Multimedia Departments - FDK AAC LL
-Am Wolfsmantel 33
-91058 Erlangen, Germany
-
-www.iis.fraunhofer.de/amm
-amm-info@iis.fraunhofer.de
------------------------------------------------------------------------------------------------------------ */
-
-/************************ FDK PCM up/downmixing module *********************
-
- Author(s): Christian Griebel
- Description: Declares functions to interface with the PCM downmix processing
- module.
-
-*******************************************************************************/
-
-#ifndef _PCMUTILS_LIB_H_
-#define _PCMUTILS_LIB_H_
-
-#include "machine_type.h"
-#include "common_fix.h"
-#include "FDK_audio.h"
-
-/* ------------------------ *
- * MODULE SETTINGS: *
- * ------------------------ */
-/* #define PCM_UPMIX_ENABLE */ /*!< Generally enable up mixing. */
-#define PCM_DOWNMIX_ENABLE /*!< Generally enable down mixing. */
-#define DVB_MIXDOWN_ENABLE /*!< Enable this to support DVB ancillary data for encoder
- assisted downmixing of MPEG-4 AAC and
- MPEG-1/2 layer 2 streams. PCM_DOWNMIX_ENABLE has to
- be enabled, too! */
-#define MPEG_PCE_MIXDOWN_ENABLE /*!< Enable this to support MPEG matrix mixdown with a
- coefficient carried in the PCE. PCM_DOWNMIX_ENABLE
- has to be enabled, too! */
-/* #define ARIB_MIXDOWN_ENABLE */ /*!< Enable modifications to the MPEG PCE mixdown method
- to fulfill ARIB standard. MPEG_PCE_MIXDOWN_ENABLE has
- to be set. */
-
-/* ------------------------ *
- * ERROR CODES: *
- * ------------------------ */
-typedef enum
-{
- PCMDMX_OK = 0x0, /*!< No error happened. */
- PCMDMX_OUT_OF_MEMORY = 0x2, /*!< Not enough memory to set up an instance of the module. */
- PCMDMX_UNKNOWN = 0x5, /*!< Error condition is of unknown reason, or from a third
- party module. */
- PCMDMX_INVALID_HANDLE, /*!< The given instance handle is not valid. */
- PCMDMX_INVALID_ARGUMENT, /*!< One of the parameters handed over is invalid. */
- PCMDMX_INVALID_CH_CONFIG, /*!< The given channel configuration is not supported and
- thus no processing was performed. */
- PCMDMX_INVALID_MODE, /*!< The set configuration/mode is not applicable. */
- PCMDMX_UNKNOWN_PARAM, /*!< The handed parameter is not known/supported. */
- PCMDMX_UNABLE_TO_SET_PARAM, /*!< Unable to set the specific parameter. Most probably
- the value ist out of range. */
- PCMDMX_CORRUPT_ANC_DATA /*!< The read ancillary data was corrupt. */
-
-} PCMDMX_ERROR;
-
-
-/* ------------------------ *
- * RUNTIME PARAMS: *
- * ------------------------ */
-typedef enum
-{
- DMX_BS_DATA_EXPIRY_FRAME, /*!< The number of frames without new metadata that have to
- go by before the bitstream data expires. The value 0
- disables expiry. */
- DMX_BS_DATA_DELAY, /*!< The number of delay frames of the output samples
- compared to the bitstream data. */
- NUMBER_OF_OUTPUT_CHANNELS , /*!< The number of output channels (equals the number of
- channels processed by the audio output setup). */
- DUAL_CHANNEL_DOWNMIX_MODE /*!< Downmix mode for two channel audio data. */
-
-} PCMDMX_PARAM;
-
-
-typedef enum
-{
- STEREO_MODE = 0x0, /*!< Leave stereo signals as they are. */
- CH1_MODE = 0x1, /*!< Create a dual mono output signal from channel 1. */
- CH2_MODE = 0x2, /*!< Create a dual mono output signal from channel 2. */
- MIXED_MODE = 0x3 /*!< Create a dual mono output signal by mixing the two channels. */
-
-} DUAL_CHANNEL_MODE;
-
-
-/* ------------------------ *
- * MODULES INTERFACE: *
- * ------------------------ */
-typedef struct PCM_DMX_INSTANCE *HANDLE_PCM_DOWNMIX;
-
-/* Modules reset flags */
-#define PCMDMX_RESET_PARAMS ( 1 )
-#define PCMDMX_RESET_BS_DATA ( 2 )
-#define PCMDMX_RESET_FULL ( PCMDMX_RESET_PARAMS | PCMDMX_RESET_BS_DATA )
-
-#ifdef __cplusplus
-extern "C"
-{
-#endif
-
-/** Open and initialize an instance of the PCM downmix module
- * @param [out] Pointer to a buffer receiving the handle of the new instance.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_Open (
- HANDLE_PCM_DOWNMIX *pSelf
- );
-
-/** Set one parameter for one instance of the PCM downmix module.
- * @param [in] Handle of PCM downmix instance.
- * @param [in] Parameter to be set.
- * @param [in] Parameter value.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_SetParam (
- HANDLE_PCM_DOWNMIX self,
- PCMDMX_PARAM param,
- UINT value
- );
-
-/** Read the ancillary data transported in DSEs of DVB streams with MPEG-4 content
- * @param [in] Handle of PCM downmix instance.
- * @param [in] Pointer to ancillary data buffer.
- * @param [in] Size of ancillary data.
- * @param [in] Flag indicating wheter the ancillary data is from a MPEG-1/2 or an MPEG-4 stream.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_ReadDvbAncData (
- HANDLE_PCM_DOWNMIX self,
- UCHAR *pAncDataBuf,
- UINT ancDataBytes,
- int isMpeg2
- );
-
-/** Set the matrix mixdown information extracted from the PCE of an AAC bitstream.
- * Note: Call only if matrix_mixdown_idx_present is true.
- * @param [in] Handle of PCM downmix instance.
- * @param [in] Matrix mixdown index present flag extracted from PCE.
- * @param [in] The 2 bit matrix mixdown index extracted from PCE.
- * @param [in] The pseudo surround enable flag extracted from PCE.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_SetMatrixMixdownFromPce (
- HANDLE_PCM_DOWNMIX self,
- int matrixMixdownPresent,
- int matrixMixdownIdx,
- int pseudoSurroundEnable
- );
-
-/** Reset the module.
- * @param [in] Handle of PCM downmix instance.
- * @param [in] Flags telling which parts of the module shall be reset.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_Reset (
- HANDLE_PCM_DOWNMIX self,
- UINT flags
- );
-
-/** Apply down or up mixing.
- *
- * \param [in] Handle of PCM downmix module instance.
- * \param [inout] Pointer to time buffer with decoded PCM samples.
- * \param [in] Pointer where the amount of output samples is returned into.
- * \param [inout] Pointer where the amount of output channels is returned into.
- * \param [in] Flag which indicates if output time data are writtern interleaved or as subsequent blocks.
- * \param [inout] Array were the corresponding channel type for each output audio channel is stored into.
- * \param [inout] Array were the corresponding channel type index for each output audio channel is stored into.
- * \param [in] Array containing the output channel mapping to be used (From MPEG PCE ordering to whatever is required).
- *
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_ApplyFrame (
- HANDLE_PCM_DOWNMIX self,
- INT_PCM *pPcmBuf,
- UINT frameSize,
- INT *nChannels,
-
- int fInterleaved,
- AUDIO_CHANNEL_TYPE channelType[],
- UCHAR channelIndices[],
- const UCHAR channelMapping[][8]
- );
-
-/** Close an instance of the PCM downmix module.
- * @param [inout] Pointer to a buffer containing the handle of the instance.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_Close (
- HANDLE_PCM_DOWNMIX *pSelf
- );
-
-/** Get library info for this module.
- * @param [out] Pointer to an allocated LIB_INFO structure.
- * @returns Returns an error code.
- */
-PCMDMX_ERROR pcmDmx_GetLibInfo( LIB_INFO *info );
-
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* _PCMUTILS_LIB_H_ */
diff --git a/libPCMutils/src/pcmutils_lib.cpp b/libPCMutils/src/pcmutils_lib.cpp
deleted file mode 100644
index a84a050..0000000
--- a/libPCMutils/src/pcmutils_lib.cpp
+++ /dev/null
@@ -1,1278 +0,0 @@
-
-/* -----------------------------------------------------------------------------------------------------------
-Software License for The Fraunhofer FDK AAC Codec Library for Android
-
-© Copyright 1995 - 2013 Fraunhofer-Gesellschaft zur Förderung der angewandten Forschung e.V.
- All rights reserved.
-
- 1. INTRODUCTION
-The Fraunhofer FDK AAC Codec Library for Android ("FDK AAC Codec") is software that implements
-the MPEG Advanced Audio Coding ("AAC") encoding and decoding scheme for digital audio.
-This FDK AAC Codec software is intended to be used on a wide variety of Android devices.
-
-AAC's HE-AAC and HE-AAC v2 versions are regarded as today's most efficient general perceptual
-audio codecs. AAC-ELD is considered the best-performing full-bandwidth communications codec by
-independent studies and is widely deployed. AAC has been standardized by ISO and IEC as part
-of the MPEG specifications.
-
-Patent licenses for necessary patent claims for the FDK AAC Codec (including those of Fraunhofer)
-may be obtained through Via Licensing (www.vialicensing.com) or through the respective patent owners
-individually for the purpose of encoding or decoding bit streams in products that are compliant with
-the ISO/IEC MPEG audio standards. Please note that most manufacturers of Android devices already license
-these patent claims through Via Licensing or directly from the patent owners, and therefore FDK AAC Codec
-software may already be covered under those patent licenses when it is used for those licensed purposes only.
-
-Commercially-licensed AAC software libraries, including floating-point versions with enhanced sound quality,
-are also available from Fraunhofer. Users are encouraged to check the Fraunhofer website for additional
-applications information and documentation.
-
-2. COPYRIGHT LICENSE
-
-Redistribution and use in source and binary forms, with or without modification, are permitted without
-payment of copyright license fees provided that you satisfy the following conditions:
-
-You must retain the complete text of this software license in redistributions of the FDK AAC Codec or
-your modifications thereto in source code form.
-
-You must retain the complete text of this software license in the documentation and/or other materials
-provided with redistributions of the FDK AAC Codec or your modifications thereto in binary form.
-You must make available free of charge copies of the complete source code of the FDK AAC Codec and your
-modifications thereto to recipients of copies in binary form.
-
-The name of Fraunhofer may not be used to endorse or promote products derived from this library without
-prior written permission.
-
-You may not charge copyright license fees for anyone to use, copy or distribute the FDK AAC Codec
-software or your modifications thereto.
-
-Your modified versions of the FDK AAC Codec must carry prominent notices stating that you changed the software
-and the date of any change. For modified versions of the FDK AAC Codec, the term
-"Fraunhofer FDK AAC Codec Library for Android" must be replaced by the term
-"Third-Party Modified Version of the Fraunhofer FDK AAC Codec Library for Android."
-
-3. NO PATENT LICENSE
-
-NO EXPRESS OR IMPLIED LICENSES TO ANY PATENT CLAIMS, including without limitation the patents of Fraunhofer,
-ARE GRANTED BY THIS SOFTWARE LICENSE. Fraunhofer provides no warranty of patent non-infringement with
-respect to this software.
-
-You may use this FDK AAC Codec software or modifications thereto only for purposes that are authorized
-by appropriate patent licenses.
-
-4. DISCLAIMER
-
-This FDK AAC Codec software is provided by Fraunhofer on behalf of the copyright holders and contributors
-"AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, including but not limited to the implied warranties
-of merchantability and fitness for a particular purpose. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
-CONTRIBUTORS BE LIABLE for any direct, indirect, incidental, special, exemplary, or consequential damages,
-including but not limited to procurement of substitute goods or services; loss of use, data, or profits,
-or business interruption, however caused and on any theory of liability, whether in contract, strict
-liability, or tort (including negligence), arising in any way out of the use of this software, even if
-advised of the possibility of such damage.
-
-5. CONTACT INFORMATION
-
-Fraunhofer Institute for Integrated Circuits IIS
-Attention: Audio and Multimedia Departments - FDK AAC LL
-Am Wolfsmantel 33
-91058 Erlangen, Germany
-
-www.iis.fraunhofer.de/amm
-amm-info@iis.fraunhofer.de
------------------------------------------------------------------------------------------------------------ */
-
-/**************************** FDK PCM utils module **************************
-
- Author(s): Christian Griebel
- Description: Defines functions to interface with the PCM post processing
- module.
-
-*******************************************************************************/
-
-#include "pcmutils_lib.h"
-
-#include "genericStds.h"
-#include "fixpoint_math.h"
-
-/* Decoder library info */
-#define PCMDMX_LIB_VL0 2
-#define PCMDMX_LIB_VL1 4
-#define PCMDMX_LIB_VL2 0
-#define PCMDMX_LIB_TITLE "PCM Downmix Lib"
-#define PCMDMX_LIB_BUILD_DATE __DATE__
-#define PCMDMX_LIB_BUILD_TIME __TIME__
-
-/* Library settings */
-#define PCM_DMX_MAX_DELAY_FRAMES ( 1 )
-#define PCM_DMX_MAX_CHANNELS ( 8 )
-#define PCM_DMX_MAX_CHANNEL_GROUPS ( 4 )
-#define PCM_DMX_MAX_CHANNELS_PER_GROUP ( 3 ) /* The maximum over all groups */
-#define PCMDMX_DFLT_EXPIRY_FRAME ( 50 ) /* At least 500ms (FL 960 @ 96kHz) */
-
-/* Fixed and unique channel group indices.
- * The last group index has to be smaller than PCM_DMX_MAX_CHANNEL_GROUPS. */
-#define CH_GROUP_FRONT ( 0 )
-#define CH_GROUP_SIDE ( 1 )
-#define CH_GROUP_REAR ( 2 )
-#define CH_GROUP_LFE ( 3 )
-
-/* The ordering of the following fixed channel labels has to be in MPEG-4 style.
- * From the center to the back with left and right channel interleaved (starting with left).
- * The last channel label index has to be smaller than PCM_DMX_MAX_CHANNELS. */
-#define CENTER_FRONT_CHANNEL ( 0 ) /* C */
-#define LEFT_FRONT_CHANNEL ( 1 ) /* L */
-#define RIGHT_FRONT_CHANNEL ( 2 ) /* R */
-#define LEFT_OUTSIDE_CHANNEL ( 3 ) /* Lo */
-#define RIGHT_OUTSIDE_CHANNEL ( 4 ) /* Ro */
-#define LEFT_REAR_CHANNEL ( 5 ) /* Lr aka left back channel */
-#define RIGHT_REAR_CHANNEL ( 6 ) /* Rr aka right back channel */
-#define LOW_FREQUENCY_CHANNEL ( 7 ) /* Lf */
-
-/* More constants */
-#define ANC_DATA_SYNC_BYTE ( 0xBC ) /* ancillary data sync byte. */
-#define ATTENUATION_FACTOR_1 ( FL2FXCONST_SGL(0.70710678f) )
-#define TWO_CHANNEL ( 2 )
-
-/* Sanity checks on library setting: */
-
-/* List of packed channel modes */
-typedef enum
-{ /* CH_MODE_<numFrontCh>_<numOutsideCh>_<numRearCh>_<numLfCh> */
- CH_MODE_UNDEFINED = 0x0000,
- /* 1 channel */
- CH_MODE_1_0_0_0 = 0x0001, /* chCfg 1 */
- /* 2 channels */
- CH_MODE_2_0_0_0 = 0x0002, /* chCfg 2 */
- /* 3 channels */
- CH_MODE_3_0_0_0 = 0x0003, /* chCfg 3 */
- CH_MODE_2_0_1_0 = 0x0102,
- CH_MODE_2_0_0_1 = 0x1002,
- /* 4 channels */
- CH_MODE_3_0_1_0 = 0x0103, /* chCfg 4 */
- CH_MODE_2_0_2_0 = 0x0202,
- CH_MODE_2_0_1_1 = 0x1102,
- /* 5 channels */
- CH_MODE_3_0_2_0 = 0x0203, /* chCfg 5 */
- CH_MODE_2_0_2_1 = 0x1202,
- CH_MODE_3_0_1_1 = 0x1103,
- CH_MODE_3_2_0_0 = 0x0023,
- /* 6 channels */
- CH_MODE_3_0_2_1 = 0x1203, /* chCfg 6 */
- CH_MODE_3_2_1_0 = 0x0123,
- /* 7 channels */
- CH_MODE_2_2_2_1 = 0x1222,
- CH_MODE_3_2_1_1 = 0x1123,
- CH_MODE_3_2_2_0 = 0x0223,
- /* 8 channels */
- CH_MODE_3_2_2_1 = 0x1222, /* chCfg 7 */
- CH_MODE_3_2_1_2 = 0x2123,
- CH_MODE_2_2_2_2 = 0x2222
-
-} PCM_DMX_CHANNEL_MODE;
-
-
-/* These are the channel configurations linked to
- the number of output channels give by the user: */
-static const PCM_DMX_CHANNEL_MODE outChModeTable[PCM_DMX_MAX_CHANNELS] =
-{
- CH_MODE_1_0_0_0, /* 1 channel */
- CH_MODE_2_0_0_0, /* 2 channels */
- CH_MODE_3_0_0_0, /* 3 channels */
- CH_MODE_3_0_1_0, /* 4 channels */
- CH_MODE_3_0_2_0, /* 5 channels */
- CH_MODE_3_0_2_1, /* 6 channels */
- CH_MODE_3_2_2_0, /* 7 channels */
- CH_MODE_3_2_2_1 /* 8 channels */
-};
-
-static const FIXP_SGL dvbDownmixFactors[8] =
-{
- FL2FXCONST_SGL(1.0f),
- FL2FXCONST_SGL(0.841f),
- FL2FXCONST_SGL(0.707f),
- FL2FXCONST_SGL(0.596f),
- FL2FXCONST_SGL(0.500f),
- FL2FXCONST_SGL(0.422f),
- FL2FXCONST_SGL(0.355f),
- FL2FXCONST_SGL(0.0f)
-};
-
-
- /* MPEG matrix mixdown:
- Set 1: L' = (1 + 2^-0.5 + A )^-1 * [L + C * 2^-0.5 + A * Ls];
- R' = (1 + 2^-0.5 + A )^-1 * [R + C * 2^-0.5 + A * Rs];
-
- Set 2: L' = (1 + 2^-0.5 + 2A )^-1 * [L + C * 2^-0.5 - A * (Ls + Rs)];
- R' = (1 + 2^-0.5 + 2A )^-1 * [R + C * 2^-0.5 + A * (Ls + Rs)];
-
- M = (3 + 2A)^-1 * [L + C + R + A*(Ls + Rs)];
- */
- static const FIXP_SGL mpegMixDownIdx2Coef[4] =
- {
- FL2FXCONST_SGL(0.70710678f),
- FL2FXCONST_SGL(0.5f),
- FL2FXCONST_SGL(0.35355339f),
- FL2FXCONST_SGL(0.0f)
- };
-
- static const FIXP_SGL mpegMixDownIdx2PreFact[4] =
- {
- FL2FXCONST_SGL(0.4142135623730950f),
- FL2FXCONST_SGL(0.4530818393219728f),
- FL2FXCONST_SGL(0.4852813742385703f),
- FL2FXCONST_SGL(0.5857864376269050f)
- };
-
- typedef struct
- {
- USHORT matrixMixdownIdx; /*!< MPEG mixdown index extracted from PCE. */
- USHORT pseudoSurroundEnable; /*!< Pseudo surround enable flag extracted from PCE. */
- USHORT mixdownAvailable; /*!< Will be set to 1 if we found a valid coefficient. */
-
- } MPEG_MIXDOWN_INFO;
-
-
-typedef struct
-{
- FIXP_SGL centerMixLevelValue; /*!< DVB mixdown level for the center channel extracted from anc data. */
- FIXP_SGL surroundMixLevelValue; /*!< DVB mixdown level for back channels extracted from anc data. */
-
- UCHAR mixLevelsAvail; /*!< Will be set to 1 if we found a valid coefficient. */
-
-} DVB_MIXDOWN_LEVELS;
-
-
-/* Modules main data structure: */
-struct PCM_DMX_INSTANCE
-{
- DVB_MIXDOWN_LEVELS dvbMixDownLevels[PCM_DMX_MAX_DELAY_FRAMES+1];
- MPEG_MIXDOWN_INFO mpegMixDownInfo[PCM_DMX_MAX_DELAY_FRAMES+1];
- DUAL_CHANNEL_MODE dualChannelMode;
- UINT expiryFrame;
- UINT expiryCount;
- SHORT numOutputChannels;
- UCHAR applyProcessing;
- UCHAR frameDelay;
-};
-
-/* Memory allocation macro */
-C_ALLOC_MEM_STATIC(PcmDmxInstance, struct PCM_DMX_INSTANCE, 1)
-
-
-/** Evaluate a given channel configuration and extract a packed channel mode and generate a channel offset table
- * This function is the inverse to the getChannelDescription() routine.
- * @param [in] The total number of channels of the given configuration.
- * @param [in] Array holding the corresponding channel types for each channel.
- * @param [in] Array holding the corresponding channel type indices for each channel.
- * @param [out] Array where the buffer offsets for each channel are stored into.
- * @returns Returns the packed channel mode.
- **/
-static
-PCM_DMX_CHANNEL_MODE getChannelMode (
- const INT numChannels, /* in */
- const AUDIO_CHANNEL_TYPE channelType[], /* in */
- const UCHAR channelIndices[], /* in */
- UCHAR offsetTable[PCM_DMX_MAX_CHANNELS] /* out */
- )
-{
- UINT chMode = CH_MODE_UNDEFINED;
- UCHAR chIdx[PCM_DMX_MAX_CHANNEL_GROUPS][PCM_DMX_MAX_CHANNELS_PER_GROUP];
- UCHAR numChInGrp[PCM_DMX_MAX_CHANNEL_GROUPS];
- int ch, grpIdx, err = 0;
-
- FDK_ASSERT(channelType != NULL);
- FDK_ASSERT(channelIndices != NULL);
- FDK_ASSERT(offsetTable != NULL);
-
- /* For details see ISO/IEC 13818-7:2005(E), 8.5.3 Channel configuration */
- FDKmemclear(numChInGrp, PCM_DMX_MAX_CHANNEL_GROUPS*sizeof(UCHAR));
- FDKmemset(offsetTable, 255, PCM_DMX_MAX_CHANNELS*sizeof(UCHAR));
- FDKmemset(chIdx, 255, PCM_DMX_MAX_CHANNEL_GROUPS*PCM_DMX_MAX_CHANNELS_PER_GROUP*sizeof(UCHAR));
-
- /* Categorize channels */
- for (ch = 0; ch < numChannels; ch += 1) {
- int i = 0, j, chGrpIdx = channelIndices[ch];
-
- switch (channelType[ch]) {
- case ACT_FRONT:
- case ACT_FRONT_TOP:
- grpIdx = CH_GROUP_FRONT;
- break;
- case ACT_SIDE:
- case ACT_SIDE_TOP:
- grpIdx = CH_GROUP_SIDE;
- break;
- case ACT_BACK:
- case ACT_BACK_TOP:
- grpIdx = CH_GROUP_REAR;
- break;
- case ACT_LFE:
- grpIdx = CH_GROUP_LFE;
- break;
- default:
- err = -1;
- continue;
- }
-
- if (numChInGrp[grpIdx] < PCM_DMX_MAX_CHANNELS_PER_GROUP) {
- /* Sort channels by index */
- while ( (i < numChInGrp[grpIdx]) && (chGrpIdx > channelIndices[chIdx[grpIdx][i]]) ) {
- i += 1;
- }
- for (j = numChInGrp[grpIdx]; j > i; j -= 1) {
- chIdx[grpIdx][j] = chIdx[grpIdx][j-1];
- }
- chIdx[grpIdx][i] = ch;
- numChInGrp[grpIdx] += 1;
- }
- }
-
- /* Compose channel offset table */
-
- /* Non-symmetric channels */
- if (numChInGrp[CH_GROUP_FRONT] & 0x1) {
- /* Odd number of front channels -> we have a center channel.
- In MPEG-4 the center has the index 0. */
- offsetTable[CENTER_FRONT_CHANNEL] = chIdx[CH_GROUP_FRONT][0];
- }
-
- for (grpIdx = 0; grpIdx < PCM_DMX_MAX_CHANNEL_GROUPS; grpIdx += 1) {
- int chMapPos, maxChannels = 0;
- ch = 0;
-
- switch (grpIdx) {
- case CH_GROUP_FRONT:
- chMapPos = LEFT_FRONT_CHANNEL;
- maxChannels = 3;
- ch = numChInGrp[grpIdx] & 0x1;
- break;
- case CH_GROUP_SIDE:
- chMapPos = LEFT_OUTSIDE_CHANNEL;
- maxChannels = 2;
- break;
- case CH_GROUP_REAR:
- chMapPos = LEFT_REAR_CHANNEL;
- maxChannels = 2;
- break;
- case CH_GROUP_LFE:
- chMapPos = LOW_FREQUENCY_CHANNEL;
- maxChannels = 1;
- break;
- default:
- err = -1;
- continue;
- }
-
- for ( ; ch < numChInGrp[grpIdx]; ch += 1) {
- if (ch < maxChannels) {
- offsetTable[chMapPos] = chIdx[grpIdx][ch];
- chMapPos += 1;
- } else {
- err = -1;
- }
- }
- }
-
- if (err == 0) {
- /* Compose the channel mode */
- chMode = (numChInGrp[CH_GROUP_LFE] & 0xF) << 12
- | (numChInGrp[CH_GROUP_REAR] & 0xF) << 8
- | (numChInGrp[CH_GROUP_SIDE] & 0xF) << 4
- | (numChInGrp[CH_GROUP_FRONT] & 0xF);
- }
-
- return (PCM_DMX_CHANNEL_MODE)chMode;
-}
-
-
-/** Generate a channel offset table and complete channel description for a given (packed) channel mode.
- * This function is the inverse to the getChannelMode() routine.
- * @param [in] The total number of channels of the given configuration.
- * @param [in] Array containing the channel mapping to be used (From MPEG PCE ordering to whatever is required).
- * @param [out] Array where corresponding channel types for each channels are stored into.
- * @param [out] Array where corresponding channel type indices for each output channel are stored into.
- * @param [out] Array where the buffer offsets for each channel are stored into.
- * @returns None.
- **/
-void getChannelDescription (
- const PCM_DMX_CHANNEL_MODE chMode, /* in */
- const UCHAR channelMapping[][PCM_DMX_MAX_CHANNELS], /* in */
- AUDIO_CHANNEL_TYPE channelType[], /* out */
- UCHAR channelIndices[], /* out */
- UCHAR offsetTable[PCM_DMX_MAX_CHANNELS] /* out */
- )
-{
- const UCHAR *pChannelMap;
- int grpIdx, ch = 0, numChannels = 0;
- UCHAR numChInGrp[PCM_DMX_MAX_CHANNEL_GROUPS];
-
- FDK_ASSERT(channelType != NULL);
- FDK_ASSERT(channelIndices != NULL);
- FDK_ASSERT(channelMapping != NULL);
- FDK_ASSERT(offsetTable != NULL);
-
- /* Init output arrays */
- FDKmemclear(channelType, PCM_DMX_MAX_CHANNELS*sizeof(AUDIO_CHANNEL_TYPE));
- FDKmemclear(channelIndices, PCM_DMX_MAX_CHANNELS*sizeof(UCHAR));
- FDKmemset(offsetTable, 255, PCM_DMX_MAX_CHANNELS*sizeof(UCHAR));
-
- /* Extract the number of channels per group */
- numChInGrp[CH_GROUP_FRONT] = chMode & 0xF;
- numChInGrp[CH_GROUP_SIDE] = (chMode >> 4) & 0xF;
- numChInGrp[CH_GROUP_REAR] = (chMode >> 8) & 0xF;
- numChInGrp[CH_GROUP_LFE] = (chMode >> 12) & 0xF;
-
- /* Summerize to get the total number of channels */
- for (grpIdx = 0; grpIdx < PCM_DMX_MAX_CHANNEL_GROUPS; grpIdx += 1) {
- numChannels += numChInGrp[grpIdx];
- }
-
- /* Get the appropriate channel map */
- pChannelMap = channelMapping[numChannels-1];
-
- /* Compose channel offset table */
-
- /* Non-symmetric channels */
- if (numChInGrp[CH_GROUP_FRONT] & 0x1) {
- /* Odd number of front channels -> we have a center channel.
- In MPEG-4 the center has the index 0. */
- offsetTable[CENTER_FRONT_CHANNEL] = pChannelMap[0];
- channelType[0] = ACT_FRONT;
- ch += 1;
- }
-
- for (grpIdx = 0; grpIdx < PCM_DMX_MAX_CHANNEL_GROUPS; grpIdx += 1) {
- AUDIO_CHANNEL_TYPE type;
- int chMapPos, maxChannels = 0;
- int chIdx = 0;
-
- switch (grpIdx) {
- case CH_GROUP_FRONT:
- type = ACT_FRONT;
- chMapPos = LEFT_FRONT_CHANNEL;
- maxChannels = 3;
- chIdx = numChInGrp[grpIdx] & 0x1;
- break;
- case CH_GROUP_SIDE:
- type = ACT_SIDE;
- chMapPos = LEFT_OUTSIDE_CHANNEL;
- maxChannels = 2;
- break;
- case CH_GROUP_REAR:
- type = ACT_BACK;
- chMapPos = LEFT_REAR_CHANNEL;
- maxChannels = 2;
- break;
- case CH_GROUP_LFE:
- type = ACT_LFE;
- chMapPos = LOW_FREQUENCY_CHANNEL;
- maxChannels = 1;
- break;
- default:
- break;
- }
-
- for ( ; (chIdx < numChInGrp[grpIdx]) && (chIdx < maxChannels); chIdx += 1) {
- offsetTable[chMapPos] = pChannelMap[ch];
- channelType[ch] = type;
- channelIndices[ch] = chIdx;
- chMapPos += 1;
- ch += 1;
- }
- }
-}
-
-
-/** Open and initialize an instance of the PCM downmix module
- * @param [out] Pointer to a buffer receiving the handle of the new instance.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_Open (
- HANDLE_PCM_DOWNMIX *pSelf
- )
-{
- HANDLE_PCM_DOWNMIX self;
-
- if (pSelf == NULL) {
- return (PCMDMX_INVALID_HANDLE);
- }
-
- *pSelf = NULL;
-
- self = (HANDLE_PCM_DOWNMIX) GetPcmDmxInstance( 0 );
- if (self == NULL) {
- return (PCMDMX_OUT_OF_MEMORY);
- }
-
- /* Reset the full instance */
- pcmDmx_Reset( self, PCMDMX_RESET_FULL );
-
- *pSelf = self;
-
- return (PCMDMX_OK);
-}
-
-
-/** Reset all static values like e.g. mixdown coefficients.
- * @param [in] Handle of PCM downmix module instance.
- * @param [in] Flags telling which parts of the module shall be reset.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_Reset (
- HANDLE_PCM_DOWNMIX self,
- UINT flags
- )
-{
- if (self == NULL) { return (PCMDMX_INVALID_HANDLE); }
-
- if (flags & PCMDMX_RESET_PARAMS) {
- self->dualChannelMode = STEREO_MODE;
- self->numOutputChannels = 0;
- self->applyProcessing = 0;
- self->frameDelay = 0;
- self->expiryFrame = PCMDMX_DFLT_EXPIRY_FRAME;
- }
-
- if (flags & PCMDMX_RESET_BS_DATA) {
- int slot;
- for (slot = 0; slot <= PCM_DMX_MAX_DELAY_FRAMES; slot += 1) {
- self->dvbMixDownLevels[slot].centerMixLevelValue = dvbDownmixFactors[2]; /* 0.707 */
- self->dvbMixDownLevels[slot].surroundMixLevelValue = dvbDownmixFactors[0]; /* 1.000 */
- self->dvbMixDownLevels[slot].mixLevelsAvail = 0;
-
- self->mpegMixDownInfo[slot].mixdownAvailable = 0;
- }
- /* Reset expiry counter */
- self->expiryCount = 0;
- }
-
- return (PCMDMX_OK);
-}
-
-
-/** Set one parameter for one instance of the PCM downmix module.
- * @param [in] Handle of PCM downmix module instance.
- * @param [in] Parameter to be set.
- * @param [in] Parameter value.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_SetParam (
- HANDLE_PCM_DOWNMIX self,
- PCMDMX_PARAM param,
- UINT value
- )
-{
- switch (param)
- {
- case DMX_BS_DATA_EXPIRY_FRAME:
- if (self == NULL)
- return (PCMDMX_INVALID_HANDLE);
- self->expiryFrame = value;
- break;
-
- case DMX_BS_DATA_DELAY:
- if (value > PCM_DMX_MAX_DELAY_FRAMES) {
- return (PCMDMX_UNABLE_TO_SET_PARAM);
- }
- if (self == NULL) {
- return (PCMDMX_INVALID_HANDLE);
- }
- self->frameDelay = value;
- break;
-
- case NUMBER_OF_OUTPUT_CHANNELS:
- switch ((int)value) { /* supported output channels */
- case -1: case 0: case 1: case 2:
- case 6: case 8:
- break;
- default:
- return (PCMDMX_UNABLE_TO_SET_PARAM);
- }
- if (self == NULL)
- return (PCMDMX_INVALID_HANDLE);
- if ((int)value > 0) {
- self->numOutputChannels = (int)value;
- self->applyProcessing = 1;
- } else {
- self->numOutputChannels = 0;
- self->applyProcessing = 0;
- }
- break;
-
- case DUAL_CHANNEL_DOWNMIX_MODE:
- switch ((DUAL_CHANNEL_MODE)value) {
- case STEREO_MODE:
- case CH1_MODE:
- case CH2_MODE:
- case MIXED_MODE:
- break;
- default:
- return (PCMDMX_UNABLE_TO_SET_PARAM);
- }
- if (self == NULL)
- return (PCMDMX_INVALID_HANDLE);
- self->dualChannelMode = (DUAL_CHANNEL_MODE)value;
- self->applyProcessing = 1;
- break;
-
- default:
- return (PCMDMX_UNKNOWN_PARAM);
- }
-
- return (PCMDMX_OK);
-}
-
-
-/** Read the ancillary data transported in DSEs of DVB streams with MPEG-4 content
- * @param [in] Handle of PCM downmix module instance.
- * @param [in] Pointer to ancillary data buffer.
- * @param [in] Size of ancillary data.
- * @param [in] Flag indicating wheter the DVB ancillary data is from an MPEG-1/2 or an MPEG-4 stream.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_ReadDvbAncData (
- HANDLE_PCM_DOWNMIX self,
- UCHAR *pAncDataBuf,
- UINT ancDataBytes,
- int isMpeg2
- )
-{
- DVB_MIXDOWN_LEVELS *pDownmixLevels = &self->dvbMixDownLevels[0];
-
- int offset = (isMpeg2) ? 2 : 0;
- UCHAR ancDataStatus;
-
- if (self == NULL) { return (PCMDMX_INVALID_HANDLE); }
-
- /* sanity checks */
- if (pAncDataBuf == NULL || ancDataBytes < (UCHAR)(3+offset)) {
- return (PCMDMX_CORRUPT_ANC_DATA);
- }
-
- /* check sync word */
- if (pAncDataBuf[offset] != ANC_DATA_SYNC_BYTE) {
- return (PCMDMX_CORRUPT_ANC_DATA);
- }
-
- offset += 2;
- ancDataStatus = pAncDataBuf[offset++];
-
- if (isMpeg2) {
- /* skip advanced_dynamic_range_control */
- if (ancDataStatus & 0x80) offset += 3;
- /* skip dialog_normalization */
- if (ancDataStatus & 0x40) offset += 1;
- /* skip reproduction_level */
- if (ancDataStatus & 0x20) offset += 1;
- }
- else {
- /* check reserved bits */
- if (ancDataStatus & 0xE8) { return (PCMDMX_CORRUPT_ANC_DATA); }
- }
-
- /* downmix_levels_MPEGX */
- if (ancDataStatus & 0x10)
- {
- int foundNewData = 0;
- UCHAR downmixData = pAncDataBuf[offset++];
-
- if (downmixData & 0x80) { /* center_mix_level_on */
- pDownmixLevels->centerMixLevelValue =
- dvbDownmixFactors[(downmixData >> 4) & 0x07];
- foundNewData = 1;
- } else {
- pDownmixLevels->centerMixLevelValue = dvbDownmixFactors[0];
- if (downmixData & 0x70) { return (PCMDMX_CORRUPT_ANC_DATA); }
- }
-
- if (downmixData & 0x08) { /* surround_mix_level_on */
- pDownmixLevels->surroundMixLevelValue =
- dvbDownmixFactors[downmixData & 0x07];
- foundNewData = 1;
- } else {
- pDownmixLevels->surroundMixLevelValue = dvbDownmixFactors[0];
- if (downmixData & 0x07) { return (PCMDMX_CORRUPT_ANC_DATA); }
- }
-
- pDownmixLevels->mixLevelsAvail = foundNewData;
- }
-
- /* Reset expiry counter */
- self->expiryCount = 0;
-
- return (PCMDMX_OK);
-}
-
-/** Set the matrix mixdown information extracted from the PCE of an AAC bitstream.
- * Note: Call only if matrix_mixdown_idx_present is true.
- * @param [in] Handle of PCM downmix module instance.
- * @param [in] The 2 bit matrix mixdown index extracted from PCE.
- * @param [in] The pseudo surround enable flag extracted from PCE.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_SetMatrixMixdownFromPce (
- HANDLE_PCM_DOWNMIX self,
- int matrixMixdownPresent,
- int matrixMixdownIdx,
- int pseudoSurroundEnable
- )
-{
- MPEG_MIXDOWN_INFO *pMpegMixDownInfo;
-
- if (self == NULL) {
- return (PCMDMX_INVALID_HANDLE);
- }
-
- pMpegMixDownInfo = &self->mpegMixDownInfo[0];
-
- if (matrixMixdownPresent) {
- pMpegMixDownInfo->matrixMixdownIdx = matrixMixdownIdx & 0x03;
- pMpegMixDownInfo->pseudoSurroundEnable = pseudoSurroundEnable;
- }
-
- pMpegMixDownInfo->mixdownAvailable = matrixMixdownPresent;
- /* Reset expiry counter */
- self->expiryCount = 0;
-
- return (PCMDMX_OK);
-}
-
-
-/** Apply down or up mixing.
- * @param [in] Handle of PCM downmix module instance.
- * @param [inout] Pointer to time buffer. Depending on interface configuration, the content of pTimeData is ignored,
- * and the internal QMF buffer will be used as input data source. Otherwise, the MPEG Surround processing is
- * applied to the timesignal pTimeData. For both variants, the resulting MPEG Surround signal is written into pTimeData.
- * @param [in] Pointer where the amount of output samples is returned into.
- * @param [inout] Pointer where the amount of output channels is returned into.
- * @param [in] Flag which indicates if output time data are writtern interleaved or as subsequent blocks.
- * @param [inout] Array where the corresponding channel type for each output audio channel is stored into.
- * @param [inout] Array where the corresponding channel type index for each output audio channel is stored into.
- * @param [in] Array containing the output channel mapping to be used (From MPEG PCE ordering to whatever is required).
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_ApplyFrame (
- HANDLE_PCM_DOWNMIX self,
- INT_PCM *pPcmBuf,
- UINT frameSize,
- INT *nChannels,
-
- int fInterleaved,
- AUDIO_CHANNEL_TYPE channelType[],
- UCHAR channelIndices[],
- const UCHAR channelMapping[][8]
- )
-{
- PCMDMX_ERROR errorStatus = PCMDMX_OK;
- DUAL_CHANNEL_MODE dualChannelMode;
- PCM_DMX_CHANNEL_MODE inChMode;
- int numOutChannels;
- int numInChannels = *nChannels;
- int slot;
- UCHAR inOffsetTable[PCM_DMX_MAX_CHANNELS];
-
- MPEG_MIXDOWN_INFO mpegMixDownInfo;
- DVB_MIXDOWN_LEVELS dvbMixDownLevels;
-
- if (self == NULL) { return (PCMDMX_INVALID_HANDLE); }
-
- if ( (self->expiryFrame > 0)
- && (++self->expiryCount > self->expiryFrame) )
- { /* The metadata read from bitstream is too old. */
- errorStatus = pcmDmx_Reset(self, PCMDMX_RESET_BS_DATA);
- }
-
- FDKmemcpy(&mpegMixDownInfo, &self->mpegMixDownInfo[self->frameDelay], sizeof(MPEG_MIXDOWN_INFO));
- /* Maintain delay line */
- for (slot = self->frameDelay; slot > 0; slot -= 1) {
- FDKmemcpy(&self->mpegMixDownInfo[slot], &self->mpegMixDownInfo[slot-1], sizeof(MPEG_MIXDOWN_INFO));
- }
- FDKmemcpy(&dvbMixDownLevels, &self->dvbMixDownLevels[self->frameDelay], sizeof(DVB_MIXDOWN_LEVELS));
- /* Maintain delay line */
- for (slot = self->frameDelay; slot > 0; slot -= 1) {
- FDKmemcpy(&self->dvbMixDownLevels[slot], &self->dvbMixDownLevels[slot-1], sizeof(DVB_MIXDOWN_LEVELS));
- }
-
- if (self->applyProcessing == 0) { return (errorStatus); }
-
- if (pPcmBuf == NULL) { return (PCMDMX_INVALID_ARGUMENT); }
- if (frameSize == 0) { return (PCMDMX_INVALID_ARGUMENT); }
- if (numInChannels == 0) { return (PCMDMX_INVALID_ARGUMENT); }
-
- if (self->numOutputChannels <= 0) {
- numOutChannels = numInChannels;
- } else {
- numOutChannels = self->numOutputChannels;
- }
- dualChannelMode = self->dualChannelMode;
-
- /* Analyse input channel configuration and get channel offset
- * table that can be accessed with the fixed channel labels. */
- inChMode = getChannelMode(
- numInChannels,
- channelType,
- channelIndices,
- inOffsetTable
- );
- if (inChMode == CH_MODE_UNDEFINED) {
- /* We don't need to restore because the channel
- configuration has not been changed. Just exit. */
- return (PCMDMX_INVALID_CH_CONFIG);
- }
-
- /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
- if ( numInChannels > numOutChannels )
- { /* Apply downmix */
- INT_PCM *pInCF, *pInLF, *pInRF, *pInLO, *pInRO, *pInLR, *pInRR, *pOutL, *pOutR;
- FIXP_SGL flev, clev, slev;
-
- UINT sample;
- int inStride, outStride, offset;
- int useGuidedDownMix = 0;
- UCHAR outOffsetTable[PCM_DMX_MAX_CHANNELS];
-
- /* Set I/O strides and offsets */
- if (fInterleaved) {
- inStride = numInChannels;
- outStride = TWO_CHANNEL; /* The output of STAGE ONE is always STEREO !!!
- STAGE TWO creates a downmix to mono if required. */
- offset = 1; /* Channel specific offset factor */
- } else {
- inStride = 1;
- outStride = 1;
- offset = frameSize; /* Channel specific offset factor */
- }
-
- /* Get channel description and channel mapping for this
- * stages number of output channels (always STEREO). */
- getChannelDescription(
- CH_MODE_2_0_0_0,
- channelMapping,
- channelType,
- channelIndices,
- outOffsetTable
- );
- /* Now there is no way back because we modified the channel configuration! */
-
- /* Set channel pointer for input */
- pInCF = &pPcmBuf[inOffsetTable[CENTER_FRONT_CHANNEL]*offset];
- pInLF = &pPcmBuf[inOffsetTable[LEFT_FRONT_CHANNEL]*offset];
- pInRF = &pPcmBuf[inOffsetTable[RIGHT_FRONT_CHANNEL]*offset];
- pInLO = &pPcmBuf[inOffsetTable[LEFT_OUTSIDE_CHANNEL]*offset];
- pInRO = &pPcmBuf[inOffsetTable[RIGHT_OUTSIDE_CHANNEL]*offset];
- pInLR = &pPcmBuf[inOffsetTable[LEFT_REAR_CHANNEL]*offset];
- pInRR = &pPcmBuf[inOffsetTable[RIGHT_REAR_CHANNEL]*offset];
-
- /* Set channel pointer for output
- Caution: Different channel mapping compared to input */
- pOutL = &pPcmBuf[outOffsetTable[LEFT_FRONT_CHANNEL]*offset]; /* LEFT_FRONT_CHANNEL */
- pOutR = &pPcmBuf[outOffsetTable[RIGHT_FRONT_CHANNEL]*offset]; /* RIGHT_FRONT_CHANNEL */
-
- /* Set downmix levels: */
- flev = ATTENUATION_FACTOR_1; /* 0.707 */
- clev = ATTENUATION_FACTOR_1; /* 0.707 */
- slev = ATTENUATION_FACTOR_1; /* 0.707 */
-
- if ( dvbMixDownLevels.mixLevelsAvail ) {
- clev = dvbMixDownLevels.centerMixLevelValue;
- slev = dvbMixDownLevels.surroundMixLevelValue;
- useGuidedDownMix = 1;
- }
-
- /* FIRST STAGE:
- Always downmix to 2 channel output: */
- switch ( inChMode )
- {
- case CH_MODE_2_0_0_0:
- case CH_MODE_2_0_0_1:
- /* 2/0 input: */
- switch (dualChannelMode)
- {
- case CH1_MODE: /* L' = 0.707 * Ch1; R' = 0.707 * Ch1 */
- for (sample = 0; sample < frameSize; sample++) {
- *pOutL = *pOutR =
- (INT_PCM)SATURATE_RIGHT_SHIFT(fMult((FIXP_PCM)*pInLF, flev), DFRACT_BITS-SAMPLE_BITS, SAMPLE_BITS);
-
- pInLF += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- break;
-
- case CH2_MODE: /* L' = 0.707 * Ch2; R' = 0.707 * Ch2 */
- for (sample = 0; sample < frameSize; sample++) {
- *pOutL = *pOutR =
- (INT_PCM)SATURATE_RIGHT_SHIFT(fMult((FIXP_PCM)*pInRF, flev), DFRACT_BITS-SAMPLE_BITS, SAMPLE_BITS);
-
- pInRF += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- break;
- case MIXED_MODE: /* L' = 0.5*Ch1 + 0.5*Ch2; R' = 0.5*Ch1 + 0.5*Ch2 */
- for (sample = 0; sample < frameSize; sample++) {
- *pOutL = *pOutR = (*pInLF >> 1) + (*pInRF >> 1);
-
- pInLF += inStride; pInRF += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- break;
- default:
- case STEREO_MODE:
- /* nothing to do */
- break;
- }
- break;
-
- case CH_MODE_3_0_0_0:
- /* 3/0 input: L' = L + 0.707*C; R' = R + 0.707*C; */
- for (sample = 0; sample < frameSize; sample++)
- {
- FIXP_DBL tCF = fMultDiv2((FIXP_PCM)*pInCF, clev);
-#if (SAMPLE_BITS == 32)
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_LEFT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInLF)>>1)+tCF, 1, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_LEFT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInRF)>>1)+tCF, 1, SAMPLE_BITS);
-#else
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_RIGHT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInLF)>>1)+tCF, DFRACT_BITS-SAMPLE_BITS-1, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_RIGHT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInRF)>>1)+tCF, DFRACT_BITS-SAMPLE_BITS-1, SAMPLE_BITS);
-#endif
- pInLF += inStride; pInRF += inStride; pInCF += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- break;
-
- /* 2/1 input: not supported!
- case CH_MODE_2_0_1_0: */
-
- case CH_MODE_3_0_1_0:
- if (useGuidedDownMix) {
- /* 3/1 input: L' = L + clev*C + 0.707*slev*S; R' = R + clev*C + 0.707*slev*S; */
- slev = FX_DBL2FX_SGL(fMult(flev, slev)); /* 0.707*slef */
-
- for (sample = 0; sample < frameSize; sample++)
- {
- FIXP_DBL tCF = fMultDiv2((FIXP_PCM)*pInCF, clev) >> 1;
- FIXP_DBL tLR = fMultDiv2((FIXP_PCM)*pInLR, slev) >> 1;
-#if (SAMPLE_BITS == 32)
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_LEFT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInLF)>>2)+tCF+tLR, 2, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_LEFT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInRF)>>2)+tCF+tLR, 2, SAMPLE_BITS);
-#else
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_RIGHT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInLF)>>2)+tCF-tLR, DFRACT_BITS-SAMPLE_BITS-2, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_RIGHT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInRF)>>2)+tCF+tLR, DFRACT_BITS-SAMPLE_BITS-2, SAMPLE_BITS);
-#endif
- pInLF += inStride; pInRF += inStride; pInCF += inStride; pInLR += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- } else {
- /* 3/1 input: L' = L + 0.707*C - 0.707*S; R' = R + 0.707*C + 0.707*S */
- for (sample = 0; sample < frameSize; sample++)
- {
- FIXP_DBL tCF = fMultDiv2((FIXP_PCM)*pInCF, clev) >> 1;
- FIXP_DBL tLR = fMultDiv2((FIXP_PCM)*pInLR, slev) >> 1;
-#if (SAMPLE_BITS == 32)
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_LEFT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInLF)>>2)+tCF-tLR, 2, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_LEFT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInRF)>>2)+tCF+tLR, 2, SAMPLE_BITS);
-#else
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_RIGHT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInLF)>>2)+tCF-tLR, DFRACT_BITS-SAMPLE_BITS-2, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_RIGHT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInRF)>>2)+tCF+tLR, DFRACT_BITS-SAMPLE_BITS-2, SAMPLE_BITS);
-#endif
- pInLF += inStride; pInRF += inStride; pInCF += inStride; pInLR += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- }
- break;
-
- /* 2/2 input: not supported!
- case CH_MODE_2_0_2_0: */
-
- case CH_MODE_3_0_2_0: /* 5.0ch input */
- case CH_MODE_3_0_2_1: /* 5.1ch input */
- if (useGuidedDownMix) {
- /* 3/2 input: L' = L + clev*C + slev*Ls; R' = R + clev*C + slev*Rs; */
- for (sample = 0; sample < frameSize; sample++)
- {
- FIXP_DBL tCF = fMultDiv2((FIXP_PCM)*pInCF, clev) >> 1;
- FIXP_DBL tLR = fMultDiv2((FIXP_PCM)*pInLR, slev) >> 1;
- FIXP_DBL tRR = fMultDiv2((FIXP_PCM)*pInRR, slev) >> 1;
-#if (SAMPLE_BITS == 32)
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_LEFT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInLF)>>2)+tCF+tLR, 2, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_LEFT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInRF)>>2)+tCF+tRR, 2, SAMPLE_BITS);
-#else
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_RIGHT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInLF)>>2)+tCF+tLR, DFRACT_BITS-SAMPLE_BITS-2, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_RIGHT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInRF)>>2)+tCF+tRR, DFRACT_BITS-SAMPLE_BITS-2, SAMPLE_BITS);
-#endif
- pInLF += inStride; pInRF += inStride; pInCF += inStride; pInLR += inStride; pInRR += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- }
- else if (mpegMixDownInfo.mixdownAvailable) {
- /* 3/2 input: L' = (1.707+A)^-1 * [L+0.707*C+A*Ls]; R'= (1.707+A)^-1 * [R+0.707*C+A*Rs]; */
- FIXP_SGL mtrxMixDwnCoef = mpegMixDownIdx2Coef[mpegMixDownInfo.matrixMixdownIdx];
- FIXP_SGL mtrxMixDwnPreFact = mpegMixDownIdx2PreFact[mpegMixDownInfo.matrixMixdownIdx];
- clev = FX_DBL2FX_SGL(fMult(mtrxMixDwnPreFact, flev /* 0.707 */));
- flev = mtrxMixDwnPreFact;
- slev = FX_DBL2FX_SGL(fMult(mtrxMixDwnPreFact, mtrxMixDwnCoef));
-
- for (sample = 0; sample < frameSize; sample++)
- {
- FIXP_DBL tCF = fMultDiv2((FIXP_PCM)*pInCF, clev);
- FIXP_DBL tLF = fMultDiv2((FIXP_PCM)*pInLF, flev);
- FIXP_DBL tRF = fMultDiv2((FIXP_PCM)*pInRF, flev);
- FIXP_DBL tLR = fMultDiv2((FIXP_PCM)*pInLR, slev);
- FIXP_DBL tRR = fMultDiv2((FIXP_PCM)*pInRR, slev);
-
-#if (SAMPLE_BITS == 32)
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_LEFT_SHIFT(tLF+tCF+tLR, 1, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_LEFT_SHIFT(tRF+tCF+tRR, 1, SAMPLE_BITS);
-#else
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_RIGHT_SHIFT(tLF+tCF+tLR, DFRACT_BITS-SAMPLE_BITS-1, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_RIGHT_SHIFT(tRF+tCF+tRR, DFRACT_BITS-SAMPLE_BITS-1, SAMPLE_BITS);
-#endif
-
- pInLF += inStride; pInRF += inStride; pInCF += inStride; pInLR += inStride; pInRR += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- }
- else {
- /* 3/2 input: L' = L + 0.707*C - 0.707*Ls - 0.707*Rs; R' = R + 0.707*C + 0.707*Ls + 0.707*Rs */
- for (sample = 0; sample < frameSize; sample++)
- {
- FIXP_DBL tCF = fMultDiv2((FIXP_PCM)*pInCF, clev) >> 2;
- FIXP_DBL tLR = fMultDiv2((FIXP_PCM)*pInLR, slev) >> 2;
- FIXP_DBL tRR = fMultDiv2((FIXP_PCM)*pInRR, slev) >> 2;
-#if (SAMPLE_BITS == 32)
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_LEFT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInLF)>>3)+tCF-tLR-tRR, 3, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_LEFT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInRF)>>3)+tCF+tLR+tRR, 3, SAMPLE_BITS);
-#else
- /* left channel */
- *pOutL = (INT_PCM)SATURATE_RIGHT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInLF)>>3)+tCF-tLR-tRR, DFRACT_BITS-SAMPLE_BITS-3, SAMPLE_BITS);
- /* right channel */
- *pOutR = (INT_PCM)SATURATE_RIGHT_SHIFT((FX_PCM2FX_DBL((FIXP_PCM)*pInRF)>>3)+tCF+tLR+tRR, DFRACT_BITS-SAMPLE_BITS-3, SAMPLE_BITS);
-#endif
- pInLF += inStride; pInRF += inStride; pInCF += inStride; pInLR += inStride; pInRR += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- }
- break;
-
- default:
- errorStatus = PCMDMX_INVALID_MODE;
- break;
- }
-
- /* SECOND STAGE:
- If desired create a mono donwmix:
- Note: Input are always two channels! */
- if (numOutChannels == 1)
- {
- INT_PCM *pOutC;
- FIXP_SGL mlev;
-
- if (useGuidedDownMix) mlev = FL2FXCONST_SGL(1.0f); else mlev = flev;
-
- /* Output of STAGE ONE = Input of STAGE TWO */
- FDKmemcpy(inOffsetTable, outOffsetTable, PCM_DMX_MAX_CHANNELS*sizeof(UCHAR));
-
- /* Set I/O strides and offsets */
- inStride = outStride; /* output from STAGE ONE */
- outStride = numOutChannels; /* final output */
-
- /* Get channel description and channel mapping for this
- * stages number of output channels (always MONO). */
- getChannelDescription(
- CH_MODE_1_0_0_0,
- channelMapping,
- channelType,
- channelIndices,
- outOffsetTable
- );
-
- /* Set input channel pointer. */
- pInLF = &pPcmBuf[inOffsetTable[LEFT_FRONT_CHANNEL]*offset];
- pInRF = &pPcmBuf[inOffsetTable[RIGHT_FRONT_CHANNEL]*offset];
-
- /* Set output channel pointer */
- pOutC = &pPcmBuf[outOffsetTable[CENTER_FRONT_CHANNEL]*offset];
-
- /* C' = 0.707*L + 0.707*R */
- for (sample = 0; sample < frameSize; sample++) {
-#if (SAMPLE_BITS == 32)
- *pOutC =
- (INT_PCM)SATURATE_LEFT_SHIFT(fMultDiv2((FIXP_PCM)*pInLF,mlev)+fMultDiv2((FIXP_PCM)*pInRF,mlev), 1, SAMPLE_BITS);
-#else
- *pOutC =
- (INT_PCM)SATURATE_RIGHT_SHIFT(fMultDiv2((FIXP_PCM)*pInLF,mlev)+fMultDiv2((FIXP_PCM)*pInRF,mlev), DFRACT_BITS-SAMPLE_BITS-1, SAMPLE_BITS);
-#endif
-
- pInLF += inStride; pInRF += inStride;
- pOutC += 1;
- }
- /* Finished STAGE TWO */
- }
-
- /* Update the number of output channels */
- *nChannels = self->numOutputChannels;
-
- } /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
- else
- if ( numInChannels == numOutChannels )
- {
- /* Don't need to change the channel description here */
-
- switch (numInChannels)
- {
- case 2:
- { /* Set up channel pointer */
- INT_PCM *pInLF, *pInRF, *pOutL, *pOutR;
- FIXP_SGL flev;
-
- UINT sample;
- int inStride, outStride, offset;
-
- if (fInterleaved) {
- inStride = numInChannels;
- outStride = 2; /* fixed !!! (below stereo is donwmixed to mono if required */
- offset = 1; /* Channel specific offset factor */
- } else {
- inStride = 1;
- outStride = 1;
- offset = frameSize; /* Channel specific offset factor */
- }
-
- /* Set input channel pointer */
- pInLF = &pPcmBuf[inOffsetTable[LEFT_FRONT_CHANNEL]*offset];
- pInRF = &pPcmBuf[inOffsetTable[RIGHT_FRONT_CHANNEL]*offset];
-
- /* Set output channel pointer (same as input) */
- pOutL = pInLF;
- pOutR = pInRF;
-
- /* Set downmix levels: */
- flev = ATTENUATION_FACTOR_1; /* 0.707 */
- /* 2/0 input: */
- switch (dualChannelMode)
- {
- case CH1_MODE: /* L' = 0.707 * Ch1; R' = 0.707 * Ch1 */
- for (sample = 0; sample < frameSize; sample++) {
- *pOutL = *pOutR =
- (INT_PCM)SATURATE_RIGHT_SHIFT(fMult((FIXP_PCM)*pInLF, flev), DFRACT_BITS-SAMPLE_BITS, SAMPLE_BITS);
-
- pInLF += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- break;
- case CH2_MODE: /* L' = 0.707 * Ch2; R' = 0.707 * Ch2 */
- for (sample = 0; sample < frameSize; sample++) {
- *pOutL = *pOutR =
- (INT_PCM)SATURATE_RIGHT_SHIFT(fMult((FIXP_PCM)*pInRF, flev), DFRACT_BITS-SAMPLE_BITS, SAMPLE_BITS);
-
- pInRF += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- break;
- case MIXED_MODE: /* L' = 0.5*Ch1 + 0.5*Ch2; R' = 0.5*Ch1 + 0.5*Ch2 */
- for (sample = 0; sample < frameSize; sample++) {
- *pOutL = *pOutR = (*pInLF >> 1) + (*pInRF >> 1);
-
- pInLF += inStride; pInRF += inStride;
- pOutL += outStride; pOutR += outStride;
- }
- break;
- default:
- case STEREO_MODE:
- /* nothing to do */
- break;
- }
- }
- break;
-
- default:
- /* nothing to do */
- break;
- }
- }
-
- return (errorStatus);
-}
-
-
-/** Close an instance of the PCM downmix module.
- * @param [inout] Pointer to a buffer containing the handle of the instance.
- * @returns Returns an error code.
- **/
-PCMDMX_ERROR pcmDmx_Close (
- HANDLE_PCM_DOWNMIX *pSelf
- )
-{
- if (pSelf == NULL) {
- return (PCMDMX_INVALID_HANDLE);
- }
-
- FreePcmDmxInstance( pSelf );
- *pSelf = NULL;
-
- return (PCMDMX_OK);
-}
-
-
-/** Get library info for this module.
- * @param [out] Pointer to an allocated LIB_INFO structure.
- * @returns Returns an error code.
- */
-PCMDMX_ERROR pcmDmx_GetLibInfo( LIB_INFO *info )
-{
- int i;
-
- if (info == NULL) {
- return PCMDMX_INVALID_ARGUMENT;
- }
-
- /* Search for next free tab */
- for (i = 0; i < FDK_MODULE_LAST; i++) {
- if (info[i].module_id == FDK_NONE) break;
- }
- if (i == FDK_MODULE_LAST) {
- return PCMDMX_UNKNOWN;
- }
- info += i;
-
- /* Add the library info */
- info->module_id = FDK_PCMDMX;
- info->version = LIB_VERSION(PCMDMX_LIB_VL0, PCMDMX_LIB_VL1, PCMDMX_LIB_VL2);
- LIB_VERSION_STRING(info);
- info->build_date = PCMDMX_LIB_BUILD_DATE;
- info->build_time = PCMDMX_LIB_BUILD_TIME;
- info->title = PCMDMX_LIB_TITLE;
-
- /* Set flags */
- info->flags = 0
- | CAPF_DMX_BLIND /* At least blind downmixing is possible */
- | CAPF_DMX_PCE /* Guided downmix with data from MPEG-2/4 Program Config Elements (PCE). */
- | CAPF_DMX_DVB /* Guided downmix with data from DVB ancillary data fields. */
- ;
-
- return PCMDMX_OK;
-}
-
-
-