/*

 * 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