Initial community commit

1 files changed, 978 insertions, 0 deletions

diff --git a/Src/Plugins/Encoder/enc_fhgaac/mp4FastAAClib.h b/Src/Plugins/Encoder/enc_fhgaac/mp4FastAAClib.h
new file mode 100644
index 00000000..e7350669
--- /dev/null
+++ b/Src/Plugins/Encoder/enc_fhgaac/mp4FastAAClib.h
@@ -0,0 +1,978 @@
+/*************************  Fast MPEG AAC Audio Encoder  **********************
+
+                     (C) Copyright Fraunhofer IIS (2004-2010)
+                                All Rights Reserved
+
+   $Id: mp4FastAAClib.h,v 1.8 2013/10/29 00:56:15 dromagod Exp $
+   Initial author:       M. Schug / A. Groeschel
+   contents/description: Fast MPEG AAC Encoder Interface Library Functions
+
+   This software and/or program is protected by copyright law and international 
+   treaties. Any reproduction or distribution of this software and/or program, 
+   or any portion of it, may result in severe civil and criminal penalties, and 
+   will be prosecuted to the maximum extent possible under law.
+
+******************************************************************************/
+
+#ifndef _mp4FastAAClib_h_
+#define _mp4FastAAClib_h_
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/* ------------------------ structure alignment ---------------------------*/
+
+#if defined(WIN32) || defined(WIN64)
+#pragma pack(push, 1)
+#endif
+
+/*-------------------------- defines --------------------------------------*/
+
+/*
+ * calling convention
+ */
+
+#ifndef MPEG4ENCAPI
+#if defined(WIN32) || defined(WIN64)
+#define MPEG4ENCAPI __stdcall
+#else
+#define MPEG4ENCAPI
+#endif
+#endif
+
+/*-------------------- enum definitions -----------------------------------*/
+
+typedef enum 
+{
+  AUD_OBJ_TYP_LC              = 2,   /* AAC LC                                          */
+  AUD_OBJ_TYP_LTP             = 4,   /* AAC LTP                                         */
+  AUD_OBJ_TYP_HEAAC           = 5,   /* AAC LC + SBR                                    */
+  AUD_OBJ_TYP_ER_LC           = 17,  /* ER AAC LC                                       */
+  AUD_OBJ_TYP_ER_LTP          = 19,  /* ER AAC LTP                                      */
+  AUD_OBJ_TYP_ER_SCAL         = 20,  /* ER AAC LC scalable                              */
+  AUD_OBJ_TYP_PS              = 29,  /* AAC LC + SBR + PS                               */
+  AUD_OBJ_TYP_MP2_LC          = 129, /* virtual AOT MP2 Low Complexity Profile          */
+  AUD_OBJ_TYP_MP2_SBR         = 132, /* virtual AOT MP2 Low Complexity Profile with SBR */
+  AUD_OBJ_TYP_SBR_DS          = 133, /* virtual AOT for downsampled SBR                 */
+  AUD_OBJ_TYP_ER_SCAL_SBR     = 148, /* ER AAC LC scalable + SBR                        */
+  AUD_OBJ_TYP_ER_SCAL_SBR_PS  = 157,  /* ER AAC LC scalable + SBR + PS                  */
+  AUD_OBJ_TYP_MPS             =  30
+} AUD_OBJ_TYP;
+
+typedef enum {
+  MP4_QUAL_FAST=0,
+  MP4_QUAL_MEDIUM,
+  MP4_QUAL_HIGH,
+  MP4_QUAL_HIGHEST      /* Always resample to preferred sample rate */
+} MPEG4ENC_QUALITY;
+
+typedef enum {
+  MP4_TT_RAW        = 0,
+  MP4_TT_ADIF       = 1,
+  MP4_TT_ADTS       = 2,
+  MP4_TT_ADTSCRC    = 3,
+  MP4_TT_LOAS       = 4,
+  MP4_TT_LOAS_NOSMC = 5,
+  MP4_TT_LATM       = 6,
+  MP4_TT_LATM_NOSMC = 7,
+  /* MP4_TT_LOAS_CRC = 8, */
+  /* MP4_TT_LATM_CRC = 9, */
+  ___mp4_tt_dummy
+} MPEG4ENC_TRANSPORT_TYPE;
+
+typedef enum {
+  /*  These are the standard MPEG Channel mappings */
+  MP4_CH_MODE_INVALID = 0,
+  MP4_CH_MODE_MONO,         /* 1   channel mono   */
+  MP4_CH_MODE_STEREO,       /* 2   channel stereo */
+  MP4_CH_MODE_3,            /* 3   channel audio ( center + left/right front                       speaker       ) */
+  MP4_CH_MODE_4,            /* 4   channel audio ( center + left/right front +     rear   surround speaker       ) */
+  MP4_CH_MODE_5,            /* 5   channel audio ( center + left/right front + left/right surround speaker       ) */
+  MP4_CH_MODE_5_1,          /* 5.1 channel audio ( center + left/right front + left/right surround speaker + LFE ) */
+  MP4_CH_MODE_7_1,          /* 7.1 channel audio ( center + left/right front 
+                                                      +  left/right outside front + left/right surround speaker + LFE ) */
+  /* Channel mappings 8 to 15 are reserved */
+  MP4_CH_MODE_6_1               = 11, /* 6.1 channel audio ( center + front left/right + surround left/right + rear surround center     + LFE ) */
+  MP4_CH_MODE_7_1_REAR_SURROUND = 12, /* 7.1 channel audio ( center + front left/right + surround left/right + rear surround left/right + LFE ) */
+  MP4_CH_MODE_7_1_TOP_FRONT     = 14, /* 7.1 channel audio ( center + front left/right + surround left/right + LFE  + + TOP front left/right  ) */
+
+  /* Some non standard channel mappings */
+  MP4_CH_MODE_DUAL_MONO = 16, /*  2 independent channels */
+  MP4_CH_MODE_4TIMES1,        /*  4 independent channels */
+  MP4_CH_MODE_6TIMES1,        /*  6 independent channels */
+  MP4_CH_MODE_8TIMES1,        /*  8 independent channels */
+  MP4_CH_MODE_12TIMES1,       /* 12 independent channels */
+  MP4_CH_MODE_16TIMES1,
+  MP4_CH_MODE_2TIMES2,        /*  2 stereo channel pairs */
+  MP4_CH_MODE_3TIMES2,        /*  3 stereo channel pairs */
+  MP4_CH_MODE_4TIMES2,        /*  4 stereo channel pairs */
+  MP4_CH_MODE_6TIMES2,        /*  6 stereo channel pairs */
+
+  MP4_CH_MODE_7_1_SIDE_CHANNEL = 32, /* 7.1 channel audio ( center + left/right front
+                                                            + left/right side channels + left/right surround speakers + LFE ) */
+  MP4_CH_MODE_7_1_FRONT_CENTER,      /* 7.1 channel audio ( center + left/right front
+                                                            + left/right frontal center speakers + left/right surround speakers + LFE ) */
+
+  /* Channel mapping for parametric stereo 
+     (only works with AUD_OBJ_TYP_HEAAC, AUD_OBJ_TYP_PS)   */
+  MP4_CH_MODE_PARAMETRIC_STEREO = 64,  /* 2 channel stereo input, transmit 1 channel mono + SBR + PS */
+  MP4_CH_MODE_MPEGS_5x5         = 128, /* 6 channel input, transmit 1/2 channel(s) (+ SBR) + MPEGS Payload */
+#ifdef SUPPORT_UPMIX
+  MP4_CH_MODE_MPEGS_SXPRO_UPMIX,       /* 2 channel input, sxPro Upmix,  transmit 2 channel(s) (+ SBR) + MPEGS Payload */
+#endif
+#ifdef SUPPORT_MPS_7_X_7
+  MP4_CH_MODE_MPEGS_7x7_REAR_SURROUND, /* 8 channel input (5.1 + left/right side speakers), transmit 2 channel(s) (+ SBR) + MPEGS Payload */ 
+  /* 7.1 front center channel mapping is not yet supported! */
+  MP4_CH_MODE_MPEGS_7x7_FRONT_CENTER,  /* 8 channel input (5.1 + left/right frontal center speakers), transmit 2 channel(s) (+ SBR) + MPEGS Payload */
+#ifdef SUPPORT_MPS_7_5_7
+  MP4_CH_MODE_MPEGS_757_FRONT_CENTER,  /* 8 channel input (5.1 + left/right frontal center speakers), transmit 5 channel(s) (+ SBR) + MPEGS Payload */
+  MP4_CH_MODE_MPEGS_757_REAR_SURROUND, /* 8 channel input (5.1 + left/right side speakers), transmit 5 channel(s) (+ SBR) + MPEGS Payload */
+#endif /* SUPPORT_MPS_7_5_7 */
+#endif /* SUPPORT_MPS_7_X_7 */
+
+  /* The following channel mappings are not yet supported! */
+  MP4_CH_MODE_MPEGS_5x5_BLIND,
+  MP4_CH_MODE_MPEGS_ARBITRARY_DOWNMIX_MONO,  /* 7 channel input, transmit 1 channel (+ SBR) + MPEGS Payload */
+  MP4_CH_MODE_MPEGS_ARBITRARY_DOWNMIX_STEREO /* 8 channel input, transmit 2 channel(s) (+ SBR) + MPEGS Payload */
+
+} MPEG4ENC_CH_MODE;
+
+typedef enum {
+
+  MP4_MPEGS_DOWNMIX_DEFAULT = 0, 
+  /* The following config (FORCE_STEREO) is not yet supported! */
+  MP4_MPEGS_DOWNMIX_FORCE_STEREO,
+  MP4_MPEGS_DOWNMIX_MATRIX_COMPAT,
+  /* The following configs are not yet supported! */
+  MP4_MPEGS_DOWNMIX_ARBITRARY_MONO,
+  MP4_MPEGS_DOWNMIX_ARBITRARY_STEREO
+#ifdef SUPPORT_MPS_7_5_7
+  , MP4_MPEGS_DOWNMIX_51
+#endif /* SUPPORT_MPS_7_5_7 */
+
+} MPEG4ENC_MPEGS_DOWNMIX_CONFIG;
+
+
+typedef enum {
+  MPEG4ENC_NO_ERROR = 0,
+  MPEG4ENC_UNKNOWN_ERROR, 
+  MPEG4ENC_PARAM_ERROR,
+  MPEG4ENC_NOTIMPLEMENTED_ERROR,
+  MPEG4ENC_MEMORY_ERROR,
+  MPEG4ENC_INIT_ERROR,
+  MPEG4ENC_FATAL_ERROR,
+  MPEG4ENC_STACK_ALIGNMENT_ERROR,
+  MPEG4ENC_METADATA_ERROR,
+  MPEG4ENC_AOT_NOT_SUPPORTED = 64,
+  MPEG4ENC_CHMODE_NOT_SUPPORTED,
+  MPEG4ENC_BRMODE_NOT_SUPPORTED,
+  MPEG4ENC_WARNING_MIN = 128,
+  MPEG4ENC_WARNING_STACK_ALIGNMENT = MPEG4ENC_WARNING_MIN,
+  MPEG4ENC_WARNING_METADATA,
+  MPEG4ENC_WARNING_NOSYNC_TRIGGERED
+} MPEG4ENC_ERROR;
+
+typedef enum {
+  MP4_SBRSIG_IMPLICIT  = 0, /* implicit signaling  (signaling 1) */
+  MP4_SBRSIG_EXPL_BC   = 1, /* explicit backward compatible signaling (signaling 2.B.) */
+  MP4_SBRSIG_EXPL_HIER = 2  /* explicit hierarchical signaling (signaling 2.A.) */
+} MPEG4ENC_SIGNALING_MODE;
+
+typedef enum {
+  MP4_MPEGS_PAYLOAD_EMBED        = 0,   /* in case of MPEG-4 transportation, embed payload into AAC payload */
+  MP4_MPEGS_NO_PAYLOAD_EMBED     = 1,   /* in case of MPEG-4 transportation, do *not* embed payload into AAC payload, but transport payload in extra stream */
+  MP4_MPEGS_PAYLOAD_EMBED_ASCEXT = 2    /* M16117 */
+} MPEG4ENC_MPEGS_PAYLOAD_MODE;
+
+typedef enum {
+  MP4_BR_MODE_CBR = 0, 
+  MP4_BR_MODE_VBR_1   = 1,
+  MP4_BR_MODE_VBR_2   = 2,
+  MP4_BR_MODE_VBR_3   = 3,
+  MP4_BR_MODE_VBR_4   = 4,
+  MP4_BR_MODE_VBR_5   = 5,
+  MP4_BR_MODE_VBR_6   = 6,
+  MP4_BR_MODE_SFR     = 7, /* Superframing */
+  MP4_BR_MODE_DABPLUS = 8, /* Superframing + DAB+ constraints */
+  MP4_BR_MODE_DRMPLUS = 9, /* Superframing + DRM+ constraints */
+  MP4_BR_MODE_DMB     = 10
+} MPEG4ENC_BITRATE_MODE; 
+
+typedef enum{
+  MP4_GRANULE_960 = 960,
+  MP4_GRANULE_1024 = 1024
+} MPEG4ENC_GRANULE_LEN;
+
+typedef enum {
+  MP4_METADATA_NONE         = 0, /* do not embed any metadata */
+  MP4_METADATA_MPEG,             /* embed MPEG defined metadata only */
+  MP4_METADATA_MPEG_ETSI         /* embed all metadata */
+} MPEG4ENC_METADATA_MODE;
+
+typedef enum {
+  MP4_METADATA_DRC_NONE          = 0,
+  MP4_METADATA_DRC_FILMSTANDARD,
+  MP4_METADATA_DRC_FILMLIGHT,
+  MP4_METADATA_DRC_MUSICSTANDARD,
+  MP4_METADATA_DRC_MUSICLIGHT,
+  MP4_METADATA_DRC_SPEECH,
+#ifdef SUPPORT_METADATA_DRC_MOBILE
+  MP4_METADATA_DRC_MOBILE,
+#endif
+  MP4_METADATA_DRC_EMBED_EXTERN = -1,
+  MP4_METADATA_DRC_NOT_PRESENT = -2
+} MPEG4ENC_METADATA_DRC_PROFILE;
+
+typedef enum {
+  MPEG4ENC_METADATA_DMX_GAIN_0_dB    = 0,
+  MPEG4ENC_METADATA_DMX_GAIN_1_5_dB  = 1,
+  MPEG4ENC_METADATA_DMX_GAIN_3_dB    = 2,
+  MPEG4ENC_METADATA_DMX_GAIN_4_5_dB  = 3,
+  MPEG4ENC_METADATA_DMX_GAIN_6_dB    = 4,
+  MPEG4ENC_METADATA_DMX_GAIN_7_5_dB  = 5,
+  MPEG4ENC_METADATA_DMX_GAIN_9_dB    = 6,
+  MPEG4ENC_METADATA_DMX_GAIN_INF     = 7,
+} MPEG4ENC_METADATA_DMX_GAIN;
+
+typedef enum {
+  MP4_METADATA_DSUR_NOT_INDICATED  = 0, /* Dolby Surround mode not indicated */
+  MP4_METADATA_DSUR_NOT_USED       = 1, /* 2-ch audio part is not Dolby surround encoded */
+  MP4_METADATA_DSUR_IS_USED        = 2  /* 2-ch audio part is Dolby surround encoded */
+} MPEG4ENC_METADATA_DSUR_IND;
+
+typedef enum {                          /* see ETSI TS 101 154 V1.11.1, section C.5.2.2.3 and C.5.3 */
+  MP4_METADATA_DRCPRESENTATION_NOT_INDICATED = 0,
+  MP4_METADATA_DRCPRESENTATION_MODE_1 = 1,
+  MP4_METADATA_DRCPRESENTATION_MODE_2 = 2
+} MPEG4ENC_METADATA_DRCPRESENTATION;
+
+typedef enum {
+  MP4_MAX_ASC_SIZE = 64,
+  MP4_MAX_SMC_SIZE = 256,
+  MAX_DRC_BANDS = (1<<4),
+  MP4_MAX_NUM_STREAMS =  2
+} MPEG4ENC_DEFINES;   
+
+
+typedef enum {
+  MPEG4ENC_SYNCFRAME_STARTUP = 0,
+  MPEG4ENC_SYNCFRAME_SWITCH,
+  MPEG4ENC_SYNCFRAME_DASH
+} MPEG4ENC_SYNCFRAME_TYPES;   
+
+typedef enum {
+  MP4_MPSDMXGAIN_INVALID =  -1,
+  MP4_MPSDMXGAIN_0_dB    =   0,
+  MP4_MPSDMXGAIN_1_5_dB  =   1,
+  MP4_MPSDMXGAIN_3_dB    =   2,
+  MP4_MPSDMXGAIN_4_5_dB  =   3,
+  MP4_MPSDMXGAIN_6_dB    =   4,
+  MP4_MPSDMXGAIN_7_5_dB  =   5,
+  MP4_MPSDMXGAIN_9_dB    =   6,
+  MP4_MPSDMXGAIN_12_dB   =   7
+} MPEG4ENC_MPS_DMX_GAIN;
+
+#ifdef SUPPORT_UPMIX
+typedef enum {
+  MP4_SXPRO_DEFAULT = 0,
+  MP4_SXPRO_DRY,
+  MP4_SXPRO_VIBRANT
+} MP4_SXPRO_UPMIX_WORKMODE;
+
+typedef enum {
+  MP4_SXPRO_LFE_OFF = 0,
+  MP4_SXPRO_LFE_ON
+} MP4_SXPRO_UPMIX_LFE;
+#endif
+
+/*-------------------- structure definitions ------------------------------*/
+
+typedef struct {
+  AUD_OBJ_TYP               aot;
+  int                       nBitRate;
+  MPEG4ENC_BITRATE_MODE     bitrateMode;
+  MPEG4ENC_QUALITY          quality;
+  MPEG4ENC_CH_MODE          chMode;
+  int                       nSampleRateIn;
+  MPEG4ENC_TRANSPORT_TYPE   transportFormat;
+  MPEG4ENC_SIGNALING_MODE   sbrSignaling;
+  MPEG4ENC_GRANULE_LEN      nGranuleLength;
+  MPEG4ENC_METADATA_MODE    metadataMode;
+} MPEG4ENC_SETUP;
+
+typedef enum{
+  MP4_THREADING_MODE_SINGLE = 1,
+  MP4_THREADING_MODE_MULTIPLE_BLOCKING,
+  MP4_THREADING_MODE_MULTIPLE_NOBLOCKING
+} MPEG4ENC_THREADING_MODE;
+
+
+typedef MPEG4ENC_SETUP *HANDLE_MPEG4ENC_SETUP;
+
+struct MPEG4ENC_ENCODER;
+typedef struct MPEG4ENC_ENCODER * HANDLE_MPEG4ENC_ENCODER;
+
+typedef struct
+{
+  int  nOutputStreams;                              /* number of output streams */
+  int  nAccessUnitsPerStream[MP4_MAX_NUM_STREAMS];  /* number of AUs in bitstream buffer */
+  int *pnAccessUnitOffset[MP4_MAX_NUM_STREAMS];     /* offset of AUs per stream, i.e. pnAccessUnitOffset[stream][numberAuPerStream] */
+  int *pByteCnt[MP4_MAX_NUM_STREAMS];               /* lenght of each single AU in bitstream buffer */
+  int *pIsSync[MP4_MAX_NUM_STREAMS];            /* flag, signaling if AU is self contained i.e. does not contain backward dependencies */
+} MPEG4ENC_AUINFO;
+
+typedef struct {
+  int            nAscSizeBits;
+  unsigned char  ascBuffer[MP4_MAX_ASC_SIZE];
+} MPEG4ENC_ASCBUF;
+
+typedef struct {
+  int            nSmcSizeBits;
+  unsigned char  smcBuffer[MP4_MAX_ASC_SIZE];
+} MPEG4ENC_SMCBUF;
+
+typedef struct 
+{
+  float fBandWidth;       /* audio bandwidth in Hz */
+  int   nDelay;           /* encoder delay in units of sample frames */
+  int   nDelayCore;       /* encoder delay in units of sample frames */
+  int   nCbBufSizeMin;    /* minimum size of output buffer (bytes) */
+  int   nSyncFrameDelay;
+
+  int   nBitRate[MP4_MAX_NUM_STREAMS];
+  int   nMaxBitRate[MP4_MAX_NUM_STREAMS];
+  int   nBitResMax[MP4_MAX_NUM_STREAMS];
+  int   nSamplingRate[MP4_MAX_NUM_STREAMS];
+  int   nSamplesFrame[MP4_MAX_NUM_STREAMS];
+
+  unsigned int   nAncBytesPerFrame;
+  int   aot;
+  int   nValidAsc;
+  MPEG4ENC_ASCBUF ascBuf[MP4_MAX_NUM_STREAMS];
+  MPEG4ENC_SMCBUF smcBuf;
+  int   nProfLev;
+
+  char  pVersion[50];
+  char  pBuildDate[50];
+
+} MPEG4ENC_INFO;
+
+typedef struct MPEG4ENC_METADATA
+{
+  MPEG4ENC_METADATA_DRC_PROFILE drc_profile;  /* MPEG DRC compression profile */
+  MPEG4ENC_METADATA_DRC_PROFILE comp_profile; /* ETSI heavy compression profile */
+
+  float drc_TargetRefLevel;   /* used to define expected level to */
+  float comp_TargetRefLevel;  /* adjust limiter to avoid overload */
+
+  float drc_ext;  /* external feed DRC compression value */
+  float comp_ext; /* external feed heavy compression value */
+
+  int prog_ref_level_present;   /* flag, if prog_ref_level is present */
+  float prog_ref_level;         /* Programme Reference Level = Dialogue Level: */
+                                /*    -31.75dB .. 0 dB ; stepsize: 0.25dB      */
+
+  int  PCE_mixdown_idx_present; /* flag, if dmx-idx should be written in programme config element */
+  int  ETSI_DmxLvl_present;     /* flag, if dmx-lvl should be written in ETSI-ancData */
+  MPEG4ENC_METADATA_DMX_GAIN  centerMixLevel;          /* center downmix level */
+  MPEG4ENC_METADATA_DMX_GAIN  surroundMixLevel;        /* surround downmix level */
+
+  MPEG4ENC_METADATA_DSUR_IND dolbySurroundMode;   /* Indication for Dolby Surround Encoding Mode */
+
+  MPEG4ENC_METADATA_DRCPRESENTATION drcPresentationMode; /* DRC presentation mode (ETSI) */
+
+  /* preprocessing */
+  int dcFilter;             /* flag specifying if DC filtering is applied to input */
+  int lfeLowpassFilter;     /* flag specifying if 120 Hz low-pass filter is applied to LFE channel */
+  int surPhase90;           /* flag specifying if 90 degree phase shift is applied to surround channels */
+  int surAtt3dB;            /* flag specifying if 3 dB attenuation is applied to surround channels */
+
+} MPEG4ENC_METADATA;
+
+typedef struct MPEG4ENC_EXTMETADATA
+{
+#if 1 /* ENABLE_ISO14496_3_2009_AMD4 */
+  /* not fully supported yet */
+  /* extended ancillary data */
+  int pseudoSurroundEnable;     /* flag */
+  int extAncDataEnable;         /* flag */
+  int extDownmixLevelEnable;    /* flag */
+  int extDownmixLevel_A;        /* downmix level index A (0...7, according to table) */
+  int extDownmixLevel_B;        /* downmix level index B (0...7, according to table) */
+  int dmxGainEnable;            /* flag */
+  float dmxGain5;               /* gain factor for downmix to 5 channels */
+  float dmxGain2;               /* gain factor for downmix to 2 channels */
+  int lfeDmxEnable;             /* flag */
+  int lfeDmxLevel;              /* downmix level index for LFE (0..15, according to table) */
+#endif
+} MPEG4ENC_EXTMETADATA;
+
+typedef struct MPEG4ENC_METADATA *HANDLE_MPEG4ENC_METADATA;
+typedef struct MPEG4ENC_EXTMETADATA *HANDLE_MPEG4ENC_EXTMETADATA;
+
+
+/*-------------------- function prototypes --------------------------------*/
+
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_Configure
+    description : fills encoder handle structure with default values
+                  to be called before MPEG4ENC_Open                  
+    returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_Configure (
+                    HANDLE_MPEG4ENC_ENCODER     *phMp4Enc,  /* adress of encoder handle */
+                    const HANDLE_MPEG4ENC_SETUP  hSetup     /* handle to filled setup stucture  */
+                    );
+
+/*---------------------------------------------------------------------------
+
+    functionname:MPEG4ENC_GetVersionInfo
+    description: get Version Number information about the encoding process 
+    returns:     MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI
+MPEG4ENC_GetVersionInfo(char *const pVersionInfo,
+                        const int bufSize);
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_Open
+    description:  allocate and initialize a new encoder instance
+                  samplesFirst holds the desired number of input
+                  samples (of all channels) for the first frame
+    returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+  ---------------------------------------------------------------------------*/
+
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_Open(
+              HANDLE_MPEG4ENC_ENCODER *phMp4Enc,     /* pointer to encoder handle, initialized on return */
+              unsigned int* const      pSamplesFirst /* number of samples needed to encode the first frame */
+              );
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_Close
+    description:  deallocate an encoder instance
+    returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+  ---------------------------------------------------------------------------*/
+
+MPEG4ENC_ERROR MPEG4ENCAPI
+MPEG4ENC_Close (
+                HANDLE_MPEG4ENC_ENCODER* phMp4Enc  /* pointer to an encoder handle */
+                );
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_Encode
+    description:  encode the passed samples
+    modifies:     pSamplesConsumed: number of used samples
+                  pSamplesNext: number of samples needed to encode
+                  the next frame
+                  pOutputBytes: number of valid bytes in pOutput
+    returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+  ---------------------------------------------------------------------------*/
+
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_Encode(
+                HANDLE_MPEG4ENC_ENCODER const hMp4Enc,          /* an encoder handle */
+                const float* const            pSamples,         /* pointer to audio samples, interleaved*/
+                const int                     nSamples,         /* number of samples
+                                                                   must be a multiple of number of input channels */
+                int*                          pSamplesConsumed, /* number of used input samples,
+                                                                   will be a multiple of number of input channels */
+                unsigned int* const           pSamplesNext,     /* number of desired samples for a complete frame */
+                unsigned char* const          pOutput,          /* pointer to bitstream buffer */
+                const int                     nOutputBufSize,   /* the size of the output buffer; 
+                                                                   must be large enough to receive all data */
+                int* const                    pOutputBytes,     /* number of bytes in bitstream buffer */
+                MPEG4ENC_AUINFO             **ppAuInfo          /* */  
+                );
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_SRInfo
+    description : returns the sample rate range and 
+                  to be called before MPEG4ENC_Open                  
+    returns:      MPEG4ENC_NO_ERROR on success,
+                  MPEG4ENC_INIT_ERROR if the bitrate, channel, aot configuration 
+                  is not supported
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_SRInfo (
+
+                 const int       bitRate,        /* the targeted bit rate            */
+                 const MPEG4ENC_BITRATE_MODE  bitrateMode,    /* the bitrateMode */
+                 const MPEG4ENC_CH_MODE       chMode,         /* the number of channels to encode */
+                 const AUD_OBJ_TYP            aot,            /* the audio object type */
+                 const MPEG4ENC_QUALITY       quality,        /* encoder quality       */
+                       int *const             sampleRateMin,  /* lowest supported      */
+                       int *const             sampleRateMax,  /* highest supported     */
+                       int *const             sampleRatePref  /* preferred
+                                                                 sampling frequency for the given 
+                                                                 bitrate, channel, aot configuration */
+                 );
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_GetInfo
+    description:  get information about the encoding process
+    returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI
+MPEG4ENC_GetInfo(const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                       MPEG4ENC_INFO * const   pInfo);
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetAncDataRate
+  description:  Sets bitrate for ancillary data
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetAncDataRate(
+                     HANDLE_MPEG4ENC_ENCODER hMp4Enc,                     
+                     int                     nAncDataRate 
+                     );
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetAncData
+  description:  Passes ancillary data to encoder
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_SetAncData(
+                    HANDLE_MPEG4ENC_ENCODER    const hMp4Enc,    /* an encoder handle */
+                    unsigned char*             pAncBytes,        /* ancillary data buffer */
+                    unsigned int*              pNumAncBytes      /* ancillary data bytes left */
+                    );
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetOffsets
+  description:  changes mapping of input audio channels to AAC channels
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetOffsets(
+                     const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                     const unsigned int            nChannels,
+                     const unsigned int *const     channelOffset
+                     );
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetSbrTransmissionConfig
+  description:  changes signaling interval of SBR header, additional CRC bits 
+                for SBR data
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetSbrTransmissionConfig(
+                                  const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                                  const int                     bUseCRC,
+                                  const float                   sendHeaderTimeInterval
+                                  );
+
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetInbandPceTimeInterval 
+  description:  set update interval for explicit in band  PCE transmission 
+                sendPceTimeInterval  > 0 -> regular time interval in seconds
+                sendPceTimeInterval == 0 -> send no PCE (MPEG-2 only)
+                sendPceTimeInterval  < 0 -> send PCE only the 1st frame
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetInbandPceTimeInterval(const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                                  const float                   sendPceTimeInterval);
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetAdtsPceTimeInterval 
+  description:  set update interval for explicit channel signaling via PCE in
+                case of ADTS transport stream, MPEG-2/4 AAC and 
+                channel_configuration == 0
+                sendPceTimeInterval  > 0 -> regular time interval in seconds
+                sendPceTimeInterval == 0 -> send no PCE (MPEG-2 only)
+                sendPceTimeInterval  < 0 -> send PCE only the 1st frame
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetAdtsPceTimeInterval(
+				const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+				const float                   sendPceTimeInterval
+				);
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_MpsSetSscTimeInterval 
+  description:  set update interval for transmission of SpatialSpecificConfig
+                (SSC) in case of encoding using MPEG Surround 
+                sendSscTimeInterval  > 0 -> regular time interval in seconds
+                sendSscTimeInterval == 0 -> send SSC every (MPEGS) frame
+                sendSscTimeInterval  < 0 -> send SSC only the 1st frame
+                - in combination with MPEGS only
+                - MPEGS payload mode has to be MP4_MPEGS_PAYLOAD_EMBED, because 
+                  otherwise the SSC is transmitted in a seperate ESD, which has 
+                  to be handled by the user
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_MpsSetSscTimeInterval(
+                               const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                               const float                   sendSscTimeInterval
+                               );
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_MpsSetDownmixConfig
+  description:  set MPEG Surround Downmix Configuration
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_MpsSetDownmixConfig(
+                             const HANDLE_MPEG4ENC_ENCODER       hMp4Enc,
+                             const MPEG4ENC_MPEGS_DOWNMIX_CONFIG mpegsDownmixCfg
+                             );
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_MpsSetPayloadMode
+  description:  set MPEG Surround Payload Transmission Mode 
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_MpsSetPayloadMode(
+                           const HANDLE_MPEG4ENC_ENCODER       hMp4Enc,
+                           const MPEG4ENC_MPEGS_PAYLOAD_MODE   mpegsPayloadMode
+                           );
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetThreadingMode (deprecated)
+  description:  sets threading mode to single threaded, multiple threaded
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+  Please note that this function is deprecated and should not be used any more.
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetThreadingMode(const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                          const MPEG4ENC_THREADING_MODE threadingMode);
+
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_GetError
+  description:  get error text
+  returns:      pointer to an error text
+
+ ------------------------------------------------------------------------------*/
+char*  MPEG4ENCAPI 
+MPEG4ENC_GetError(MPEG4ENC_ERROR error);
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetBandwidth
+  description:  set bandwidth by user, returns with actual used bandwidth
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetBandwidth(const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                      const float proposedBandwidth,
+                      float* usedBandwidth);
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetStereoPrePro
+  description:  set bandwidth by user, returns with actual used bandwidth
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetStereoPrePro(const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                         const int enableStereoPrePro);
+
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetLatmSmcTimeInterval 
+  description:  set update interval for appearance of stream mux config in
+                case of LOAS/LATM transport stream
+                sendSmcTimeInterval  > 0 -> regular time interval (every n-th frame, default: 8)
+                sendSmcTimeInterval == 0 -> send no inband StreamMuxConfig
+                sendSmcTimeInterval  < 0 -> send StreamMuxConfig only the 1st frame
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetLatmSmcTimeInterval(
+				const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+				const int                     sendSmcTimeInterval
+				);
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetLatmNrOfSubframes
+  description:  set the nr of subframes per latm frame in
+                case of LOAS/LATM transport stream
+                nrOfSubframes < 1  -> reserved
+                nrOfSubframes >= 1 -> use 'nrOfSubframes'
+
+                optional, default is 1
+
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetLatmNrOfSubframes(
+                              const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                              const int                     nrOfSubframes
+                              );
+
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_GetLatmSmc
+  description:  returns pointer to and size of LATM stream mux config
+
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_GetLatmSmc(
+                    const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                    unsigned char**               buffer,
+                    int*                          nBits
+                    );
+
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_Submit_Metadata
+    description:  submit metadata
+    returns:      MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_Submit_Metadata(
+                         const HANDLE_MPEG4ENC_ENCODER  hMpeg4Enc,        /* an encoder handle */
+                         const HANDLE_MPEG4ENC_METADATA pMetadata         /* pointer to metadata */
+                        );
+                        
+                        
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_Submit_ExtMetadata
+    description:  submit metadata
+    returns:      MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_Submit_ExtMetadata(
+                         const HANDLE_MPEG4ENC_ENCODER  hMpeg4Enc,        /* an encoder handle */
+                         const HANDLE_MPEG4ENC_EXTMETADATA pExtMetadata   /* pointer to extended metadata */
+                        );
+
+
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_BRInfo
+    description : Provides the compatible bitrate range
+    returns:      MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_BRInfo (
+                 const AUD_OBJ_TYP        aot,
+                 const MPEG4ENC_CH_MODE   chMode,
+                 const int                samplingRate,
+                 int*                     brMin,
+                 int*                     brMax);
+
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_SetSbrSpeechConfig
+    description : Sets SBR Speech config flag
+    returns:      MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_SetSbrSpeechConfig(
+                            const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                            unsigned int                  flag
+                           );
+
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_SetSbrTimeDiffCoding
+    description : Sets SBR time differential coding (TDC); 
+                    flag==0: Do not use TDC
+                    flag==1: Use TDC
+    returns:      MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_SetSbrTimeDiffCoding(
+                              const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                              unsigned int                  flag
+                             );
+
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_SetUseIntensityStereo
+    description : Sets intensity stereo coding (IS); 
+                    flag==1: Use IS (default)
+                    flag==0: Do not use IS
+    returns:      MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_SetUseIntensityStereo(
+                               const HANDLE_MPEG4ENC_ENCODER hMp4Enc,
+                               unsigned int                  flag
+                              );
+
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SendChCfgZero
+  description:  will always use channel config zero + pce although a standard 
+                channel config could be signalled
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SendChCfgZero(
+                       const HANDLE_MPEG4ENC_ENCODER hMp4Enc
+                       );
+
+
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetSyncFrame
+  description:  will generate a synchaable frame
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetSyncFrame(
+                      const HANDLE_MPEG4ENC_ENCODER hMp4Enc
+                      );
+
+
+/*-----------------------------------------------------------------------------
+
+  functionname: MPEG4ENC_SetSyncFrameWithType
+  description:  will generate a synchaable frame
+  returns:      MPEG4ENC_NO_ERROR on success, an appropriate error code else
+
+ ------------------------------------------------------------------------------*/
+MPEG4ENC_ERROR  MPEG4ENCAPI
+MPEG4ENC_SetSyncFrameWithType(
+                              const HANDLE_MPEG4ENC_ENCODER  hMp4Enc,
+                              const MPEG4ENC_SYNCFRAME_TYPES syncType
+                              );
+
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_InitDASH
+    description : Configure encoder for DASH mode
+    returns:      MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_InitDASH(
+                  const HANDLE_MPEG4ENC_ENCODER   hMp4Enc
+                  );
+
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_SetTransportType
+    description : Reconfigure Transport Format
+    returns:      MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_SetTransportType(
+                          const HANDLE_MPEG4ENC_ENCODER   hMp4Enc,
+                          const MPEG4ENC_TRANSPORT_TYPE   transportType
+                          );
+
+
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_SetMPEG4Flag
+    description : Reconfigure MPEG-2/4 compliance
+    returns:      MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_SetMPEG4Flag(
+                      const HANDLE_MPEG4ENC_ENCODER   hMp4Enc,
+                      const int                       mpeg4Flag
+                      );
+
+
+#ifdef SUPPORT_UPMIX
+/*---------------------------------------------------------------------------
+
+    functionname: MPEG4ENC_SetSXProUpmixParameter
+    description : Sets SXPro parameters; 
+                    umxMode: Upmix workmode
+                    umxLFE:  Upmix LFE on/off
+    returns:      MPEG4ENC_ERROR (error code)
+
+  ---------------------------------------------------------------------------*/
+MPEG4ENC_ERROR MPEG4ENCAPI 
+MPEG4ENC_SetSXProUpmixParameter(
+                                const HANDLE_MPEG4ENC_ENCODER   hMp4Enc,
+                                const MP4_SXPRO_UPMIX_WORKMODE  umxMode,
+                                const MP4_SXPRO_UPMIX_LFE       umxLFE
+                               );
+#endif
+
+
+/*---------------------------------------------------------------------------*/
+#if defined(WIN32) || defined(WIN64)
+#pragma pack(pop)
+#endif
+
+/*-------------------------------------------------------------------------*/
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _mp4FastAAClib_h_  */