/*
* 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 still image quality level and container
*
*/



#ifndef CAESTILLQUALITYLEVELS_H
#define CAESTILLQUALITYLEVELS_H

//  INCLUDES
#include <ecam.h>
#include <e32base.h>
#include <e32std.h>
#include "CaeSdKeys.h"
#include "CaeQualityLevels.h"

// CONSTANTS

const TInt KCaeMaxStillQltyLevelCount = 6;

const TInt KCaeImgWidthQQVGA    = 160; 
const TInt KCaeImgHeightQQVGA   = 120; 

const TInt KCaeImgWidthVGA      = 640; 
const TInt KCaeImgHeightVGA     = 480; 


// FORWARD DECLARATIONS
class CStillQualityLevel;


// CLASS DECLARATION

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

    public: // Constructors and destructor

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

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

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

        /**
        * Gets the specified quality level.
        * @since 2.1
        * @param aIndex Quality level index
        * @return Still quality level
        */
        CStillQualityLevel& At( 
            TInt aIndex ) const;

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

    private:

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

        /**
        * Symbian OS 2nd phase constructor that can leave.
        */
        void ConstructL();

    private:

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

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

    private: // For Shared Data support.

        /**
        * 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
        */
        void CreateQualityLevelString( 
            TInt  aIndex, 
            TDes& aDefaultQualityLevel );

        /**
        * 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
        */
        void ParseQualityLevelFromStringL( 
            const TDesC& qualityLevelString, 
            TInt         aIndex );

    private:
        
        // Supported still capture quality levels.
        CArrayFixFlat<CStillQualityLevel>* iQualityLevels;
    
        // Quality level count Shared Data key.
        const TDesC& iQltyLevelCountSdKey;    
    };



// CLASS DECLARATION

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

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

    public:

        // Still image frame size.
        TSize iFrameSize;

        // Still image output format.
        CCamera::TFormat iOutputFormat;

        // Still image compression quality.
        TInt iCompressionQuality;

        // Estimated size of an image in bytes.
        TInt iByteSize;
    };

#endif // CAESTILLQUALITYLEVELS_H