/*

* Copyright (c) 2002 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:  Graphics Extension Library header file

*

*/

#ifndef GFXIMAGETRANSFORMER_H

#define GFXIMAGETRANSFORMER_H

#include <e32std.h>

#include <fbs.h>

#include <bitstd.h>

#include "GfxFloatFixPt.h"

#include "GfxAffineTransform.h"

#include "GfxRenderingHints.h"

#include "GfxRectangle2D.h"

#include "GfxPoint2D.h"

#include "GfxColor.h"

class CVGRenderer;

/**

 * Class to perform transformation on an image.

 *

 *  @lib Gfx2D.lib

 *  @since 1.0

 */

class TGfxImageTransformer

    {

    public:

        /**

         * Contructor.

         *

         * @since 1.0

         * @param aTransform : transform to apply.

         * @param aInterpolation : image interpolation

         * @return

         */

                            TGfxImageTransformer( TGfxAffineTransform* aTransform, CVGRenderer * aRenderer);

        /**

         * Draw the source image onto the destination with the transformation defined by

         * this object, blending with the alpha value.

         *

         * @since 1.0

         * @param aSrc : source image

         * @param aPoint : origin point of the text rectangle.

         * @param aDst : destination image buffer.

         * @param aDstWidth : destination image width.

         * @param aDstHeight : destination image height.

         * @param aAlpha : blending alpha value.

         * @param aClipRect :

         * @param aReverse : ETrue if copying image from aDst to aSrc.

         *                   This is a special case and used to copy background image to text box.

         *                   EFalse is for regular use.

         * @return

         */

         void               Draw( CFbsBitmap* aSrc,

                                          const TGfxPoint2D& p,

										  TUint32* aDst,

										  TInt aDstWidth,

										  TInt aDstHeight,

										  TUint8 aAlpha,

                                          TGfxColor aTransparentColor,

										  const TRect& aClipRect,

										  TBool aReverse = EFalse

										  );

        /**

         * Draw the source image onto the destination with the transformation defined by

         * this object.  Uses the alpha bits of the EColor16MU to blend.  Only EColor16MU mode

         * for aSrc is allowed.

         *

         * @since 1.0

         * @param aSrc : source image

         * @param aPoint : origin point of the text rectangle.

         * @param aDst : destination image buffer.

         * @param aDstWidth : destination image width.

         * @param aDstHeight : destination image height.

         * @param aClipRect :

         * @param aReverse : ETrue if copying image from aDst to aSrc.

         *                   This is a special case and used to copy background image to text box.

         *                   EFalse is for regular use.

         * @return

         */

         void               Draw( CFbsBitmap* aSrc,

                                          const TGfxPoint2D& p,

										  TUint32* aDst,

										  TInt aDstWidth,

										  TInt aDstHeight,

										  const TRect& aClipRect

										  );

        /**

         * Get the bounding box for the given image once transformed.

         *

         * @since 1.0

         * @param aSrc : source image

         * @param aOffset : offset.

         * @return

         */

         TGfxRectangle2D    GetTransformedBound( CFbsBitmap* aSrc,

                                                         const TGfxPoint2D& aOffset );

        /**

         * Draw the source image onto the destination with the transformation defined by

         * this object, blending with the alpha value. When aReverse is ETrue, do the reverse.

         *

         * @since 1.0

         * @param aSrc : source image

         * @param aPoint : origin point of the text rectangle.

         * @param aDstWidth : destination image width.

         * @param aDstHeight : destination image height.

         * @param aClipRect :

         * @param aReverse : ETrue if copying image from aDst to aSrc.

         *                   This is a special case and used to copy background image to text box.

         *                   EFalse is for regular use.

         * @return

         */

         void       ImageBlend( CFbsBitmap* aSrc,

                                          const TGfxPoint2D& p,

										  TInt aDstWidth,

										  TInt aDstHeight,

										  const TRect& aClipRect,

										  TBool aReverse = EFalse

										  );

        /**

         * Compute scanline starting/end position for the rectangle.

         *

         * @since 1.0

         * @param y : current rectangle's height

         * @param rect : rectangle that needs to be computed.

         * @param north : transformed corner.

         * @param west :  transformed corner.

         * @param east :  transformed corner.

         * @param south :  transformed corner.

         * @param xstart : computed x coordinates for start position

         * @param xend : computed x coordinates for end position

         *

         * @return none

         */

        void ComputeXPositions(TFloatFixPt y, TRect rect, TGfxPoint2D north, TGfxPoint2D west,

            TGfxPoint2D east, TGfxPoint2D south, TInt& xstart, TInt& xend);

        /**

         * compute coordinates from transformed 4 points.

         *

         * @since 1.0

         *

         * @return none

         */

        void SortCoordinates(TGfxPoint2D& origin, TGfxPoint2D& top,

            TGfxPoint2D& north, TGfxPoint2D& south, TGfxPoint2D& right,

            TGfxPoint2D& east, TGfxPoint2D& west, TGfxPoint2D& corner,

            TGfxPoint2D aP, const TInt srcWidth, const TInt srcHeight);

    private:

        TGfxAffineTransform*        iTransform;

        CVGRenderer *           iVgRenderer;

    };

#endif      // GFXIMAGETRANSFORMER_H