/*
* 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:  Plugin interface to be implemented in order to get transcoding
*                functionality
*
*/


#ifndef MCCTRANSCODER_H
#define MCCTRANSCODER_H

//  INCLUDES
#include <e32base.h>
#include <e32std.h>
#include <mmccevents.h>

// CLASS DECLARATION
class CMccTranscoderImpl;

// CONSTS

// Plugin Interface UID
#define KMmfUidPluginInterfaceMccTranscoder  0x10282898

/**
* Class for setting up codec values for transcoding.
*/  
class TMccTranscoderCodecInfo
	{
    public:
		TUint32 iBitrate;
		TReal iFramerate;
		TUint32 iVideoWidth; 
		TUint32 iVideoHeight;
		TUint32 iSamplingFreq; 
		TBuf8<256> iMimeType;
		TUid iFourCC; 
		TUint32 iReserved1; 
		TUint32 iReserved2; 
	};

/**
* Class for setting up transcoding.
*/  
class TMccTranscodeFileMsg
    {
    public:
    
        TFileName  iSourceFile;
        
        TFileName  iDesFile;
        
        TUint32    iQuality;
        
        TMccTranscoderCodecInfo iVideoCodec;
        
        TMccTranscoderCodecInfo iAudioCodec;
    };
    
typedef TPckgBuf<TMccTranscodeFileMsg> TMccTranscodeFileMsgBuffer; 


/**
*  Observer interface for clients to receive events from transcoder.
*/
class MMccTranscoderObserver
    {
	public:
    
    /**
    * Callback function to receive transcoder events
    * @param aEvent Received transcoder events
    */
    virtual void MccTranscoderEventReceived( TMccEvent& aEvent ) = 0;
    };
    
/**
*  MCC subsystem transcoder interface. Class is used for transcoding audio and video
*  files from one codec to another. Transcoding can be also done with old codec in order
*  to change bitrate.
*/
class CMccTranscoder : public CBase
    {
    public:  // Constructors and destructor
        /**
        * Two-phased constructor.
        */
        static CMccTranscoder* NewL();

        /**
        * Destructor.
        */
        virtual ~CMccTranscoder();

    public:  // New functions

       /**
        * Registers observer for transcoding events.
        * @param aObserver observer for transcoding events.
        */
        virtual void RegisterEventObserver( MMccTranscoderObserver& aObserver );
        
       /**
        * Unregisters observer for transcoding events.
        */
        virtual void UnregisterEventObserver();
       
       /**
        * Starts transcoding of media file.
        * @param aSessionId session identifier for transcoding, updated on return
        * @param aVal TMccTranscodeFileMsgBuffer containing transcode parameters
        */
        virtual void TranscodeFileL( TUint32& aSessionId, const TDesC8& aVal );
        
       /**
        * Cancels transcoding of media file.
        * @param aSessionId session identifier for transcoding
        */
        virtual void CancelTranscodeFileL( TUint32 aSessionId );
    
    private:
        /**
        * C++ default constructor.
        */
        CMccTranscoder();

        /**
        * By default Symbian 2nd phase constructor is private.
        *
        * @param aSource    Source of the data for the payload format plugin
        */
        void ConstructL();

    private:    // data
        CMccTranscoderImpl* iTranscoderImpl;
        
    private:    // Friend classes
    
    #ifdef EUNIT_TEST
       friend class UT_CMccTranscoder;
    #endif
        
    };

#endif