• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 
2 /* -----------------------------------------------------------------------------------------------------------
3 Software License for The Fraunhofer FDK AAC Codec Library for Android
4 
5 � Copyright  1995 - 2013 Fraunhofer-Gesellschaft zur F�rderung der angewandten Forschung e.V.
6   All rights reserved.
7 
8  1.    INTRODUCTION
9 The Fraunhofer FDK AAC Codec Library for Android ("FDK AAC Codec") is software that implements
10 the MPEG Advanced Audio Coding ("AAC") encoding and decoding scheme for digital audio.
11 This FDK AAC Codec software is intended to be used on a wide variety of Android devices.
12 
13 AAC's HE-AAC and HE-AAC v2 versions are regarded as today's most efficient general perceptual
14 audio codecs. AAC-ELD is considered the best-performing full-bandwidth communications codec by
15 independent studies and is widely deployed. AAC has been standardized by ISO and IEC as part
16 of the MPEG specifications.
17 
18 Patent licenses for necessary patent claims for the FDK AAC Codec (including those of Fraunhofer)
19 may be obtained through Via Licensing (www.vialicensing.com) or through the respective patent owners
20 individually for the purpose of encoding or decoding bit streams in products that are compliant with
21 the ISO/IEC MPEG audio standards. Please note that most manufacturers of Android devices already license
22 these patent claims through Via Licensing or directly from the patent owners, and therefore FDK AAC Codec
23 software may already be covered under those patent licenses when it is used for those licensed purposes only.
24 
25 Commercially-licensed AAC software libraries, including floating-point versions with enhanced sound quality,
26 are also available from Fraunhofer. Users are encouraged to check the Fraunhofer website for additional
27 applications information and documentation.
28 
29 2.    COPYRIGHT LICENSE
30 
31 Redistribution and use in source and binary forms, with or without modification, are permitted without
32 payment of copyright license fees provided that you satisfy the following conditions:
33 
34 You must retain the complete text of this software license in redistributions of the FDK AAC Codec or
35 your modifications thereto in source code form.
36 
37 You must retain the complete text of this software license in the documentation and/or other materials
38 provided with redistributions of the FDK AAC Codec or your modifications thereto in binary form.
39 You must make available free of charge copies of the complete source code of the FDK AAC Codec and your
40 modifications thereto to recipients of copies in binary form.
41 
42 The name of Fraunhofer may not be used to endorse or promote products derived from this library without
43 prior written permission.
44 
45 You may not charge copyright license fees for anyone to use, copy or distribute the FDK AAC Codec
46 software or your modifications thereto.
47 
48 Your modified versions of the FDK AAC Codec must carry prominent notices stating that you changed the software
49 and the date of any change. For modified versions of the FDK AAC Codec, the term
50 "Fraunhofer FDK AAC Codec Library for Android" must be replaced by the term
51 "Third-Party Modified Version of the Fraunhofer FDK AAC Codec Library for Android."
52 
53 3.    NO PATENT LICENSE
54 
55 NO EXPRESS OR IMPLIED LICENSES TO ANY PATENT CLAIMS, including without limitation the patents of Fraunhofer,
56 ARE GRANTED BY THIS SOFTWARE LICENSE. Fraunhofer provides no warranty of patent non-infringement with
57 respect to this software.
58 
59 You may use this FDK AAC Codec software or modifications thereto only for purposes that are authorized
60 by appropriate patent licenses.
61 
62 4.    DISCLAIMER
63 
64 This FDK AAC Codec software is provided by Fraunhofer on behalf of the copyright holders and contributors
65 "AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, including but not limited to the implied warranties
66 of merchantability and fitness for a particular purpose. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
67 CONTRIBUTORS BE LIABLE for any direct, indirect, incidental, special, exemplary, or consequential damages,
68 including but not limited to procurement of substitute goods or services; loss of use, data, or profits,
69 or business interruption, however caused and on any theory of liability, whether in contract, strict
70 liability, or tort (including negligence), arising in any way out of the use of this software, even if
71 advised of the possibility of such damage.
72 
73 5.    CONTACT INFORMATION
74 
75 Fraunhofer Institute for Integrated Circuits IIS
76 Attention: Audio and Multimedia Departments - FDK AAC LL
77 Am Wolfsmantel 33
78 91058 Erlangen, Germany
79 
80 www.iis.fraunhofer.de/amm
81 amm-info@iis.fraunhofer.de
82 ----------------------------------------------------------------------------------------------------------- */
83 
84 /**************************  MPEG-4 Transport Decoder  ************************
85 
86    Author(s): Manuel Jander
87    Description: MPEG Transport decoder
88 
89 ******************************************************************************/
90 
91 #include "tpdec_lib.h"
92 
93 /* library version */
94 #include "version"
95 
96 
97 #include "tp_data.h"
98 
99 #include "tpdec_adts.h"
100 
101 #include "tpdec_adif.h"
102 
103 #include "tpdec_latm.h"
104 
105 
106 
107 #define MODULE_NAME "transportDec"
108 
109 typedef union {
110   STRUCT_ADTS adts;
111 
112   CAdifHeader adif;
113 
114   CLatmDemux latm;
115 
116 
117 } transportdec_parser_t;
118 
119 struct TRANSPORTDEC
120 {
121   TRANSPORT_TYPE transportFmt;     /*!< MPEG4 transportDec type. */
122 
123   CSTpCallBacks callbacks;         /*!< Struct holding callback and its data */
124 
125   FDK_BITSTREAM bitStream[2]; /* Bitstream reader */
126   UCHAR *bsBuffer;                 /* Internal bitstreamd data buffer (unallocated in case of TT_MP4_RAWPACKETS) */
127 
128   transportdec_parser_t parser;    /* Format specific parser structs. */
129 
130   CSAudioSpecificConfig asc[(1*2)]; /* Audio specific config from the last config found. */
131   UINT  globalFramePos;            /* Global transport frame reference bit position. */
132   UINT  accessUnitAnchor[2];    /* Current access unit start bit position. */
133   INT   auLength[2];            /* Length of current access unit. */
134   INT   numberOfRawDataBlocks;     /* Current number of raw data blocks contained remaining from the current transport frame. */
135   UINT  avgBitRate;                /* Average bit rate used for frame loss estimation. */
136   UINT  lastValidBufferFullness;   /* Last valid buffer fullness value for frame loss estimation */
137   INT   remainder;                 /* Reminder in division during lost access unit estimation. */
138   INT   missingAccessUnits;        /* Estimated missing access units. */
139   UINT  burstPeriod;               /* Data burst period in mili seconds. */
140   UINT  holdOffFrames;             /* Amount of frames that were already hold off due to buffer fullness condition not being met. */
141   UINT  flags;                     /* Flags. */
142 };
143 
144 /* Flag bitmasks for "flags" member of struct TRANSPORTDEC */
145 #define TPDEC_SYNCOK                1
146 #define TPDEC_MINIMIZE_DELAY        2
147 #define TPDEC_IGNORE_BUFFERFULLNESS 4
148 #define TPDEC_EARLY_CONFIG          8
149 #define TPDEC_LOST_FRAMES_PENDING  16
150 #define TPDEC_CONFIG_FOUND         32
151 
152 C_ALLOC_MEM(Ram_TransportDecoder, TRANSPORTDEC, 1)
C_ALLOC_MEM(Ram_TransportDecoderBuffer,UCHAR,TRANSPORTDEC_INBUF_SIZE)153 C_ALLOC_MEM(Ram_TransportDecoderBuffer, UCHAR, TRANSPORTDEC_INBUF_SIZE)
154 
155 
156 
157 
158 HANDLE_TRANSPORTDEC transportDec_Open( const TRANSPORT_TYPE transportFmt, const UINT flags)
159 {
160   HANDLE_TRANSPORTDEC hInput;
161 
162   hInput = GetRam_TransportDecoder(0);
163   if ( hInput == NULL ) {
164     return NULL;
165   }
166 
167   /* Init transportDec struct. */
168   hInput->transportFmt = transportFmt;
169 
170   switch (transportFmt) {
171 
172   case TT_MP4_ADIF:
173     break;
174 
175   case TT_MP4_ADTS:
176     if (flags & TP_FLAG_MPEG4)
177       hInput->parser.adts.decoderCanDoMpeg4 = 1;
178     else
179       hInput->parser.adts.decoderCanDoMpeg4 = 0;
180     adtsRead_CrcInit(&hInput->parser.adts);
181     hInput->parser.adts.BufferFullnesStartFlag = 1;
182     hInput->numberOfRawDataBlocks = 0;
183     break;
184 
185 
186   case TT_MP4_LATM_MCP0:
187   case TT_MP4_LATM_MCP1:
188   case TT_MP4_LOAS:
189   case TT_MP4_RAW:
190     break;
191 
192   default:
193     FreeRam_TransportDecoder(&hInput);
194     hInput = NULL;
195     break;
196   }
197 
198   if (hInput != NULL) {
199     /* Create bitstream */
200     if ( TT_IS_PACKET(transportFmt) ) {
201       hInput->bsBuffer = NULL;
202     } else {
203       hInput->bsBuffer = GetRam_TransportDecoderBuffer(0);
204       if (hInput->bsBuffer == NULL) {
205           transportDec_Close( &hInput );
206           return NULL;
207       }
208       FDKinitBitStream(&hInput->bitStream[0], hInput->bsBuffer, TRANSPORTDEC_INBUF_SIZE, 0, BS_READER);
209     }
210 
211     hInput->burstPeriod = 0;
212   }
213 
214   return hInput;
215 }
216 
transportDec_OutOfBandConfig(HANDLE_TRANSPORTDEC hTp,UCHAR * conf,const UINT length,UINT layer)217 TRANSPORTDEC_ERROR transportDec_OutOfBandConfig(HANDLE_TRANSPORTDEC hTp, UCHAR *conf, const UINT length, UINT layer )
218 {
219   TRANSPORTDEC_ERROR     err        = TRANSPORTDEC_OK;
220 
221   FDK_BITSTREAM bs;
222   HANDLE_FDK_BITSTREAM  hBs        = &bs;
223 
224   FDKinitBitStream(hBs, conf, 0x10000000, length<<3, BS_READER);
225 
226   int fConfigFound = 0;
227 
228   /* config transport decoder */
229   switch (hTp->transportFmt) {
230     case TT_MP4_LATM_MCP0:
231     case TT_MP4_LATM_MCP1:
232     case TT_MP4_LOAS:
233       {
234         if (layer != 0) {
235           return TRANSPORTDEC_INVALID_PARAMETER;
236         }
237         CLatmDemux *pLatmDemux = &hTp->parser.latm;
238         err = CLatmDemux_ReadStreamMuxConfig(hBs, pLatmDemux, &hTp->callbacks, hTp->asc, &fConfigFound);
239         if (err != TRANSPORTDEC_OK) {
240           return err;
241         }
242       }
243       break;
244     default:
245       fConfigFound = 1;
246       err = AudioSpecificConfig_Parse(&hTp->asc[layer], hBs, 1, &hTp->callbacks);
247       if (err == TRANSPORTDEC_OK) {
248         int errC;
249 
250         errC = hTp->callbacks.cbUpdateConfig(hTp->callbacks.cbUpdateConfigData, &hTp->asc[layer]);
251         if (errC != 0) {
252           err = TRANSPORTDEC_PARSE_ERROR;
253         }
254       }
255       break;
256   }
257 
258   if (err == TRANSPORTDEC_OK && fConfigFound) {
259     hTp->flags |= TPDEC_CONFIG_FOUND;
260   }
261 
262   return err;
263 }
264 
transportDec_RegisterAscCallback(HANDLE_TRANSPORTDEC hTpDec,const cbUpdateConfig_t cbUpdateConfig,void * user_data)265 int transportDec_RegisterAscCallback( HANDLE_TRANSPORTDEC hTpDec, const cbUpdateConfig_t cbUpdateConfig, void* user_data)
266 {
267   if (hTpDec == NULL) {
268     return -1;
269   }
270   hTpDec->callbacks.cbUpdateConfig = cbUpdateConfig;
271   hTpDec->callbacks.cbUpdateConfigData = user_data;
272   return 0;
273 }
274 
transportDec_RegisterSscCallback(HANDLE_TRANSPORTDEC hTpDec,const cbSsc_t cbSsc,void * user_data)275 int transportDec_RegisterSscCallback( HANDLE_TRANSPORTDEC hTpDec, const cbSsc_t cbSsc, void* user_data)
276 {
277   if (hTpDec == NULL) {
278     return -1;
279   }
280   hTpDec->callbacks.cbSsc = cbSsc;
281   hTpDec->callbacks.cbSscData = user_data;
282   return 0;
283 }
284 
transportDec_RegisterSbrCallback(HANDLE_TRANSPORTDEC hTpDec,const cbSbr_t cbSbr,void * user_data)285 int transportDec_RegisterSbrCallback( HANDLE_TRANSPORTDEC hTpDec, const cbSbr_t cbSbr, void* user_data)
286 {
287   if (hTpDec == NULL) {
288     return -1;
289   }
290   hTpDec->callbacks.cbSbr = cbSbr;
291   hTpDec->callbacks.cbSbrData = user_data;
292   return 0;
293 }
294 
transportDec_FillData(const HANDLE_TRANSPORTDEC hTp,UCHAR * pBuffer,const UINT bufferSize,UINT * pBytesValid,const INT layer)295 TRANSPORTDEC_ERROR transportDec_FillData(
296         const HANDLE_TRANSPORTDEC  hTp,
297         UCHAR                     *pBuffer,
298         const UINT                 bufferSize,
299         UINT                      *pBytesValid,
300         const INT                  layer )
301 {
302   HANDLE_FDK_BITSTREAM hBs;
303 
304   if ( (hTp == NULL)
305     || (layer >= 2) ) {
306     return TRANSPORTDEC_INVALID_PARAMETER;
307   }
308 
309   if (*pBytesValid == 0) {
310     /* nothing to do */
311     return TRANSPORTDEC_OK;
312   }
313 
314   /* set bitbuffer shortcut */
315   hBs = &hTp->bitStream[layer];
316 
317   if ( TT_IS_PACKET(hTp->transportFmt) ) {
318     if (hTp->numberOfRawDataBlocks == 0) {
319     /* For packet based transport, pass input buffer to bitbuffer without copying the data.
320        Unfortunately we do not know the actual buffer size. And the FDK bit buffer implementation
321        needs a number 2^x. So we assume the maximum of 48 channels with 6144 bits per channel
322        and round it up to the next power of 2 => 65536 bytes */
323     FDKinitBitStream(hBs, pBuffer, 0x10000, (*pBytesValid)<<3, BS_READER);
324     *pBytesValid = 0;
325     }
326   } else {
327     /* ... else feed bitbuffer with new stream data (append). */
328     if (hTp->numberOfRawDataBlocks <= 0) {
329       FDKfeedBuffer (hBs, pBuffer, bufferSize, pBytesValid) ;
330     }
331   }
332 
333   return TRANSPORTDEC_OK;
334 }
335 
transportDec_GetBitstream(const HANDLE_TRANSPORTDEC hTp,const UINT layer)336 HANDLE_FDK_BITSTREAM transportDec_GetBitstream( const HANDLE_TRANSPORTDEC hTp, const UINT layer )
337 {
338   return &hTp->bitStream[layer];
339 }
340 
transportDec_GetFormat(const HANDLE_TRANSPORTDEC hTp)341 TRANSPORT_TYPE transportDec_GetFormat( const HANDLE_TRANSPORTDEC hTp )
342 {
343   return hTp->transportFmt;
344 }
345 
transportDec_GetBufferFullness(const HANDLE_TRANSPORTDEC hTp)346 INT transportDec_GetBufferFullness( const HANDLE_TRANSPORTDEC hTp )
347 {
348   INT bufferFullness = -1;
349 
350   switch (hTp->transportFmt) {
351     case TT_MP4_ADTS:
352       if (hTp->parser.adts.bs.adts_fullness != 0x7ff) {
353         bufferFullness = hTp->parser.adts.bs.frame_length*8 + hTp->parser.adts.bs.adts_fullness * 32 * getNumberOfEffectiveChannels(hTp->parser.adts.bs.channel_config);
354       }
355       break;
356     case TT_MP4_LOAS:
357     case TT_MP4_LATM_MCP0:
358     case TT_MP4_LATM_MCP1:
359       if (hTp->parser.latm.m_linfo[0][0].m_bufferFullness != 0xff) {
360         bufferFullness = hTp->parser.latm.m_linfo[0][0].m_bufferFullness;
361       }
362       break;
363     default:
364       break;
365   }
366 
367   return bufferFullness;
368 }
369 
370 /**
371  * \brief adjust bit stream position and the end of an access unit.
372  * \param hTp transport decoder handle.
373  * \return error code.
374  */
375 static
transportDec_AdjustEndOfAccessUnit(HANDLE_TRANSPORTDEC hTp)376 TRANSPORTDEC_ERROR transportDec_AdjustEndOfAccessUnit(HANDLE_TRANSPORTDEC hTp)
377 {
378   HANDLE_FDK_BITSTREAM hBs = &hTp->bitStream[0];
379   TRANSPORTDEC_ERROR err = TRANSPORTDEC_OK;
380 
381   switch (hTp->transportFmt) {
382     case TT_MP4_LOAS:
383     case TT_MP4_LATM_MCP0:
384     case TT_MP4_LATM_MCP1:
385       if ( hTp->numberOfRawDataBlocks == 0 )
386       {
387         /* Do byte align at the end of AudioMuxElement. */
388         FDKbyteAlign(hBs, hTp->globalFramePos);
389 
390         /* Check global frame length */
391         if (hTp->transportFmt == TT_MP4_LOAS && hTp->parser.latm.m_audioMuxLengthBytes > 0)
392         {
393           int loasOffset;
394 
395           loasOffset = (hTp->parser.latm.m_audioMuxLengthBytes*8 + FDKgetValidBits(hBs)) - hTp->globalFramePos;
396           if (loasOffset != 0) {
397             FDKpushBiDirectional(hBs, loasOffset);
398             /* For ELD and other payloads there is an unknown amount of padding, so ignore unread bits, but
399                throw an error only if too many bits where read. */
400             if (loasOffset < 0) {
401               err = TRANSPORTDEC_PARSE_ERROR;
402             }
403           }
404         }
405       }
406       break;
407 
408     case TT_MP4_ADTS:
409       if (hTp->parser.adts.bs.protection_absent == 0)
410       {
411         int offset;
412 
413         /* Calculate offset to end of AU */
414         offset  = hTp->parser.adts.rawDataBlockDist[hTp->parser.adts.bs.num_raw_blocks-hTp->numberOfRawDataBlocks]<<3;
415         /* CAUTION: The PCE (if available) is declared to be a part of the header! */
416         offset -= hTp->accessUnitAnchor[0] - FDKgetValidBits(hBs) + 16 + hTp->parser.adts.bs.num_pce_bits;
417         FDKpushBiDirectional(hBs, offset);
418       }
419       if (hTp->parser.adts.bs.num_raw_blocks > 0 && hTp->parser.adts.bs.protection_absent == 0) {
420         /* Note this CRC read currently happens twice because of transportDec_CrcCheck() */
421         hTp->parser.adts.crcReadValue = FDKreadBits(hBs, 16);
422       }
423       if ( hTp->numberOfRawDataBlocks == 0 )
424       {
425         /* Check global frame length */
426         if (hTp->parser.adts.bs.protection_absent == 0)
427         {
428           int offset;
429 
430           offset = (hTp->parser.adts.bs.frame_length*8 - ADTS_SYNCLENGTH + FDKgetValidBits(hBs)) - hTp->globalFramePos;
431           if (offset != 0) {
432             FDKpushBiDirectional(hBs, offset);
433           }
434         }
435       }
436       break;
437 
438     default:
439       break;
440   }
441 
442   return err;
443 }
444 
445 
446 /**
447  * \brief Determine additional buffer fullness contraint due to burst data reception.
448  *        The parameter TPDEC_PARAM_BURSTPERIOD must have been set as a precondition.
449  * \param hTp transport decoder handle.
450  * \param bufferFullness the buffer fullness value of the first frame to be decoded.
451  * \param bitsAvail the amount of available bits at the end of the first frame to be decoded.
452  * \return error code
453  */
454 static
additionalHoldOffNeeded(HANDLE_TRANSPORTDEC hTp,INT bufferFullness,INT bitsAvail)455 TRANSPORTDEC_ERROR additionalHoldOffNeeded(
456         HANDLE_TRANSPORTDEC hTp,
457         INT                 bufferFullness,
458         INT                 bitsAvail
459         )
460 {
461   INT checkLengthBits, avgBitsPerFrame;
462   INT maxAU; /* maximum number of frames per Master Frame */
463   INT samplesPerFrame = hTp->asc->m_samplesPerFrame;
464   INT samplingFrequency = (INT)hTp->asc->m_samplingFrequency;
465 
466   if ( (hTp->avgBitRate == 0) || (hTp->burstPeriod == 0) ) {
467     return TRANSPORTDEC_OK;
468   }
469   if ( (samplesPerFrame == 0 ) || (samplingFrequency == 0) ) {
470     return TRANSPORTDEC_NOT_ENOUGH_BITS;
471   }
472 
473   /* One Master Frame is sent every hTp->burstPeriod ms */
474   maxAU = hTp->burstPeriod * samplingFrequency + (samplesPerFrame*1000 - 1);
475   maxAU = maxAU / (samplesPerFrame*1000);
476   /* Subtract number of frames which were already held off. */
477   maxAU -= hTp->holdOffFrames;
478 
479   avgBitsPerFrame = hTp->avgBitRate * samplesPerFrame + (samplingFrequency-1);
480   avgBitsPerFrame = avgBitsPerFrame / samplingFrequency;
481 
482   /* Consider worst case of bufferFullness quantization. */
483   switch (hTp->transportFmt) {
484     case TT_MP4_ADIF:
485     case TT_MP4_ADTS:
486     case TT_MP4_LOAS:
487     case TT_MP4_LATM_MCP0:
488     case TT_MP4_LATM_MCP1:
489       bufferFullness += 31;
490       break;
491     default:
492       break;
493   }
494 
495   checkLengthBits = bufferFullness + (maxAU-1)*avgBitsPerFrame;
496 
497   /* Check if buffer is big enough to fullfill buffer fullness condition */
498   if ( (checkLengthBits /*+headerBits*/) > ((TRANSPORTDEC_INBUF_SIZE<<3)-7) ) {
499     return TRANSPORTDEC_SYNC_ERROR;
500   }
501 
502   if ( bitsAvail < checkLengthBits ) {
503     return TRANSPORTDEC_NOT_ENOUGH_BITS;
504   }
505   else {
506     return TRANSPORTDEC_OK;
507   }
508 }
509 
transportDec_readHeader(HANDLE_TRANSPORTDEC hTp,HANDLE_FDK_BITSTREAM hBs,int syncLength,int ignoreBufferFullness,int * pRawDataBlockLength,int * pfTraverseMoreFrames,int * pSyncLayerFrameBits,int * pfConfigFound,int * pHeaderBits)510 static TRANSPORTDEC_ERROR transportDec_readHeader(
511         HANDLE_TRANSPORTDEC hTp,
512         HANDLE_FDK_BITSTREAM hBs,
513         int syncLength,
514         int ignoreBufferFullness,
515         int *pRawDataBlockLength,
516         int *pfTraverseMoreFrames,
517         int *pSyncLayerFrameBits,
518         int *pfConfigFound,
519         int *pHeaderBits
520         )
521 {
522   TRANSPORTDEC_ERROR err = TRANSPORTDEC_OK;
523   int rawDataBlockLength = *pRawDataBlockLength;
524   int fTraverseMoreFrames = (pfTraverseMoreFrames != NULL) ? *pfTraverseMoreFrames : 0;
525   int syncLayerFrameBits = (pSyncLayerFrameBits != NULL) ? *pSyncLayerFrameBits : 0;
526   int fConfigFound = (pfConfigFound != NULL) ? *pfConfigFound : 0;
527   int startPos;
528 
529   startPos = FDKgetValidBits(hBs);
530 
531   switch (hTp->transportFmt) {
532     case TT_MP4_ADTS:
533       if (hTp->numberOfRawDataBlocks <= 0)
534       {
535         int errC;
536 
537         hTp->globalFramePos = FDKgetValidBits(hBs);
538 
539         /* Parse ADTS header */
540         err = adtsRead_DecodeHeader( &hTp->parser.adts, &hTp->asc[0], hBs, ignoreBufferFullness );
541         if (err != TRANSPORTDEC_OK) {
542           if (err != TRANSPORTDEC_NOT_ENOUGH_BITS) {
543             err = TRANSPORTDEC_SYNC_ERROR;
544           }
545         } else {
546           errC = hTp->callbacks.cbUpdateConfig(hTp->callbacks.cbUpdateConfigData, &hTp->asc[0]);
547           if (errC != 0) {
548             if (errC == TRANSPORTDEC_NEED_TO_RESTART) {
549               err = TRANSPORTDEC_NEED_TO_RESTART;
550               goto bail;
551             } else {
552               err = TRANSPORTDEC_SYNC_ERROR;
553             }
554           } else {
555             fConfigFound = 1;
556             hTp->numberOfRawDataBlocks = hTp->parser.adts.bs.num_raw_blocks+1;
557           }
558         }
559       }
560       else {
561         /* Reset CRC because the next bits are the beginning of a raw_data_block() */
562         FDKcrcReset(&hTp->parser.adts.crcInfo);
563         hTp->parser.adts.bs.num_pce_bits = 0;
564       }
565       if (err == TRANSPORTDEC_OK) {
566         hTp->numberOfRawDataBlocks--;
567         rawDataBlockLength = adtsRead_GetRawDataBlockLength(&hTp->parser.adts, (hTp->parser.adts.bs.num_raw_blocks-hTp->numberOfRawDataBlocks));
568         if (rawDataBlockLength <= 0) {
569           /* No further frame traversal possible. */
570           fTraverseMoreFrames = 0;
571         }
572         syncLayerFrameBits = (hTp->parser.adts.bs.frame_length<<3) - (startPos - FDKgetValidBits(hBs)) - syncLength;
573         if (syncLayerFrameBits <= 0) {
574           err = TRANSPORTDEC_SYNC_ERROR;
575         }
576       } else {
577         hTp->numberOfRawDataBlocks = 0;
578       }
579       break;
580     case TT_MP4_LOAS:
581       if (hTp->numberOfRawDataBlocks <= 0)
582       {
583         syncLayerFrameBits = FDKreadBits(hBs, 13);
584         hTp->parser.latm.m_audioMuxLengthBytes = syncLayerFrameBits;
585         syncLayerFrameBits <<= 3;
586       }
587     case TT_MP4_LATM_MCP1:
588     case TT_MP4_LATM_MCP0:
589       if (hTp->numberOfRawDataBlocks <= 0)
590       {
591         hTp->globalFramePos = FDKgetValidBits(hBs);
592 
593         err = CLatmDemux_Read(
594                 hBs,
595                &hTp->parser.latm,
596                 hTp->transportFmt,
597                &hTp->callbacks,
598                 hTp->asc,
599                &fConfigFound,
600                 ignoreBufferFullness);
601 
602         if (err != TRANSPORTDEC_OK) {
603           if (err != TRANSPORTDEC_NOT_ENOUGH_BITS) {
604             err = TRANSPORTDEC_SYNC_ERROR;
605           }
606         } else {
607           hTp->numberOfRawDataBlocks = CLatmDemux_GetNrOfSubFrames(&hTp->parser.latm);
608           if (hTp->transportFmt == TT_MP4_LOAS) {
609             syncLayerFrameBits -= startPos - FDKgetValidBits(hBs) - (13);
610           }
611         }
612       } else {
613         err = CLatmDemux_ReadPayloadLengthInfo(hBs, &hTp->parser.latm);
614         if (err != TRANSPORTDEC_OK) {
615           err = TRANSPORTDEC_SYNC_ERROR;
616         }
617       }
618       if (err == TRANSPORTDEC_OK) {
619         rawDataBlockLength = CLatmDemux_GetFrameLengthInBits(&hTp->parser.latm);
620         hTp->numberOfRawDataBlocks--;
621       } else {
622         hTp->numberOfRawDataBlocks = 0;
623       }
624       break;
625     default:
626       {
627         syncLayerFrameBits = 0;
628       }
629       break;
630   }
631 
632 bail:
633 
634   *pRawDataBlockLength = rawDataBlockLength;
635 
636   if (pHeaderBits != NULL) {
637     *pHeaderBits += startPos - (INT)FDKgetValidBits(hBs);
638   }
639   if (pfConfigFound != NULL) {
640     *pfConfigFound = fConfigFound;
641   }
642 
643   if (pfTraverseMoreFrames != NULL) {
644     *pfTraverseMoreFrames = fTraverseMoreFrames;
645   }
646   if  (pSyncLayerFrameBits != NULL) {
647     *pSyncLayerFrameBits = syncLayerFrameBits;
648   }
649   if (pfConfigFound != NULL) {
650     *pfConfigFound = fConfigFound;
651   }
652 
653   return err;
654 }
655 
656 /* How many bits to advance for synchronization search. */
657 #define TPDEC_SYNCSKIP 8
658 
659 static
synchronization(HANDLE_TRANSPORTDEC hTp,INT * pHeaderBits)660 TRANSPORTDEC_ERROR synchronization(
661         HANDLE_TRANSPORTDEC hTp,
662         INT                *pHeaderBits
663         )
664 {
665   TRANSPORTDEC_ERROR err = TRANSPORTDEC_OK, errFirstFrame = TRANSPORTDEC_OK;
666   HANDLE_FDK_BITSTREAM hBs = &hTp->bitStream[0];
667 
668   INT syncLayerFrameBits = 0; /* Length of sync layer frame (i.e. LOAS) */
669   INT rawDataBlockLength = 0, rawDataBlockLengthPrevious;
670   INT totalBits;
671   INT headerBits = 0, headerBitsFirstFrame = 0, headerBitsPrevious;
672   INT numFramesTraversed = 0, fTraverseMoreFrames, fConfigFound = (hTp->flags & TPDEC_CONFIG_FOUND), startPosFirstFrame = -1;
673   INT numRawDataBlocksFirstFrame = 0, numRawDataBlocksPrevious, globalFramePosFirstFrame = 0, rawDataBlockLengthFirstFrame = 0;
674   INT ignoreBufferFullness = hTp->flags & (TPDEC_LOST_FRAMES_PENDING|TPDEC_IGNORE_BUFFERFULLNESS|TPDEC_SYNCOK);
675 
676   /* Synch parameters */
677   INT syncLength;      /* Length of sync word in bits */
678   UINT syncWord;       /* Sync word to be found */
679   UINT syncMask;       /* Mask for sync word (for adding one bit, so comprising one bit less) */
680   C_ALLOC_SCRATCH_START(contextFirstFrame, transportdec_parser_t, 1);
681 
682   totalBits = (INT)FDKgetValidBits(hBs);
683 
684   if (totalBits <= 0) {
685     err = TRANSPORTDEC_NOT_ENOUGH_BITS;
686     goto bail;
687   }
688 
689   fTraverseMoreFrames = (hTp->flags & (TPDEC_MINIMIZE_DELAY|TPDEC_EARLY_CONFIG)) && ! (hTp->flags & TPDEC_SYNCOK);
690 
691   /* Set transport specific sync parameters */
692   switch (hTp->transportFmt) {
693     case TT_MP4_ADTS:
694       syncWord = ADTS_SYNCWORD;
695       syncLength = ADTS_SYNCLENGTH;
696       break;
697     case TT_MP4_LOAS:
698       syncWord = 0x2B7;
699       syncLength = 11;
700       break;
701     default:
702       syncWord = 0;
703       syncLength = 0;
704       break;
705   }
706 
707   syncMask = (1<<syncLength)-1;
708 
709   do {
710     INT bitsAvail = 0;     /* Bits available in bitstream buffer    */
711     INT checkLengthBits;   /* Helper to check remaining bits and buffer boundaries */
712     UINT synch;            /* Current sync word read from bitstream */
713 
714     headerBitsPrevious = headerBits;
715 
716     bitsAvail = (INT)FDKgetValidBits(hBs);
717 
718     if (hTp->numberOfRawDataBlocks == 0) {
719       /* search synchword */
720 
721       FDK_ASSERT( (bitsAvail % TPDEC_SYNCSKIP) == 0);
722 
723       if ((bitsAvail-syncLength) < TPDEC_SYNCSKIP) {
724         err = TRANSPORTDEC_NOT_ENOUGH_BITS;
725         headerBits = 0;
726       } else {
727 
728         synch = FDKreadBits(hBs, syncLength);
729 
730         if ( !(hTp->flags & TPDEC_SYNCOK) ) {
731           for (; (bitsAvail-syncLength) >= TPDEC_SYNCSKIP; bitsAvail-=TPDEC_SYNCSKIP) {
732             if (synch == syncWord) {
733               break;
734             }
735             synch = ((synch << TPDEC_SYNCSKIP) & syncMask) | FDKreadBits(hBs, TPDEC_SYNCSKIP);
736           }
737         }
738         if (synch != syncWord) {
739           /* No correct syncword found. */
740           err = TRANSPORTDEC_SYNC_ERROR;
741         } else {
742           err = TRANSPORTDEC_OK;
743         }
744         headerBits = syncLength;
745       }
746     } else {
747       headerBits = 0;
748     }
749 
750     /* Save previous raw data block data */
751     rawDataBlockLengthPrevious = rawDataBlockLength;
752     numRawDataBlocksPrevious = hTp->numberOfRawDataBlocks;
753 
754     /* Parse transport header (raw data block granularity) */
755 
756     if (err == TRANSPORTDEC_OK )
757     {
758       err = transportDec_readHeader(
759               hTp,
760               hBs,
761               syncLength,
762               ignoreBufferFullness,
763              &rawDataBlockLength,
764              &fTraverseMoreFrames,
765              &syncLayerFrameBits,
766              &fConfigFound,
767              &headerBits
768               );
769     }
770 
771     bitsAvail -= headerBits;
772 
773     checkLengthBits  = syncLayerFrameBits;
774 
775     /* Check if the whole frame would fit the bitstream buffer */
776     if (err == TRANSPORTDEC_OK) {
777       if ( (checkLengthBits+headerBits) > ((TRANSPORTDEC_INBUF_SIZE<<3)-7) ) {
778         /* We assume that the size of the transport bit buffer has been
779            chosen to meet all system requirements, thus this condition
780            is considered a synchronisation error. */
781         err = TRANSPORTDEC_SYNC_ERROR;
782       } else {
783         if ( bitsAvail < checkLengthBits ) {
784           err = TRANSPORTDEC_NOT_ENOUGH_BITS;
785         }
786       }
787     }
788 
789     if (err == TRANSPORTDEC_NOT_ENOUGH_BITS) {
790       break;
791     }
792 
793 
794     if (err == TRANSPORTDEC_SYNC_ERROR) {
795       int bits;
796 
797       /* Enforce re-sync of transport headers. */
798       hTp->numberOfRawDataBlocks = 0;
799 
800       /* Ensure that the bit amount lands at a multiple of TPDEC_SYNCSKIP */
801       bits = (bitsAvail + headerBits) % TPDEC_SYNCSKIP;
802       /* Rewind - TPDEC_SYNCSKIP, in order to look for a synch one bit ahead next time. */
803       FDKpushBiDirectional(hBs, -(headerBits - TPDEC_SYNCSKIP) + bits);
804       bitsAvail += headerBits - TPDEC_SYNCSKIP - bits;
805       headerBits = 0;
806     }
807 
808     /* Frame traversal */
809     if ( fTraverseMoreFrames )
810     {
811       /* Save parser context for early config discovery "rewind all frames" */
812       if ( (hTp->flags & TPDEC_EARLY_CONFIG) && !(hTp->flags & TPDEC_MINIMIZE_DELAY))
813       {
814         /* ignore buffer fullness if just traversing additional frames for ECD */
815         ignoreBufferFullness = 1;
816 
817         /* Save context in order to return later */
818         if ( err == TRANSPORTDEC_OK && startPosFirstFrame == -1 ) {
819           startPosFirstFrame = FDKgetValidBits(hBs);
820           numRawDataBlocksFirstFrame = hTp->numberOfRawDataBlocks;
821           globalFramePosFirstFrame = hTp->globalFramePos;
822           rawDataBlockLengthFirstFrame = rawDataBlockLength;
823           headerBitsFirstFrame = headerBits;
824           errFirstFrame = err;
825           FDKmemcpy(contextFirstFrame, &hTp->parser, sizeof(transportdec_parser_t));
826         }
827 
828         /* Break when config was found or it is not possible anymore to find a config */
829         if (startPosFirstFrame != -1 && (fConfigFound || err != TRANSPORTDEC_OK))
830         {
831           /* In case of ECD and sync error, do not rewind anywhere. */
832           if (err == TRANSPORTDEC_SYNC_ERROR)
833           {
834             startPosFirstFrame = -1;
835             fConfigFound = 0;
836             numFramesTraversed = 0;
837           }
838           break;
839         }
840       }
841 
842       if (err == TRANSPORTDEC_OK) {
843         FDKpushFor(hBs, rawDataBlockLength);
844         bitsAvail -= rawDataBlockLength;
845         numFramesTraversed++;
846         /* Ignore error here itentionally. */
847         transportDec_AdjustEndOfAccessUnit(hTp);
848       }
849     }
850   } while ( fTraverseMoreFrames || (err == TRANSPORTDEC_SYNC_ERROR && !(hTp->flags & TPDEC_SYNCOK)));
851 
852   /* Restore context in case of ECD frame traversal */
853   if ( startPosFirstFrame != -1 && (fConfigFound || err != TRANSPORTDEC_OK) ) {
854     FDKpushBiDirectional(hBs, FDKgetValidBits(hBs) - startPosFirstFrame);
855     FDKmemcpy(&hTp->parser, contextFirstFrame, sizeof(transportdec_parser_t));
856     hTp->numberOfRawDataBlocks = numRawDataBlocksFirstFrame;
857     hTp->globalFramePos = globalFramePosFirstFrame;
858     rawDataBlockLength = rawDataBlockLengthFirstFrame;
859     headerBits = headerBitsFirstFrame;
860     err = errFirstFrame;
861     numFramesTraversed = 0;
862   }
863 
864   /* Additional burst data mode buffer fullness check. */
865   if ( !(hTp->flags & (TPDEC_LOST_FRAMES_PENDING|TPDEC_IGNORE_BUFFERFULLNESS|TPDEC_SYNCOK)) && err == TRANSPORTDEC_OK) {
866     err = additionalHoldOffNeeded(hTp, transportDec_GetBufferFullness(hTp), FDKgetValidBits(hBs) - syncLayerFrameBits);
867     if (err == TRANSPORTDEC_NOT_ENOUGH_BITS) {
868       hTp->holdOffFrames++;
869     }
870   }
871 
872   /* Rewind for retry because of not enough bits */
873   if (err == TRANSPORTDEC_NOT_ENOUGH_BITS) {
874     FDKpushBack(hBs, headerBits);
875     headerBits = 0;
876   }
877   else {
878     /* reset hold off frame counter */
879     hTp->holdOffFrames = 0;
880   }
881 
882   /* Return to last good frame in case of frame traversal but not ECD. */
883   if (numFramesTraversed > 0) {
884     FDKpushBack(hBs, rawDataBlockLengthPrevious);
885     if (err != TRANSPORTDEC_OK) {
886       hTp->numberOfRawDataBlocks = numRawDataBlocksPrevious;
887       headerBits = headerBitsPrevious;
888     }
889     err = TRANSPORTDEC_OK;
890   }
891 
892 bail:
893   hTp->auLength[0] = rawDataBlockLength;
894 
895   /* Detect pointless TRANSPORTDEC_NOT_ENOUGH_BITS error case, were the bit buffer is already full,
896      or no new burst packet fits. Recover by advancing the bit buffer. */
897   if ( (TRANSPORTDEC_NOT_ENOUGH_BITS == err) &&  (FDKgetValidBits(hBs) >= ((TRANSPORTDEC_INBUF_SIZE*8 - ((hTp->avgBitRate*hTp->burstPeriod)/1000)) - 7)) )
898   {
899     FDKpushFor(hBs, TPDEC_SYNCSKIP);
900     err = TRANSPORTDEC_SYNC_ERROR;
901   }
902 
903   if (err == TRANSPORTDEC_OK) {
904     hTp->flags |= TPDEC_SYNCOK;
905   }
906 
907   if (fConfigFound) {
908     hTp->flags |= TPDEC_CONFIG_FOUND;
909   }
910 
911   if (pHeaderBits != NULL) {
912     *pHeaderBits = headerBits;
913   }
914 
915   if (err == TRANSPORTDEC_SYNC_ERROR) {
916     hTp->flags &= ~TPDEC_SYNCOK;
917   }
918 
919   C_ALLOC_SCRATCH_END(contextFirstFrame, transportdec_parser_t, 1);
920 
921   return err;
922 }
923 
924 /**
925  * \brief Synchronize to stream and estimate the amount of missing access units due
926  *        to a current synchronization error in case of constant average bit rate.
927  */
928 static
transportDec_readStream(HANDLE_TRANSPORTDEC hTp,const UINT layer)929 TRANSPORTDEC_ERROR transportDec_readStream ( HANDLE_TRANSPORTDEC hTp, const UINT layer )
930 {
931 
932   TRANSPORTDEC_ERROR error = TRANSPORTDEC_OK;
933   HANDLE_FDK_BITSTREAM hBs = &hTp->bitStream[layer];
934   INT nAU = -1;
935   INT headerBits;
936   INT bitDistance, bfDelta;
937 
938   /* Obtain distance to next synch word */
939   bitDistance = FDKgetValidBits(hBs);
940   error = synchronization(hTp, &headerBits);
941   bitDistance -= FDKgetValidBits(hBs);
942 
943 
944   FDK_ASSERT(bitDistance >= 0);
945 
946   if (error == TRANSPORTDEC_SYNC_ERROR || (hTp->flags & TPDEC_LOST_FRAMES_PENDING))
947   {
948     /* Check if estimating lost access units is feasible. */
949     if (hTp->avgBitRate > 0 && hTp->asc[0].m_samplesPerFrame > 0 && hTp->asc[0].m_samplingFrequency > 0)
950     {
951       if (error == TRANSPORTDEC_OK)
952       {
953         int aj;
954 
955         aj = transportDec_GetBufferFullness(hTp);
956         if (aj > 0) {
957           bfDelta = aj;
958         } else {
959           bfDelta = 0;
960         }
961         /* sync was ok: last of a series of bad access units. */
962         hTp->flags &= ~TPDEC_LOST_FRAMES_PENDING;
963         /* Add up bitDistance until end of the current frame. Later we substract
964            this frame from the grand total, since this current successfully synchronized
965            frame should not be skipped of course; but it must be accounted into the
966            bufferfulness math. */
967         bitDistance += hTp->auLength[0];
968       } else {
969         if ( !(hTp->flags & TPDEC_LOST_FRAMES_PENDING) ) {
970           /* sync not ok: one of many bad access units. */
971           hTp->flags |= TPDEC_LOST_FRAMES_PENDING;
972           bfDelta = - (INT)hTp->lastValidBufferFullness;
973         } else {
974           bfDelta = 0;
975         }
976       }
977 
978       {
979         int num, denom;
980 
981         /* Obtain estimate of number of lost frames */
982         num = hTp->asc[0].m_samplingFrequency * (bfDelta + bitDistance) + hTp->remainder;
983         denom = hTp->avgBitRate * hTp->asc[0].m_samplesPerFrame;
984         if (num > 0) {
985           nAU = num / denom;
986           hTp->remainder = num % denom;
987         } else {
988           hTp->remainder = num;
989         }
990 
991         if (error == TRANSPORTDEC_OK)
992         {
993           /* Final adjustment of remainder, taken -1 into account because current
994              frame should not be skipped, thus substract -1 or do nothing instead
995              of +1-1 accordingly. */
996           if ( (denom - hTp->remainder) >= hTp->remainder ) {
997             nAU--;
998           }
999 
1000           if (nAU < 0) {
1001             /* There was one frame too much concealed, so unfortunately we will have to skip one good frame. */
1002             transportDec_EndAccessUnit(hTp);
1003             error = synchronization(hTp, &headerBits);
1004             nAU = -1;
1005 #ifdef DEBUG
1006             FDKprintf("ERROR: Bufferfullness accounting failed. remainder=%d, nAU=%d\n", hTp->remainder, nAU);
1007 #endif
1008           }
1009           hTp->remainder = 0;
1010           /* Enforce last missed frames to be concealed. */
1011           if (nAU > 0) {
1012             FDKpushBack(hBs, headerBits);
1013           }
1014         }
1015       }
1016     }
1017   }
1018 
1019   /* Be sure that lost frames are handled correctly. This is necessary due to some
1020      sync error sequences where later it turns out that there is not enough data, but
1021      the bits upto the sync word are discarded, thus causing a value of nAU > 0 */
1022   if (nAU > 0) {
1023     error = TRANSPORTDEC_SYNC_ERROR;
1024   }
1025 
1026   hTp->missingAccessUnits = nAU;
1027 
1028   return error;
1029 }
1030 
1031 /* returns error code */
transportDec_ReadAccessUnit(const HANDLE_TRANSPORTDEC hTp,const UINT layer)1032 TRANSPORTDEC_ERROR transportDec_ReadAccessUnit( const HANDLE_TRANSPORTDEC hTp, const UINT layer )
1033 {
1034   TRANSPORTDEC_ERROR err = TRANSPORTDEC_OK;
1035   HANDLE_FDK_BITSTREAM hBs;
1036 
1037   if (!hTp) {
1038     return TRANSPORTDEC_INVALID_PARAMETER;
1039   }
1040 
1041   hBs = &hTp->bitStream[layer];
1042 
1043   if ((INT)FDKgetValidBits(hBs) <= 0) {
1044     err = TRANSPORTDEC_NOT_ENOUGH_BITS;
1045   }
1046 
1047   switch (hTp->transportFmt) {
1048 
1049     case TT_MP4_ADIF:
1050       /* Read header if not already done */
1051       if (!(hTp->flags & TPDEC_CONFIG_FOUND))
1052       {
1053         CProgramConfig *pce;
1054 
1055         AudioSpecificConfig_Init(&hTp->asc[0]);
1056         pce = &hTp->asc[0].m_progrConfigElement;
1057         err = adifRead_DecodeHeader(&hTp->parser.adif, pce, hBs);
1058         if (err)
1059           goto bail;
1060 
1061         /* Map adif header to ASC */
1062         hTp->asc[0].m_aot                    = (AUDIO_OBJECT_TYPE)(pce->Profile + 1);
1063         hTp->asc[0].m_samplingFrequencyIndex = pce->SamplingFrequencyIndex;
1064         hTp->asc[0].m_samplingFrequency      = SamplingRateTable[pce->SamplingFrequencyIndex];
1065         hTp->asc[0].m_channelConfiguration   = 0;
1066         hTp->asc[0].m_samplesPerFrame        = 1024;
1067         hTp->avgBitRate                      = hTp->parser.adif.BitRate;
1068 
1069         /* Call callback to decoder. */
1070         {
1071           int errC;
1072 
1073           errC = hTp->callbacks.cbUpdateConfig(hTp->callbacks.cbUpdateConfigData, &hTp->asc[0]);
1074           if (errC == 0) {
1075             hTp->flags |= TPDEC_CONFIG_FOUND;
1076           } else {
1077             err = TRANSPORTDEC_PARSE_ERROR;
1078             goto bail;
1079           }
1080         }
1081       }
1082       hTp->auLength[layer] = -1; /* Access Unit data length is unknown. */
1083       break;
1084 
1085     case TT_MP4_RAW:
1086       /* One Access Unit was filled into buffer.
1087          So get the length out of the buffer. */
1088       hTp->auLength[layer] = FDKgetValidBits(hBs);
1089       hTp->flags |= TPDEC_SYNCOK;
1090       break;
1091 
1092     case TT_MP4_LATM_MCP0:
1093     case TT_MP4_LATM_MCP1:
1094       {
1095         int fConfigFound = hTp->flags & TPDEC_CONFIG_FOUND;
1096         err = transportDec_readHeader(hTp, hBs, 0, 1, &hTp->auLength[layer], NULL, NULL, &fConfigFound, NULL);
1097         if (fConfigFound) {
1098           hTp->flags |= TPDEC_CONFIG_FOUND;
1099         }
1100       }
1101       break;
1102 
1103     case TT_RSVD50:
1104     case TT_MP4_ADTS:
1105     case TT_MP4_LOAS:
1106       err = transportDec_readStream(hTp, layer);
1107       break;
1108 
1109     default:
1110       err = TRANSPORTDEC_UNSUPPORTED_FORMAT;
1111       break;
1112   }
1113 
1114   if (err == TRANSPORTDEC_OK) {
1115     hTp->accessUnitAnchor[layer] = FDKgetValidBits(hBs);
1116   } else {
1117     hTp->accessUnitAnchor[layer] = 0;
1118   }
1119 
1120 bail:
1121   return err;
1122 }
1123 
transportDec_GetAuBitsRemaining(const HANDLE_TRANSPORTDEC hTp,const UINT layer)1124 INT transportDec_GetAuBitsRemaining( const HANDLE_TRANSPORTDEC hTp, const UINT layer )
1125 {
1126   INT bits;
1127 
1128   if (hTp->accessUnitAnchor[layer] > 0 && hTp->auLength[layer] > 0) {
1129     bits = hTp->auLength[layer] - (hTp->accessUnitAnchor[layer] - FDKgetValidBits(&hTp->bitStream[layer]));
1130   } else {
1131     bits = FDKgetValidBits(&hTp->bitStream[layer]);
1132   }
1133 
1134   return bits;
1135 }
1136 
transportDec_GetAuBitsTotal(const HANDLE_TRANSPORTDEC hTp,const UINT layer)1137 INT transportDec_GetAuBitsTotal( const HANDLE_TRANSPORTDEC hTp, const UINT layer )
1138 {
1139   return hTp->auLength[layer];
1140 }
1141 
transportDec_GetMissingAccessUnitCount(INT * pNAccessUnits,HANDLE_TRANSPORTDEC hTp)1142 TRANSPORTDEC_ERROR transportDec_GetMissingAccessUnitCount ( INT *pNAccessUnits, HANDLE_TRANSPORTDEC hTp )
1143 {
1144   *pNAccessUnits = hTp->missingAccessUnits;
1145 
1146   return TRANSPORTDEC_OK;
1147 }
1148 
1149 /* Inform the transportDec layer that reading of access unit has finished. */
transportDec_EndAccessUnit(HANDLE_TRANSPORTDEC hTp)1150 TRANSPORTDEC_ERROR transportDec_EndAccessUnit(HANDLE_TRANSPORTDEC hTp)
1151 {
1152   TRANSPORTDEC_ERROR err = TRANSPORTDEC_OK;
1153 
1154 
1155   err = transportDec_AdjustEndOfAccessUnit(hTp);
1156 
1157   switch (hTp->transportFmt) {
1158     default:
1159       break;
1160   }
1161 
1162   return err;
1163 }
1164 
transportDec_SetParam(const HANDLE_TRANSPORTDEC hTp,const TPDEC_PARAM param,const INT value)1165 TRANSPORTDEC_ERROR transportDec_SetParam ( const HANDLE_TRANSPORTDEC hTp,
1166                                            const TPDEC_PARAM        param,
1167                                            const INT                value)
1168 {
1169   TRANSPORTDEC_ERROR error = TRANSPORTDEC_OK;
1170 
1171   switch (param) {
1172     case TPDEC_PARAM_MINIMIZE_DELAY:
1173       if (value) {
1174         hTp->flags |= TPDEC_MINIMIZE_DELAY;
1175       } else {
1176         hTp->flags &= ~TPDEC_MINIMIZE_DELAY;
1177       }
1178       break;
1179     case TPDEC_PARAM_EARLY_CONFIG:
1180       if (value) {
1181         hTp->flags |= TPDEC_EARLY_CONFIG;
1182       } else {
1183         hTp->flags &= ~TPDEC_EARLY_CONFIG;
1184       }
1185       break;
1186     case TPDEC_PARAM_IGNORE_BUFFERFULLNESS:
1187       if (value) {
1188         hTp->flags |= TPDEC_IGNORE_BUFFERFULLNESS;
1189       } else {
1190         hTp->flags &= ~TPDEC_IGNORE_BUFFERFULLNESS;
1191       }
1192       break;
1193     case TPDEC_PARAM_SET_BITRATE:
1194       hTp->avgBitRate = value;
1195       break;
1196     case TPDEC_PARAM_BURST_PERIOD:
1197       hTp->burstPeriod = value;
1198       break;
1199     case TPDEC_PARAM_RESET:
1200       {
1201         int i;
1202 
1203         for (i=0; i<(1*2); i++) {
1204           FDKresetBitbuffer(&hTp->bitStream[i]);
1205           hTp->auLength[i] = 0;
1206           hTp->accessUnitAnchor[i] = 0;
1207         }
1208         hTp->flags &= ~(TPDEC_SYNCOK|TPDEC_LOST_FRAMES_PENDING);
1209         if (hTp->transportFmt != TT_MP4_ADIF) {
1210           hTp->flags &= ~TPDEC_CONFIG_FOUND;
1211         }
1212         hTp->remainder = 0;
1213         hTp->avgBitRate = 0;
1214         hTp->missingAccessUnits = 0;
1215         hTp->numberOfRawDataBlocks = 0;
1216         hTp->globalFramePos = 0;
1217         hTp->holdOffFrames = 0;
1218       }
1219       break;
1220   }
1221 
1222   return error;
1223 }
1224 
transportDec_GetNrOfSubFrames(HANDLE_TRANSPORTDEC hTp)1225 UINT transportDec_GetNrOfSubFrames(HANDLE_TRANSPORTDEC hTp)
1226 {
1227   UINT nSubFrames = 0;
1228 
1229   if (hTp == NULL)
1230     return 0;
1231 
1232   if (hTp->transportFmt==TT_MP4_LATM_MCP1 || hTp->transportFmt==TT_MP4_LATM_MCP0 || hTp->transportFmt==TT_MP4_LOAS)
1233     nSubFrames = CLatmDemux_GetNrOfSubFrames(&hTp->parser.latm);
1234   else if (hTp->transportFmt==TT_MP4_ADTS)
1235     nSubFrames = hTp->parser.adts.bs.num_raw_blocks;
1236 
1237   return nSubFrames;
1238 }
1239 
transportDec_Close(HANDLE_TRANSPORTDEC * phTp)1240 void transportDec_Close(HANDLE_TRANSPORTDEC *phTp)
1241 {
1242   if (phTp != NULL)
1243   {
1244     if (*phTp != NULL) {
1245       if ( ! TT_IS_PACKET((*phTp)->transportFmt) ) {
1246         FreeRam_TransportDecoderBuffer(&(*phTp)->bsBuffer);
1247       }
1248       if (*phTp != NULL) {
1249         FreeRam_TransportDecoder(phTp);
1250       }
1251     }
1252   }
1253 }
1254 
transportDec_GetLibInfo(LIB_INFO * info)1255 TRANSPORTDEC_ERROR transportDec_GetLibInfo( LIB_INFO *info )
1256 {
1257   int i;
1258 
1259   if (info == NULL) {
1260     return TRANSPORTDEC_UNKOWN_ERROR;
1261   }
1262 
1263   /* search for next free tab */
1264   for (i = 0; i < FDK_MODULE_LAST; i++) {
1265     if (info[i].module_id == FDK_NONE) break;
1266   }
1267   if (i == FDK_MODULE_LAST) return TRANSPORTDEC_UNKOWN_ERROR;
1268   info += i;
1269 
1270   info->module_id  = FDK_TPDEC;
1271 #ifdef __ANDROID__
1272   info->build_date = "";
1273   info->build_time = "";
1274 #else
1275   info->build_date = __DATE__;
1276   info->build_time = __TIME__;
1277 #endif
1278   info->title      = TP_LIB_TITLE;
1279   info->version    = LIB_VERSION(TP_LIB_VL0, TP_LIB_VL1, TP_LIB_VL2);
1280   LIB_VERSION_STRING(info);
1281   info->flags = 0
1282     | CAPF_ADIF
1283     | CAPF_ADTS
1284     | CAPF_LATM
1285     | CAPF_LOAS
1286     | CAPF_RAWPACKETS
1287     ;
1288 
1289   return TRANSPORTDEC_OK; /* FDKERR_NOERROR; */
1290 }
1291 
1292 
transportDec_CrcStartReg(HANDLE_TRANSPORTDEC pTp,INT mBits)1293 int  transportDec_CrcStartReg(HANDLE_TRANSPORTDEC pTp, INT mBits)
1294 {
1295   switch (pTp->transportFmt) {
1296   case TT_MP4_ADTS:
1297     return adtsRead_CrcStartReg(&pTp->parser.adts, &pTp->bitStream[0], mBits);
1298   default:
1299     return 0;
1300   }
1301 }
1302 
transportDec_CrcEndReg(HANDLE_TRANSPORTDEC pTp,INT reg)1303 void transportDec_CrcEndReg(HANDLE_TRANSPORTDEC pTp, INT reg)
1304 {
1305   switch (pTp->transportFmt) {
1306   case TT_MP4_ADTS:
1307     adtsRead_CrcEndReg(&pTp->parser.adts, &pTp->bitStream[0], reg);
1308     break;
1309   default:
1310     break;
1311   }
1312 }
1313 
transportDec_CrcCheck(HANDLE_TRANSPORTDEC pTp)1314 TRANSPORTDEC_ERROR transportDec_CrcCheck(HANDLE_TRANSPORTDEC pTp)
1315 {
1316   switch (pTp->transportFmt) {
1317   case TT_MP4_ADTS:
1318     if ( (pTp->parser.adts.bs.num_raw_blocks > 0) && (pTp->parser.adts.bs.protection_absent == 0) )
1319     {
1320       HANDLE_FDK_BITSTREAM hBs = &pTp->bitStream[0];
1321 
1322       transportDec_AdjustEndOfAccessUnit(pTp);
1323     }
1324     return adtsRead_CrcCheck(&pTp->parser.adts);
1325   default:
1326     return TRANSPORTDEC_OK;
1327   }
1328 }
1329