/*
* 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:  Camera Application Engine imaging quality level and container
*
*/



#ifndef CAEQUALITYLEVELS_H
#define CAEQUALITYLEVELS_H

// INCLUDES
#include <ecam.h>
#include <e32base.h>
#include <e32std.h>

// CONSTANTS
const TInt KCaeDefaultQltyLevelCount = 3;
const TInt KCaeMaxSdKeyLength = 10;
const TInt KCaeMaxQltyLevelStringLength = 256;

// FORWARD DECLARATIONS
class CQualityLevel;
class RSharedDataClient;

// CLASS DECLARATION

/**
* Camera Application Engine image/video quality levels container.
*
*/
NONSHARABLE_CLASS( CCaeQualityLevelsCont ) : public CBase
    {

    public: // Constructors and destructor

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

        /**
        * Two-phased constructor.
        */
        static CCaeQualityLevelsCont* NewL();

        /**
        * Initialize quality levels from Shared Data ini-file.
        * @since 2.1
        * @param aSdUidQltyLevels Shared Data ini-file UID
        * @return Count of quality levels initialized
        */
        TInt InitFromSdL( 
            const TUid&  aSdUidQltyLevels );

        /**
        * Initializes quality levels to hardcoded default values.
        * @since 2.1
        * @return Count of quality levels initialized
        */
        virtual TInt InitDefaultsL() = 0;
        
        /**
        * Gets the quality level count.
        * @since 2.1
        * @return Quality level count
        */
        virtual TInt Count() const = 0;

        /**
        * Get the specified quality level Shared Data key.
        * @since 2.1
        * @param aIndex Quality level index
        * @return Quality level Shared Data key
        */
        virtual const TDes& Key( 
            TInt aIndex ) const = 0;

    protected:

        /**
        * C++ constructor.
        */
        CCaeQualityLevelsCont();

    private: // Private methods.

        /**
        * Fetches namebase setting from SharedData Camera ini file.
        * @since 2.1
        * @param aSdUidQltyLevels Shared Data ini-file UID
        * @param aIndex Quality level index
        * @return void
        */
        void FetchQualityLevelL(
            RSharedDataClient& aSharedData, 
            const TUid&        aSdUidQltyLevels, 
            TInt               aIndex );

    private: // Private pure virtual methods.

        /**
        * Resizes quality level array.
        * @since 2.1
        * @param aQualityLevelCount Quality level count for the new array
        * @return void
        */
        virtual void ResizeL( 
            TInt aQualityLevelCount ) = 0;

        /**
        * Gets the quality level count Shared Data key.
        * @since 2.1
        * @return Quality level count Shared Data key
        */
        virtual const TDesC& QltyLevelCountSdKey() const = 0;

        /**
        * Creates quality level string for SharedData Camera ini file.
        * @since 2.1
        * @param aIndex Quality level index
        * @param aDefaultQualityLevel Output quality level string
        * @return void
        */
        virtual void CreateQualityLevelString( 
            TInt  aIndex, 
            TDes& aDefaultQualityLevel ) = 0;

        /**
        * Parses quality level string to quality level object data.
        * @since 2.1
        * @param aQualityLevelString Quality level string to parse
        * @param aIndex Quality level index
        * @return void
        */
        virtual void ParseQualityLevelFromStringL( 
            const TDesC& qualityLevelString, 
            TInt         aIndex ) = 0;
    };



// CLASS DECLARATION

/**
* Camera Application Engine image/video quality level.
*
*/
NONSHARABLE_CLASS( CQualityLevel ) : public CBase
    {
    public:
        
        /**
        * Constructor.
        */
        CQualityLevel();

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

    public:

        // Shared Data ini-file key.
        TBuf<KCaeMaxSdKeyLength> iKey;

    };

#endif // CAEQUALITYLEVELS_H