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


#ifndef CALCTRANSFORM_H
#define CALCTRANSFORM_H

#include <gdi.h>
#include <lcdgdrv.h>
#include "lcdgdrvif.h"
#include "lcdtransform.h"


/**
 * Compute the TLcdTransform mapping between aSrcRect and aDstRect with transform type
 * aSrcTransform.
 */
IMPORT_C TLcdTransform CalcTransform
(
    const TRect&   aDstRect,            // unclipped
    const TRect&   aSrcRect,            // unclipped
    TTransformType aSrcTransform
);

/**
 * Calculate clipped source and destination rectangles for
 * src to dst transform aSrcTransform. This function calculates
 * the largest corresponding subrectangles of aDstRect and aSrcRect
 * that also lie within aDstClipRect and aSrcClipRect respectively.
 */
IMPORT_C void ClipTransformRect
(
    TRect& aDstRect,                    // in/out
    TRect& aSrcRect,                    // in/out
    const TRect& aDstClipRect,          // input
    const TRect& aSrcClipRect,          // input
    TLcdTransform& aSrcTransform        // src to target transform
);

/**
 * Clip source and dst rects against source and dst clip rects, maintaining mapping (i.e. no stretch)
 */
IMPORT_C void ClipRects(TRect& aDstRect, const TRect& aDstClip, TRect& aSrcRect, const TRect& aSrcClip);

/**
 *@return ETrue if aSrcRect and aDstRect correspond under transformation aTransform
 */
IMPORT_C TBool CheckTransform(const TRect& aDstRect, const TRect& aSrcRect, const TLcdTransform aTransform);

/**
 *@return ETrue if aDstRect is completely contained within rectangle of size aDstSize, and
 * aDstRect transformed by aTransform is completely contained within rectangle of size aSrcSize.
 */
IMPORT_C TBool CheckBounds(const TSize& aDstSize, const TSize& aSrcSize, const TRect& aDstRect, const TLcdTransform& aTransform);

#endif // CALCTRANSFORM_H