/*

* Copyright (c) 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:      

*

*/

// This file defines the API for ThumbnailCreator.dll

#ifndef __UPNPTHUMBNAILCREATOR_H__

#define __UPNPTHUMBNAILCREATOR_H__

//  Include Files

#include <e32base.h>	// CBase

#include <e32std.h>	 // TBuf

#include <mdesession.h>

#include <mdeconstants.h>

#include <mdenamespacedef.h>

#include <mdequery.h>

#include <mdeobject.h>

#include <thumbnailmanager.h>

#include <thumbnailmanagerobserver.h>

#include "upnpthumbnailcreatorobserver.h"

class CMdeSession;

class CMdEObjectQuery;

class CFbsBitmap;

class CImageEncoder;

//  Constants

enum TThumbnailDlnaSize

    {

    ESmall = 0,

    EMedium,

    ELarge,

    EThumbnail,

    ESmallIcon,

    ELargeIcon

    };

//  Class Definitions

NONSHARABLE_CLASS( CUpnpThumbnailCreator) : private CActive,

                                          private MMdESessionObserver,

                                          private MMdEQueryObserver,

                                          private MThumbnailManagerObserver

    {

public:

    // states for this engine

    enum TThumbnailCreatorStates 

        {

        EIdle = 0,

        EInitializeMde,

        EQueryingImage,

        EFetchingThumbnail,

        EConvertingThumbnail

        };

        // new functions

    /**

     * static NewL

     *

     * @param MUpnpThumbnailCreatorObserver, thumbnail creator observer

     * @param aFilePath, file path of the source file

     * @return instance to CUpnpThumbnailCreator

     */

    IMPORT_C static CUpnpThumbnailCreator* NewL(

                    MUpnpThumbnailCreatorObserver& aMThumbnailCreatorObserver,

                    const TDesC& aFilePath,

                    TThumbnailDlnaSize aSize);

    /**

     * static NewLC

     *

     * @param MUpnpThumbnailCreatorObserver, thumbnail creator observer

     * @param aFilePath, file path of the source file 

     * @return instance to CUpnpThumbnailCreator

     */

    IMPORT_C static CUpnpThumbnailCreator* NewLC(

                    MUpnpThumbnailCreatorObserver& aMThumbnailCreatorObserver,

                    const TDesC& aFilePath,

                    TThumbnailDlnaSize aSize);

    /**

     * On completion of the ThumbnailCreatorReady callback with status KErrNone, 

     * this method MdeObjectId returns the MdE object Id for the image.

     * @return ObjectId for the object in MdE 

     */

    IMPORT_C TInt MdeObjectId() const;

    /**

     * On completion of the ThumbnailCreatorReady callback with status KErrNone, 

     * this method ThumbnailFilePath returns the thumbnail file path.

     * @return filepath of the thumbnail 

     */

    IMPORT_C const TDesC& ThumbnailFilePath() const;

    /**

     * On completion of the ThumbnailCreatorReady callback with status KErrNone, 

     * this method Thumbnail returns the thumbnail

     * @return reference to thumbnail created 

     */

    IMPORT_C CFbsBitmap& Thumbnail() const;

public:

    /**

     *  Destructor

     */

     ~CUpnpThumbnailCreator();

private:

    /********************************************************************

     * MMdESessionObserver  virtual methods

     ********************************************************************/

    void HandleSessionOpened(CMdESession& aSession, TInt aError);

    void HandleSessionError(CMdESession& aSession, TInt aError);

    /********************************************************************

     * MMdEQueryObserver virtual methods

     ********************************************************************/

    void HandleQueryNewResults(CMdEQuery& aQuery, TInt aFirstNewItemIndex,

                                           TInt aNewItemCount);

    void HandleQueryCompleted(CMdEQuery& aQuery, TInt aError);

    /********************************************************************

     * MThumbnailManagerObserver virtual methods

     ********************************************************************/

    // Callbacks from MThumbnailManagerObserver for getting thumbnails

    void ThumbnailPreviewReady(MThumbnailData& aThumbnail,

                                            TThumbnailRequestId aId );

    void ThumbnailReady(TInt aError, MThumbnailData& aThumbnail, 

                                            TThumbnailRequestId aId );    

private:

    // CActive

     void DoCancel();

     void RunL();    

     TInt RunError (TInt aError);

private:

    // new functions

    // CI: erkki missing doxygen comments @param ...

    /** CUpnpthumbnailCreator Constructor*/

    CUpnpThumbnailCreator(

            MUpnpThumbnailCreatorObserver& aMUpnpThumbnailCreatorObserver,

            TThumbnailDlnaSize aSize);

    /** Two Phase constructor -ConstructL method*/

    void ConstructL(const TDesC& aFilePath);

    TSize ConvertDlnaSizeToImageSize();

    /** Query to Metadata engine*/

    void QueryMdeL();

    /** GetThumbnail from Thumbnailmanager*/

    void GetThumbnail();

    /** Pepare the filepath for thumbnail storage*/

    void PrepareThumbnailFilePathL();

    /** Notifies observer*/

    void ThumbnailReady( TInt aErr );

    /** Uses ICL encoder to Encode and Save the thumbnail*/

    void EncodeAndSaveThumbnailL();

    /** Completes active object*/

    void CompleteRequest(TInt aError);

private:

    // data

    CMdESession* iMdESession;  //owned

    CMdEQuery* iMdEQuery;      //owned

    CFbsBitmap* iThumbnail;    //owned

    HBufC* iImageFilePath;     //owned

    HBufC* iThumbnailFilePath; //owned

    TInt iObjectid;

    CThumbnailManager* iThmbManager; //owned

    MUpnpThumbnailCreatorObserver& iMUpnpThumbnailCreatorObserver;

    RFs iFsSession;    //owned

    CImageEncoder*         iImageEncoder; //owned, encoder from ICL API    

    TThumbnailCreatorStates iState;

    TThumbnailDlnaSize iThumbnailDlnaSize;

    };

#endif  // __UPNPTHUMBNAILCREATOR_H__