/*
* 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 the License "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