/*
* Copyright (c) 2007-2008 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:  Camera UI decorator*
*/



#ifndef CAMDECORATOR_H
#define CAMDECORATOR_H

#include <e32base.h>
 

class TResourceReader;
class CBlendedBackground;
class CBitmapContext;
class TRect;
class CCamAppController;
class CCamRecordingIconDecoration;
class MCamObserver;

class CCamDecorator : public CBase
    {
public:
    /**
    * Symbian OS two-phased constructor
    * @since 2.8
    * @param aResourceId The resource that describes the decorations required. If 0, a blank decorator is created (i.e. Draw() will have no effect)
    * @param aObserver If creator is interested, will be registered with observable decorations
    * @return New instance of class
    */
	static CCamDecorator* NewL( CCamAppController& aController,
	                            TInt               aResourceId, 
	                            MCamObserver*      aObserver = NULL );

    /**
    * Destructor
    */
    ~CCamDecorator();

protected:
    /**
    * Constructor
    */
    CCamDecorator( CCamAppController& aController );

    /**
    * Second-phase constructor
    * @param aResourceId The resource that describes the decorations required. If 0, a blank decorator is created (i.e. Draw() will have no effect)
    * @param aObserver If creator is interested, will be registered with observable decorations
    */
    void ConstructL( TInt aResourceId, MCamObserver* aObserver );

public: // New functions
    /**
    * Draws all decorations
    * @param aGc The context to use while drawing
    * @param aDrawRect Rectangle passed on to decorations - meaning varies depending on decoration
    * @param aForceBlankers Forces the display of the blanking components
    */
    void Draw( CBitmapContext& aGc, const TRect& aDrawRect, const TBool aForceBlankers = EFalse );

private: // New functions
    /**
    * Reads in the details of a blended background, and stores an object based on this
    * @param aResourceReader The resource reader to use
    */
    void CreateBlendedBackgroundL(TResourceReader& aResourceReader);

    /**
    * Reads in the details of a blanker, and stores an object based on this
    * @param aResourceReader The resource reader to use
    */
    void CreateDVFBlankerL(TResourceReader& aResourceReader);

    /**
    * Reads in the details of a recording icon, and stores an object based on this
    * @param aResourceReader The resource reader to use
    */
    void CreateRecordingIconL(TResourceReader& aResourceReader);

private: // Data
    // Lists of all decorator elements
    RArray<TRect> iDVFBlankers;
    RPointerArray<CCamRecordingIconDecoration> iRecordingIcons;
    
    // Controller
    CCamAppController& iController;

    // An observer to add to observable decorations, if wanted. May be NULL.    
    MCamObserver* iPossibleObserver;
    
    // If true, nothing will be drawn on call to Draw. Optimization.
    TBool iDrawNothing;
    };
    
#endif // CAMDECORATOR_H

// End of File