/*

* 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:    Utility for creating bitmaps from image files

*

*/

/**

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

 */

#ifndef GLXTNIMAGEUTILITY_H

#define GLXTNIMAGEUTILITY_H

#include <e32base.h>

#include <gdi.h>        // For TDisplayMode

class MIHLScaler;

class CFbsBitmap;

class CFbsBitGc;

class CImageDecoder;

class RFs;

/**

 * Utility for creating bitmaps from image files

 *

 * @ingroup glx_thumbnail_creator

 */

NONSHARABLE_CLASS(CGlxtnImageUtility) : public CBase

    {

public:

    CGlxtnImageUtility(RFs& aFs);

    ~CGlxtnImageUtility();

    void Cancel();

    /**

    * Reduce target size to same aspect ratio as source image.

    */

    void AdjustSize(TSize& aTargetSize, const TSize& aSourceSize);

    /**

    * Start asynchronous decoding process for a high quality thumbnail.

    * @param aStatus Request status for the asynchronous operation.

    * @param aFileName Full path of image file.

    * @param aTargetSize Size for the image - modified by this function to

    *           preserve the aspect ratio.

    * @param aMode Display mode for the image.

    */

    CFbsBitmap* DecodeImageL(TRequestStatus& aStatus, const TDesC& aFileName,

                                RArray<TSize>& aTargetSizes, TDisplayMode aMode);

    /**

    * Free resources used by decoding.

    */

    void FreeDecoder();

    /**

    * Get the original size of the image decoded.

    */

    const TSize& OriginalSize() const;

    /**

    * Start asynchronous filtering process for a high quality thumbnail.

    * @param aStatus Request status for the asynchronous operation.

    * @param aSource Source image bitmap.

    * @param aFilteredSource Filtered  image bitmap.

    * @param aTarget Target thumbnail bitmap.

    */

    void FilterImageL(TRequestStatus* aStatus, CFbsBitmap* aSource, CFbsBitmap*& aFilteredSource, CFbsBitmap* aTarget);

    /**

    * Start asynchronous scaling process for a high quality thumbnail.

    * @param aStatus Request status for the asynchronous operation.

    * @param aSrcBitmap Source image bitmap.

    * @param aSrcRect Source image rectangle.

    * @param aDstBitmap Destination thumbnail bitmap.

    * @param aDstRect Destination image rectangle.

    */

	void ScaleImageL(TRequestStatus& aStatus, CFbsBitmap& aSrcBitmap, const TRect& aSrcRect, CFbsBitmap& aDstBitmap, const TRect& aDstRect);

    /**

    * Start asynchronous scaling process for a high quality thumbnail.

    * @param aStatus Request status for the asynchronous operation.

    * @param aSource Source image bitmap.

    * @param aFilteredSource Filtered Source image bitmap.

    * @param aTarget Target thumbnail bitmap.

    */

    void ScaleImage64kL(TRequestStatus* aStatus, CFbsBitmap* aSource, CFbsBitmap* aFilteredSource, CFbsBitmap* aTarget);

private:

    void ScaleColor64K( TUint16* aSrc, TInt aSrcStride, TInt aSrcCols, TInt aSrcRows,

	  								TInt aX, TInt aY, TInt aW, TInt aH,

          		      TUint16* aDst, TInt aDstStride, TInt aDstCols, TInt aDstRows );

    void FilterL( CFbsBitmap* aSource, CFbsBitmap*& aFilteredSource, TInt aFilterPercent );

    void FIRFiltering(

		TUint16* aDst, TUint aDstStridep, TUint aDstCols, TUint aDstRows );

    void FIRFiltering4(

		TUint16* aDst, TUint aDstStridep, TUint aDstCols, TUint aDstRows );

    void FIRFiltering8(

		TUint16* aDst, TUint aDstStridep, TUint aDstCols, TUint aDstRows );

    /*

     * Get the orientation of the file

     * This API reads the Exif tag in an image and returns the orientation of that Image 

     */

    TUint16 GetOrientationL(const TDesC& aFileName) ;

    /*

     * Get the Rotation Angle and Mirroring status of the image so as to set it on the decoder 

     * This API calculates the rotation angle and the Mirroring status required by the decoder

     * @param aOrientation Orientation of the image.

     * @param aRotAngle Rotation angle to be set on the image decoder.

     * @param aFlipStatus Mirroring status for the decoder if 1 then mirroring should be set.

     * Internally it also sets the iOriginalSize to the required size

     */

    void GetRotationParameters(TUint16 aOrientation, TInt& aRotAngle, TBool& aFlipStatus) ;

private:

    // File server session

    RFs& iFs;

    // Decoder used to read image from file

    CImageDecoder* iDecoder;

    // Bitmap scaler

    MIHLScaler* iScaler;

    /** Size of the image in the file being decoded */

    TSize iOriginalSize;

    CFbsBitmap* iImage;

    TUint16* iAddress;

    CFbsBitGc* iBitGc;

    };

#endif  // GLXTNIMAGEUTILITY_H