--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/inc/EAacPlusUtil.h Wed Sep 01 12:23:00 2010 +0100
@@ -0,0 +1,167 @@
+/*
+* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description: Header file for EAacPlusUtil.cpp
+*
+*/
+
+
+#ifndef EAACPLUSUTIL_H
+#define EAACPLUSUTIL_H
+
+// INCLUDES
+#include <e32base.h>
+
+// CLASS DECLARATION
+class EAacpAudioFrameInfo;
+
+/**
+* This class implements utility functions to extract AAC frame
+* information.
+*
+* @lib MmfEAacPlusUtil.lib
+* @since 3.2
+*/
+class CEAacPlusUtil : public CBase
+ {
+ public:
+ // CONSTANTS
+ enum TEAacPlusFormatType
+ {
+ EAacPlusFormatRaw=0,
+ EAacPlusFormatAdif=1,
+ EAacPlusFormatAdts=2
+ };
+ /**
+ * EAAC+ frame info struct.
+ *
+ * @lib MmfEAacPlusUtil.lib
+ * @since 3.2
+ */
+ class TEAacPlusFrameInfo
+ {
+ public:
+ TInt iOutFrameSize; // Size of PCM Samples generated by decoder
+ TInt iNoOfSamples; // Number of PCM Samples generated by decoder per frame
+ TInt iSamplingFrequency; // Sampling freq of AAC Code decoder
+ TInt iNoOfChannels; // No of output channel 1=Mono; 2=Stereo
+ TInt iObjectType; // MPEG Audio Object Type 2=AAC-LC; 4=AAC-LTP
+ TInt iOutSamplingFrequency; // Sampling Frequence for the output samples
+ TInt iDownSampledMode; // 0=Normal Mode; 1=Down Sampled mode
+ TInt iSbr; // 0=SBR not present; 1=SBR present
+ TInt iPs; // 0=PS not present; 1=PS present
+ };
+
+ class TEAacPlusFrameLenConfig
+ {
+ public:
+ TEAacPlusFormatType iFormatType; // Container type.
+ TInt iSamplingFrequency; // Sampling freq of AAC core decoder
+ TInt iObjectType; // MPEG Audio Object Type 2=AAC-LC; 4=AAC-LTP
+ };
+
+
+ public: // Constructors and destructor
+
+ /**
+ * Two-phased constructor.
+ */
+ IMPORT_C static CEAacPlusUtil* NewL();
+
+ /**
+ * Destructor.
+ */
+ IMPORT_C virtual ~CEAacPlusUtil();
+
+ public: // New functions
+
+ /**
+ * Used to get the format type.
+ * @since 3.2
+ * @param aBuf buffer of AAC data from start of aac content
+ * @param aBufLen length of aBuf
+ * @param TEAacPlusFormatType returned format type 0=raw; 1=ADIF; 2=ADTS
+ * @return status
+ */
+ IMPORT_C TInt GetAacFormatType(const TUint8* aBuf, TInt aBufLen, TEAacPlusFormatType& aFormatType);
+
+ /**
+ * Used to get the audio format information for ADIF and ADTS content.
+ * Data should be provided beginning with start of aac content including header.
+ * Enough data should follow the header to determine SBR and PS if needed.
+ * Can be used with mpeg data where aHdrBuf will contain the AudioSpecificConfig. Implicit SBR and PS
+ * will not be determined.
+ * @since 3.2
+ * @param aHdrBuf buffer with AAC data beginning at start of aac content including ADIF or ADTS header
+ * @param aHdrLen length of aHdrBuf; header length is returned in this parameter
+ * @param aFrameInfo returns the format information
+ * @return status
+ */
+ IMPORT_C TInt GetAacFrameInfo (const TUint8* aHdrBuf, TInt& aHdrLen, TEAacPlusFrameInfo& aFrameInfo);
+
+ /**
+ * Used to get the audio format information for mpeg aac.
+ * aHdrBuf will contain the AudioSpecificConfig. aDataBuf will contain data at beginning of raw audio frames.
+ * Implicit SBR and PS can be determined.
+ * @since 3.2
+ * @param aHdrBuf buffer with AudioSpecificConfig data.
+ * @param aHdrLen length of aHdrBuf
+ * @param aFrameInfo returns the format information
+ * @param aDataBuf buffer with raw audio frames
+ * @param aDataBufLen length of aDataBuf
+ * @return status
+ */
+ IMPORT_C TInt GetAacFrameInfo (const TUint8* aHdrBuf, TInt& aHdrLen, TEAacPlusFrameInfo& aFrameInfo,
+ TUint8* aDataBuf, TInt aDataBufLen);
+
+ /**
+ * Used to get the size in bytes of the frame found at the start of aBuf.
+ * @since 3.2
+ * @param aBuf buffer with AAC data frame
+ * @param aBufLen length of aBuf
+ * @param aFrameLen returns the frame size in bytes
+ * @return status
+ */
+ IMPORT_C TInt GetAacFrameLength(const TUint8* aBuf, TInt aBufLen, TInt& aFrameLen);
+
+ /**
+ * Used to configure the utility with information needed to enable the apis.
+ * This api can be used if GetAacFrameInfo is not used to initialize the utility.
+ * @since 3.2
+ * @param aFormatType format type
+ * @param aSamplingFrequency sampling frequency
+ * @return status
+ */
+ IMPORT_C TInt Config(TEAacPlusFrameLenConfig& aFrameLenConfig);
+
+ private:
+
+ /**
+ * C++ default constructor.
+ */
+ CEAacPlusUtil();
+
+ /**
+ * By default Symbian 2nd phase constructor is private.
+ */
+ void ConstructL();
+
+ private: // Data
+ TEAacPlusFormatType iFormat;
+ EAacpAudioFrameInfo* iGetFrameLenParam;
+ TBool iInitialized;
+ };
+
+#endif // EAACPLUSUTIL_H
+
+// End of File