/*

* Copyright (c) 2010 Ixonos Plc.

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the "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:

* Ixonos Plc

*

* Description:  

*

*/

#ifndef IMAGEEDITORIMAGEHANDLER_HPP

#define IMAGEEDITORIMAGEHANDLER_HPP

//	INCLUDES

#include <e32base.h>

//	FORWARD DECLARATIONS

class CImageDecoder;

class CImageEncoder;

class CFbsBitmap;

class MImageHandlerObserver;

class TRequestStatus;

class CFileExtensionMIMEType;

class CFrameImageData;

/*	CLASS: CImageEditorImageHandler

*

*   CImageEditorImageHandler represents image handling unit in Image Editor.

*	It includes functionality to asynchronously load and save images. Also,

*	it provides other image managing functionality.

*

*/

class CImageEditorImageHandler : public CBase

{

public:

/** @name Methods:*/

//@{

	enum TImageFormat

	{

		EImageFormatInvalid,

		EImageFormatBmp,

		EImageFormatJpg,

		EImageFormatMbm,

		EImageFormatGif,

		EImageFormatPng,

		EImageFormatTiff,

		EImageFormatMax

	};

/** @name Methods:*/

//@{

	/** NewL factory method, pops cleanupstack

	*

	*	@param -

	*	@return pointer to created CImageEditorImageHandler object

	*/

	IMPORT_C static CImageEditorImageHandler * NewL ();

	/** Destructor

	*

	*	@param -

	*	@return -

	*/

	IMPORT_C virtual ~CImageEditorImageHandler ();

	/** LoadImageAsync

	*

	*	Loads image asyncronically. Calls RunL method of an active object

	*	when loading complete.

	*

	*	@param aFileName - name of the image file to be loaded

	*	@param aBitmap - bitmap to which image is loaded, must be created

	*	@param aStatus - status indicator

	*	and set to wanted size and displaymode

	*	@return -

	*/

	IMPORT_C void LoadImageAsyncL (

		const TDesC &		aFileName,

		CFbsBitmap *&		aBitmap,

		TRequestStatus *	aStatus

		);

	/** ContinueLoading

	*

	*	Continues loading of image data, if KErrUnderflow occurs.

	*

	*	@param aStatus - request status

	*	@return -

	*/

	IMPORT_C void ContinueLoading (TRequestStatus *	aStatus);

    /** SaveImageAsync

	*

	*	Saves image asyncronically. Calls RunL method of an active object

	*	when saving complete.

	*

	*	@param aFileName - saved image name

	*	@param aBitmap - bitmap to be saved

	*	@param aImageQuality - JPEG image quality (0,100)

	*	@param aStatus - status indicator

	*	@return -

	*/

	IMPORT_C void SaveImageAsyncL (

		const TDesC	&		aFileName,

		const CFbsBitmap &	aBitmap,

		const TInt			aImageQuality,

		TRequestStatus *	aStatus

		);

	/** GetJpegQualityFactorL

	*

	*	Gets the JPEG quality factor.

	*

	*	@param aFileName - saved image name

	*	@return - the quality factor

	*/

    IMPORT_C  TInt GetJpegQualityFactorL (const TDesC & aFileName);

	/** RenameImage

	*

	*	Renames image. 

	*

	*	@param aFileNameSrc - source image name

	*	@param aFileNameDst - destination image name

	*	@return KErrNone if no errors, system wide error code otherwise

	*/

	IMPORT_C TInt RenameImage (

		const TDesC	&		aFileNameSrc,

		const TDesC	&		aFileNameDst

		) const;

	/** DeleteImage

	*

	*	Deletes image. 

	*

	*	@param aFileName - image name to be deleted

	*	@return KErrNone if no errors, system wide error code otherwise

	*/

	IMPORT_C TInt DeleteImage (const TDesC & aFileName) const;

	/** CleanupConverters 

	*

	*	Cancels the asynchronous requests and cleans up image converters.

	*

	*	@param -

	*	@return -

	*/

	IMPORT_C void CleanupConverters ();

	/** IsRajpegImageL

	*

	*	Checks whether an image is a RAJPEG image or not.

	*

	*	@param aFileName - file name

	*	@return ETrue if RAJPEG image, EFalse otherwise

	*/

	IMPORT_C TBool IsRajpegImageL (const TDesC & aFileName) const;

	/** IsJpegIntact

	*

	*	Verifies JPEG image content.

	*

	*	@param aFileName - file name

	*	@return ETrue if intact, EFalse if broken

	*/

	IMPORT_C TBool IsJpegIntact (const TDesC & aFileName);

//@}

protected:

/** @name Methods:*/

//@{

//@}

/** @name Members:*/

//@{

//@}

private:

/** @name Methods:*/

//@{

	/** Default constructor

	*

	*	@param -

	*	@return -

	*/

	CImageEditorImageHandler ();

	/** Second phase constructor, may leave

	*

	*	@param -

	*	@return -

	*/

	void ConstructL ();

	/** GetMIMETypeLC

	*

	*	Finds and create CFileExtensionMIMEType type based on file extension.

	*

	*	@param aFileName - image file name

	*	@return MIME type instance

	*/

	CFileExtensionMIMEType * GetMIMETypeL (const TDesC & aFileName);

	/*	GetFrameImageDataL

	*

	*   Gets CFrameImageData instance.

	*

	*   @param aExt - image name extension

	*   @param aQuality - JPEG quality

	*   @return CFrameImageData instance

	*/

	CFrameImageData * GetFrameImageDataL (

		const TDesC &		aExt,

		const TInt			aQuality

		) const;

	/** Copy constructor, disabled

	*/

	CImageEditorImageHandler (const CImageEditorImageHandler & rhs);

	/** Assignment operator, disabled 

	*/

	CImageEditorImageHandler & operator= (const CImageEditorImageHandler & rhs);

//@}

/** @name Members:*/

//@{

	/// Image decoder instance (used in loading)

	CImageDecoder * iImageDecoder;

	/// Image encoder instance (used in saving)

	CImageEncoder * iImageEncoder;

//@}

};

#endif

// End of File