/*
* Copyright (c) 2006 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:  Class declaration of CMPXImageUtil.
*
*/


#ifndef CMPXIMAGEUTIL_H
#define CMPXIMAGEUTIL_H

//  INCLUDES

#include "mpxalbumartutilobserver.h"


// FORWARD DECLARATIONS
class CFbsBitmap;
class CBitmapScaler;
class CImageDecoder;

// CLASS DECLARATION

/**
*  Image Conversion Class.
**/
class CMPXImageUtil : public CActive
    {
public:
   
	// states for this engine
  	enum TState 
	    {
	    EIdle = 0,
	    EDecoding,
	    EScaling
	    };

public:  // Constructors and destructor
        
    /**
    * Two-phased constructor.
    * @param aObserver ablum art observer
    * @return A pointer to a newly created object
    */
    static CMPXImageUtil* NewL(MMPXAlbumArtUtilObserver& aObserver);

    /**
    * Destructor.
    */
    ~CMPXImageUtil();

private:

    /**
    * C++ default constructor.
    */
    CMPXImageUtil(MMPXAlbumArtUtilObserver& aObserver); 

    /**
    * By default Symbian 2nd phase constructor is private.
    */
    void ConstructL();  

public: // New functions
        
    /*
    * Starts to decode an image from a file. 
    * @param aFileName Full path and filename of the image to be decoded.
    * @param aSize The size of the required destination BMP.
    * @param aDisplayMode the display mode of the destination BMP
    */
    void StartToDecodeL(const TDesC& aFileName, 
                        const TSize& aSize, 
                        TDisplayMode aDisplayMode = EColor64K);
  
    /*
    * Starts to decode an image from JPG buffer
    * @param aSize The size of the required destination JPG
    * @param aAlbumArt The pointer to the JPG buffer
    * @param aDisplayMode the display mode of the destination JPG
    */
    void StartToDecodeL(const TSize& aSize, 
                        HBufC8* aAlbumArt, 
                        TDisplayMode aDisplayMode = EColor64K);

    /*
    * Cancel outstanding asynch requests
    */
    void CancelRequest();
    
private: // New functions

    /**
    * Scales iBitmap to iSize 
    **/
    void ScaleL();
    TSize CalculateDecodeSize(const TSize& aSize);

private: // Functions from base classes

    /**
    * Cancellation of an outstanding request.
    */
    void DoCancel();

    /**
    * Handles an active object’s request completion event.
    */
    void RunL();
      
private:    // Data

    MMPXAlbumArtUtilObserver&       iObserver;      // Album art util observer
    CFbsBitmap*                     iBitmap;        // decoded image
    CImageDecoder*                  iImageDecoder;  // decoder
    CBitmapScaler*                  iScaler;        // bitmap scaler
    TSize                           iSize;          // desired size of the bitmap
    TState                          iState;         // engine state
    RFs                             iFs;            // for opening/saving images from/to files
    HBufC8*                         iImageData;     // Album art image data (owned)
    TBool                           iScaleRquired;
    };

#endif // CMPXIMAGEUTIL_H   
            
// End of File