/*

* Copyright (c) 2008 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:  presene avatar decoder handler 

 *                

 *

*/

#ifndef CSERVICEWIDGETIMAGEDECODER_H

#define CSERVICEWIDGETIMAGEDECODER_H

#include <e32base.h>

#include <f32file.h>

class CImageDecoder;

class CBitmapScaler;

class CFbsBitmap;

class CImageEncoder;

/**

 * decode notification class

 *

 *  @lib servicewidgetdatapublisher.dll

 *  @since S60 v5.0

 */

class MServiceWidgetImagerDecodeObserver

	{

	public :

			/**

			* HandlerDecodeComplete notification once decode complete

			* @param aBitmap decoded bitmap

			* @since S60 v5.0 

			* takes the ownership of aBitmap

			*/

			virtual void HandlerDecodeCompleteL() = 0 ;

			/**

			* virtaul Destructor

			* @since S60 v5.0 

			*/

			virtual ~MServiceWidgetImagerDecodeObserver()

				{

				}

	};

/**

 * Utility class for asynchronously decoding the header thumbnail image

 *

 *  @lib servicewidgetdatapublisher.dll

 *  @since S60 v5.0

 */

class CServiceWidgetImageDecoder : public CActive

    {

    enum TSWDEOperationId

	    {

	    EOpUnknown = -1,

	    EOpEncodeBitmap,

	    EOpComplete	

	    };

public:

    /**

     * Two-phased constructor

     * 

     * @param aHeader The header control to which the bitmap is to be inserted after loading

     * @param aBitmapData Descriptor containing the bitmap data stream

     * @return a instance of same class

     * @since S60 v5.0 

     */

    static CServiceWidgetImageDecoder* NewL(MServiceWidgetImagerDecodeObserver& aObserver );

    /**

     * Destructor

	 * @since S60 v5.0 

     */

    ~CServiceWidgetImageDecoder();

    /**

     * Starts the decoding process

     * @since S60 v5.0 

     * @param aBitmapData Descriptor containing the bitmap data stream

     *

     */

    void StartDecodingL( const TDesC8& aBitmapData );

    /**

     * From CActive

     * (see details from baseclass )

     * @since S60 v5.0 

     */

    void RunL();

    /**

     * From CActive

     * (see details from baseclass )

     * @since S60 v5.0 

     */

    void DoCancel();

private:

    /**

     * First-phase (C++) constructor

     * @param aHeader The header control to which the bitmap is to be inserted after loading

     * @since S60 v5.0  

     */

    CServiceWidgetImageDecoder(MServiceWidgetImagerDecodeObserver& aObserver);

    /**

     * Second phase constructor

     * @since S60 v5.0 

     */

    void ConstructL();

    /**

     * helper to do encoding

     * @since S60 v5.0 

     */

    void StartEncodingL();

 private : // data  

    /**

     * Not Owns : notify once complete

     */

    MServiceWidgetImagerDecodeObserver& iObserver;

    /**

     * Owns : The image decoder whose service is called to decode the image

     */

    CImageDecoder* iImgDecoder;

    /**

     * Owns : The image encoder whose service is called to decode the image

     */

    CImageEncoder* iImageEncoder;

    /**

     * Owns : Handle to the file server session for loading the bitmap

     */ 

    RFs iFs;

    /**

     * The bitmap.

     * Owned until decoding is complete, then ownersip is transferred to header control.

     */

    CFbsBitmap* iBitmap; // owned until completion

    /**

     * Owns : Copy of the bitmap data stream

     */

    HBufC8* iBitmapData;

     /**

     * Owns : Copy of mimeType

     */

    HBufC8* iMimeType;

    // next operation to perform

    TSWDEOperationId iNextOperationId;

    };

#endif /*CSERVICEWIDGETIMAGEDECODER_H*/