/*
* Copyright (c) 2004-2007 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:  Internal utility class to handle scalability-related
                 operations.
*
*/


#ifndef AKNSSCALABILITYUTILS_H
#define AKNSSCALABILITYUTILS_H

// INCLUDES
#include <AknsItemData.h>
#include "AknsAppSkinInstance.h"

// FORWARD DECLARATIONS
class MAknsSkinInstance;
class CBitmapContext;
class CAknsItemDef;
class CAknsRlMasterLayout;
class TAknsBackground;

// CLASS DECLARATION

/**
* Internal utility class for scalability-related operations.
*
* @since 2.8
*
* @internal
*/
NONSHARABLE_CLASS(AknsScalabilityUtils)
    {

    public: // New methods

        /**
        * Performs scalability-aware drawing of a bitmap.
        * @internal
        * @since 2.8
        */
        static TBool DrawPartialCachedImage(
            MAknsSkinInstance* aSkin, CBitmapContext& aGc,
            const TRect& aTrgLayoutRect, const TRect& aTrgDrawRect,
            CAknsImageItemData* aImgData, const TAknsItemID& aIID,
            const TAknsImageAttributeData* aAttr,
            const TInt aDrawParam );

        /**
        * Processes (and re-ceates if necessary) an item def.
        *
        * @internal
        *
        * @since 2.8
        */
        static CAknsItemDef* ProcessDefL( CAknsItemDef* aDef );

        /**
        * Converts the given effect queue item to a rendered bitmap
        * item, if possible.
        *
        * @internal
        *
        * @since 2.8
        *
        * @return Cached pointer to the bitmap item data, or @c NULL.
        *   No ownership is transferred.
        */
        static CAknsImageItemData* ConvertToBitmap(
            CAknsAppSkinInstance* aSkin, const TAknsItemID aIID,
            const TAknsBackground* aLayout );

        /**
        * Gets the concrete item ID of a scalable item:
        *
        * @since 2.8
        *
        * @internal
        */
        static TAknsItemID ConcreteEffectQueue( CAknsAppSkinInstance* aSkin,
            const TAknsItemID& aIID );

        /**
        * Gets the backward-compatibility adjusted skin color.
        *
        * @since 2.8
        *
        * @internal
        *
        * @return @c ETrue if color assigned, @c EFalse otherwise.
        */
        static TBool GetBackwardCompatibilityColor(
            MAknsSkinInstance* aInstance, TRgb& aRgb,
            const TAknsItemID& aID, const TInt aIndex );

    protected: // New methods

       /**
        * Renders the given item recursively, placing the resulting
        * bitmaps back to the cached content.
        *
        * @internal
        *
        * @since 2.8
        *
        * @return Rendered bitmap, no ownership transferred.
        */
        static CAknsImageItemData* RecursiveCacheRenderL(
            CAknsAppSkinInstance* aSkin,
            const TAknsItemID aIID, const TInt aLayoutType,
            CAknsRlMasterLayout& aLayoutMaster,
            const TSize& aLayoutSize, TRect& aRectOut, TBool& aMorphingOut,
            TBool& aEmpty );
        static CFbsBitmap *LoadBitmapFromSkinId(
            MAknsSkinInstance* aInstance,
            const TAknsItemID &aID,
            const TSize &size);

    private: // Construction and destruction

        AknsScalabilityUtils();
        ~AknsScalabilityUtils();

    };

#endif // AKNSSCALABILITYUTILS_H

// End of File