/*

* 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 video quality level and container

*

*/

#ifndef CAEVIDEOQUALITYLEVELS_H

#define CAEVIDEOQUALITYLEVELS_H

//  INCLUDES

#include <ecam.h>

#include <e32base.h>

#include <e32std.h>

#include "CaeSdKeys.h"

#include "CaeQualityLevels.h"

// CONSTANTS

const TInt KCaeMaxVideoStringParLength = 32;

const TInt KCaeMaxAudioTypeStringParLength = 4;

const TInt KCaeMaxVideoQltyLevelCount = 6;

const TInt KImgWidthSubQCIF  = 128; 

const TInt KImgHeightSubQCIF = 96; 

const TInt KImgWidthQCIF     = 176; 

const TInt KImgHeightQCIF    = 144; 

const TInt KImgWidthCIF      = 352; 

const TInt KImgHeightCIF     = 288; 

_LIT8(KVideoMimeType, "video/3gpp");

_LIT(KPreferredSupplier, "Nokia");

_LIT8(KVideoType, "video/H263-2000");

_LIT8(KAudioType, " AMR");

// FORWARD DECLARATIONS

class CVideoQualityLevel;

// CLASS DECLARATION

/**

* Camera Application Engine video recording quality levels container.

*

*/

NONSHARABLE_CLASS( CCaeVideoQualityLevelsCont ) : public CCaeQualityLevelsCont

    {

    public: // Constructors and destructor

        /**

        * Destructor.

        */

        virtual ~CCaeVideoQualityLevelsCont();

        /**

        * Two-phased constructor.

        */

        static CCaeVideoQualityLevelsCont* 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 Video quality level

        */

        CVideoQualityLevel& 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.

        */

        CCaeVideoQualityLevelsCont();

        /**

        * 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& aQualityLevelString, 

            TInt         aIndex );

    private:

        // Supported video recording quality levels.

        CArrayFixFlat<CVideoQualityLevel>* iQualityLevels;

        // Quality level count Shared Data key.

        const TDesC& iQltyLevelCountSdKey;    

    };

// CLASS DECLARATION

/**

* Camera Application Engine video recording quality level.

*

*/

NONSHARABLE_CLASS( CVideoQualityLevel ) : public CQualityLevel

    {

    public:

        /**

        * Constructor.

        */

        CVideoQualityLevel();

        /**

        * Destructor.

        */

        virtual ~CVideoQualityLevel();

    public:

        // The video recording frame size.

        TSize iFrameSize;

        // The video recording frame rate.

        TReal32 iFrameRate;

        // The video recording bit rate.

        TInt iBitRate;

        // A Boolean indicating if video recording audio is enabled or not.

        TBool iAudioEnabled;

        // The video recording audio bit rate.

        TInt iAudioBitRate;

        // The video MIME type (e.g. "video/3gpp").

        TBuf8<KCaeMaxVideoStringParLength> iMimeType;

        // The preferred supplier of video controller (e.g. "Company X").

        TBuf<KCaeMaxVideoStringParLength> iPreferredSupplier;

        // The video type (e.g. "video/H263-2000").

        TBuf8<KCaeMaxVideoStringParLength> iVideoType;

        // The audio type expressed with four characters (e.g. " AMR").

        TBuf8<KCaeMaxAudioTypeStringParLength> iAudioType;

        // The estimated video recording bit rate to storage (bits per second).

        TInt iStorageRate;

    };

#endif // CAEVIDEOQUALITYLEVELS_H