/*

* Copyright (c) 2008-2009 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:   Thumbnail save task implementation

*

*/

/**

 * @internal reviewed 30/07/2007 by Simon Brooks

 */

#ifndef GLXTNSAVETHUMBNAILTASK_H

#define GLXTNSAVETHUMBNAILTASK_H

// INCLUDES

#include "glxtntask.h"

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CFbsBitmap;

class CImageEncoder;

class CGlxtnFileInfo;

// CLASS DECLARATION

/**

* Task to save a generated thumbnail in persistent storage.

*

* @author Dan Rhodes

* @ingroup glx_thumbnail_creator

*/

NONSHARABLE_CLASS(CGlxtnSaveThumbnailTask) : public CGlxtnTask

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        * @param iItemId Media ID of item whose thumbnail is to be saved.

        * @param aFileInfo Information about the media file.

        * @param aSize Requested thumbnail size.

        * @param aThumbnail Thumbnail bitmap to save.

        * @param aStorage Client's storage interface.

        */

        static CGlxtnSaveThumbnailTask* NewL(

                    const TGlxMediaId& aItemId,

                    CGlxtnFileInfo* aFileInfo, const TSize& aSize,

                    CFbsBitmap* aThumbnail, MGlxtnThumbnailStorage* aStorage);

        /**

        * Destructor.

        */

        virtual ~CGlxtnSaveThumbnailTask();

    protected:  // From CGlxtnTask

        TBool DoStartL(TRequestStatus& aStatus);

    	void DoCancel(); 

    	TBool DoRunL(TRequestStatus& aStatus);

        TBool DoRunError(TInt aError);

    protected:

        /**

        * Constructor for derived classes.

        * @param aId Task type ID.

        * @param iItemId Media ID of item whose thumbnail is to be saved.

        * @param aStorage Client's storage interface.

        */

        CGlxtnSaveThumbnailTask(const TGlxtnTaskId& aId,

                const TGlxMediaId& aItemId, MGlxtnThumbnailStorage* aStorage);

        /**

        * Encode the bitmap to a data buffer.

        * @param aStatus Request status for the asynchronous operation.

        */

        void EncodeThumbnailL(TRequestStatus& aStatus);

        /**

        * Save buffer to storage.

        * @param aStatus Request status for the asynchronous operation.

        */

        void SaveThumbnailL(TRequestStatus& aStatus);

    private:

        /**

        * Constructor.

        * @param iItemId Media ID of item whose thumbnail is to be saved.

        * @param aSize Requested thumbnail size.

        * @param aStorage Client's storage interface.

        */

        CGlxtnSaveThumbnailTask(const TGlxMediaId& aItemId, const TSize& aSize,

                                MGlxtnThumbnailStorage* aStorage);

        /**

        * By default Symbian 2nd phase constructor is private.

        * @param aFileInfo Information about the media file.

        * @param aThumbnail Thumbnail bitmap to save.

        */

        void ConstructL(CGlxtnFileInfo* aFileInfo, CFbsBitmap* aThumbnail);

    protected:  // Data

        /**

        * States for the task's state machine.

        */

        enum TSaveState

            {

            EStateEncoding, EStateSaving, EStateFetchingUri, 

            EStateDecoding, EStateChecking, EStateScaling, EStateFiltering

            };

        /** Requested thumbnail size */

        TSize iSize;

        /** Information about the item's media file */

        CGlxtnFileInfo* iFileInfo;

        /** Thumbnail bitmap to save (owned) */

        CFbsBitmap* iThumbnail;

        /** Current task state */

        TSaveState iState;

    private:    // Data

        /** Format in which the bitmap was encoded */

        TGlxImageDataFormat iFormat;

        /** Encoder for the bitmap (owned) */

        CImageEncoder* iEncoder;

        /** Buffer for encoded data (owned) */

        HBufC8* iData;

    };

#endif  // GLXTNSAVETHUMBNAILTASK_H

// End of File