/*
* Copyright (c) 2010 Ixonos Plc.
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the "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:
* Ixonos Plc
*
* Description:  
* DevVideoClient observer.
*
*/


#ifndef CTRDEVVICEOCLIENTOBSERVER_H
#define CTRDEVVICEOCLIENTOBSERVER_H


// INCLUDES
#include <devvideobase.h>
#include <devvideorecord.h>
#include <CCMRMediaSink.h>


/**
*  Devvideo client observer
*  @lib TRANSCODER.LIB
*  @since 3.1
*/
class MTRDevVideoClientObserver
    {
    public:
        /**
        * Reports an error from the devVideo client
        * @param aError Error reason
        * @return void
        */
        virtual void MtrdvcoFatalError(TInt aError) = 0;

        /**
        * Reports that data encoding process has been finished
        * @param none
        * @return void
        */
        virtual void MtrdvcoEncStreamEnd() = 0;

        /**
        * Reports that data decoding process has been finished
        * @param none
        * @return void
        */
        virtual void MtrdvcoDecStreamEnd() = 0;

        /**
        * Returns video picture from the video encoder client
        * @param aPicture video picture
        * @return void
        */
        virtual void MtrdvcoEncoderReturnPicture(TVideoPicture* aPicture) = 0;

        /**
        * Returns videopicture from the renderer
        * @param aPicture Video picture
        * @return none
        */
        virtual void MtrdvcoRendererReturnPicture(TVideoPicture* aPicture) = 0;

        /**
        * Supplies new decoded picture
        * @param aPicture Video picture
        * @return none
        */
        virtual void MtrdvcoNewPicture(TVideoPicture* aPicture) = 0;

        /**
        * Supplies new encoded bitstream buffer
        * @param aBuffer Media buffer
        * @return none
        */
        virtual void MtrdvcoNewBuffer(CCMRMediaBuffer* aBuffer) = 0;

        /**
        * Informs about initializing video encoder client
        * @param aError Initializing error status 
        * @return void
        */
        virtual void MtrdvcoEncInitializeComplete(TInt aError) = 0;

        /**
        * Informs about initializing video decoder client
        * @param aError Initializing error status 
        * @return void
        */
        virtual void MtrdvcoDecInitializeComplete(TInt aError) = 0;

        /**
        * Returns media bitstream buffer to the client
        * @param aBuffer Bitstream media buffer
        * @return void
        */
        virtual void MtrdvcoReturnCodedBuffer(CCMRMediaBuffer* aBuffer) = 0;
        
        /**
        * Notifies the transcoder about available picture buffers through BMCI or MDF
        * @param none
        * @return void
        */
        virtual void MtrdvcoNewBuffers() = 0;
        
        /**
        * Indicates that a media device has lost its resources
        * @param aFromDecoder Flag to indicate source
        * @return none
        */
        virtual void MtrdvcoResourcesLost(TBool aFromDecoder) = 0;
        
        /**
        * Indicates that a media device has regained its resources
        * @return none
        */
        virtual void MtrdvcoResourcesRestored() = 0;
    };




#endif // CTRDEVVICEOCLIENTOBSERVER_H