/*

* Copyright (c) 2008-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:  Utility class for asynchronously decoding the header thumbnail image

*

*/

#ifndef CCAPPCOMMLAUNCHERIMAGEDECODING_H_

#define CCAPPCOMMLAUNCHERIMAGEDECODING_H_

#include "ccappcommlauncherheaders.h"

class CCCAppCommLauncherHeaderControl;

class CBitmapScaler;

/**

 * Utility class for asynchronously decoding the header thumbnail image

 *

 *  @code

 *   ?good_class_usage_example(s)

 *  @endcode

 *

 *  @lib ccappcommlauncherplugin.dll

 *  @since S60 v5.0

 */

class CCCAppCommLauncherImageDecoding : public CActive

    {

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

     * @param aImageFile Descriptor containing image file name full path

     */

    static CCCAppCommLauncherImageDecoding* NewL(CCCAppCommLauncherHeaderControl* aHeader, const TDesC8* aBitmapData, const TDesC* aImageFile);

    /**

     * Destructor

     */

    ~CCCAppCommLauncherImageDecoding();

    /**

     * Starts the decoding process

     * 

     * @param aImageSize defines image size

     */

    void StartL( TSize aImageSize );

    /**

     * From CActive

     * (see details from baseclass )

     */

    void RunL();

    /**

     * From CActive

     * (see details from baseclass )

     */

    void DoCancel();

private:

    /**

     * First-phase (C++) constructor

     * 

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

     */

    CCCAppCommLauncherImageDecoding(CCCAppCommLauncherHeaderControl* aHeader);

    /**

     * Second phase constructor

     * 

     * @param aBitmapData Descriptor containing the bitmap data stream

     * @param aImageFile Descriptor containing image file name full path

     */

    void ConstructL(const TDesC8* aBitmapData, const TDesC* aImageFile);

    /**

     * Scales bitmap

     *

     */

    void ScaleBitmapL();

    /**

     * Create bitmap

     *

     */

    void CreateBitmapL();

    enum TCcaImageDecoderState

        {

        ECcaConvertThumbnailImage = 1,

        ECcaScaleThumbnail,

        ECcaReadImageFromFile,

        ECcaConvertImageFromFile,

        ECcaScaleImage

        };

    /**

     * The image scaler whose service is called to scale the image

     * Own.

     */

    CBitmapScaler* iBitmapScaler;

    /**

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

     * Own.

     */

    CImageDecoder* iImgDecoder;

    /**

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

     * Not own.

     */

    CCCAppCommLauncherHeaderControl* iHeader;

    /**

     * 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

    /**

     * Copy of the bitmap data stream

     * Own.

     */

    HBufC8* iBitmapData;

    /**

     * Copy of image name with path

     * Own.

     */

    HBufC* iImageFullName;

    /** 

      * Contact bitmap size 

      */ 

    TSize iBitmapSize;

    /** 

      * Decoder internal state

      */ 

    TInt iDecoderState;

    /** 

      * Timer used to delay image conversion

      */ 

    RTimer iTimer;

    };

#endif /*CCAPPCOMMLAUNCHERIMAGEDECODING_H_*/