/*
* Copyright (c) 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:  Class for rendering text based indicators on top of viewfinder
*
*/


#ifndef CAMTEXTITEM_H
#define CAMTEXTITEM_H

#include <e32std.h>
#include <e32base.h>
#include <AknUtils.h>

class CFbsBitmap;
class TAknTextComponentLayout;
class CBitmapContext;

/**
 *  Class for rendering text based indicators on top of viewfinder.
 *
 *  CCamTextItem can be used to render text on the screen in a way
 *  that is compatible with S60 Posting based overlays. The text mask
 *  is also written in the alpha channel of the screen buffer to allow
 *  it to be overlaid on top of the viewfinder.
 *
 *  @since S60 v5.0
 */
class CCamTextItem : public CBase
    {
public:
    /**
     * Two-phased constructor.
     */
    static CCamTextItem* NewL();

    /**
    * Destructor.
    */
    virtual ~CCamTextItem();

public:
    /**
     * Set the layout for the text item.
     * 
     * @since S60 v5.0
     * @param aParentRect Rectangle for the parent layout item
     * @param aLayout     A TAknTextComponentLayout containing the layout
     *                    details for this item. Usually this can be retrieved
     *                    using the AknLayout2 API.
     */
    void SetLayoutL( const TRect& aParentRect, const TAknTextComponentLayout& aLayout );

    /**
     * Set the text content for the text item.
     *
     * @since S60 v5.0
     * @param aText New text for this item. There are no size limitations. A
     *              local copy if the text is created
     */
    void SetTextL( const TDesC& aText );

    /**
     * Render this text in a bitmap based graphics context.
     *
     * @since S60 v5.0
     * @param aBitmapContext Graphics context to draw into.
     */
    void Draw( CBitmapContext& aBitmapContext ) const;

private:
    
    CCamTextItem();

    void ConstructL();

private: // data

    TAknLayoutText iLayout;

    // own
    HBufC* iText;

    };

#endif // CAMTEXTITEM_H
