/*

* Copyright (c) 2009 Aricent 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:

* Aricent - initial contribution.

*

* Contributors:

*

* Description:

* Header file to the Mpeg4Asp Decoder wrapper Implementation.

*

*/

#ifndef ARIMPEG4ASPDECWRAPPER_H

#define ARIMPEG4ASPDECWRAPPER_H

//System includes

#include <e32def.h>

#include <e32base.h>

#include <devvideoconstants.h>

//User includes

#include "aribasecodec.h"

#include "ariprint.h"

const TInt KMaxFrameWidth			= 640;//should be 1280 for enabling 720P decoding;

const TInt KMaxFrameHeight			= 480;//should be 720 for enabling 720P decoding;

// FORWARD DECLARATIONS

class TUncompressedVideoFormat;

class TVideoInputBuffer;

class TVideoPictureHeader;

/**

 *	Class MCodecObserver

 *  whenever a new configuration information finds in the file, ti should

 *  be informated to the hwdevice. so that it will delete the existing

 *  codec object and wil create a new object and configures the codec with

 *  the new configuration information.

 */

class MCodecObserver

	{

	public:

		/**

		 * Callback to inform the HW device when there is new config.

		 * @return "None"

		 */

		virtual void NewConfigFound()=0;

		/**

		 * Callback to inform the HW device when there is new config.

		 * @return "None"

		 */

		virtual void EInputConsumed()=0;

	};

/**

 *	Class CCodecInterface

 *	This class is base class whish is part of Aricent's Mpeg4 ASP/H263 decoder wrapper

 *	used by the Mpeg4 ASP/H263. This HwDevice Plugin to decode Mpeg4 ASP/H263 content to

 *	yuv420.

 *

 */

class CAriMpeg4aspdecWrapper: public MBaseCodec, public CBase

	{

	public:// Constructor and Destructor

		/**

		 * Two-phased constructor.

		 * @return pointer to an instance of CAriMpeg4aspdecWrapper

		 */

		IMPORT_C static CAriMpeg4aspdecWrapper* NewL(

				                                  MCodecObserver* aObserver );

		/**

		 * Destructor

		 */

		virtual ~CAriMpeg4aspdecWrapper();

	public:// MBaseCodec functions

		/**

		* Retrieves a custom interface to the specified hardware device

		* @param	aInpBuf	Coded input data passed by Engine.

		* @param	aOutBuf	Decoded output data.

		* @leave	"The method will leave if an error occurs".

		* @return	one of the TCodecState

		*/

		virtual TInt DoProcessL( TAny *aInpBuf, TAny* aOutBuf = NULL ) = 0;

		/**

		 * Resets the Decoder

		 * @return None

		 */

		virtual void Reset() = 0;

    public: // New Functions

  	   /**

  		* Common API to set the values to the decoder.

  		* @param	aCommand	indicates the action to do.

  		* @param	aCmdData	Any input data required

  		* @leave	"The method will leave if an error occurs".

  		*/

		virtual TInt SetParam( TInt aCommand, TAny* aCmdData ) = 0;

	   /**

		* Common API to get the values to the decoder.

		* @param	aCommand	indicates the action to do.

		* @param	aCmdData	Any output data required

		* @leave	"The method will leave if an error occurs".

		*/

		virtual TInt GetParam( TInt aCommand, TAny* aCmdData ) = 0;

		/**

		* Returns the stream information and creates the decoder

		* @param	aInpBuf	Coded input data.

		* @param	aOutBuf	Decoded output data.

		* @leave	The method will leave if an error occurs.

		*/

		virtual void SetFormatsL( TVideoDataUnitType &aInputFormat,

                                TUncompressedVideoFormat &aOutputFormat ) = 0;

		/**

		* Configure the decoder using the stream passed

		* @param	aInpBuf	Coded input data.

		* @leave	The method will leave if an error occurs.

		*/

        virtual void ConfigDecoderL( const TDesC8* aInpBuf ) = 0;

        /**

		* Returns the length of the ouput frame

        * @return

		* @leave	The method will leave if an error occurs.

		*/

		virtual TInt GetOutputBufferLength() = 0;

		/**

		* Gets the slice loss information

		* @param aFirstMacroBlock

		* @param aNumMacroBlocks

		*/

		virtual void GetSliceLossInfo( TUint& aFirstMacroblock,

				                       TUint& aNumMacroblocks ) = 0;

		/**

		* Gets the picture Loss Information

		* @return percentage value

		*/

		virtual TUint GetPictureLossInfo() = 0;

		/**

		* Gets the Last frame

		* @return none

		*/

		virtual TInt GetLastFrame( TAny* aOutput ) = 0;

		/**

		* Gets the header info

		* @param	aDataUnit	Input stream data.

		* @param	aHeaderPtr  Output header information returned.

		* @leave	The method will leave if an error occurs

                    KErrArgument  - input data is null or zero length

                    KErrCorrupt   - input stream is corrupt

                    KErrUnderflow - input stream is insufficient.

		*/

		IMPORT_C

		static void  GetHeaderInfoL( TVideoInputBuffer& aDataUnit,

                                    TVideoPictureHeader& aHeaderPtr );

	};

#endif //ARIMPEG4ASPDECWRAPPER_H