/*

* Copyright (c) 2004-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:    Provides static configuration functions for different codecs

*

*/

#ifndef MCCCODECCONFIGURATOR_H

#define MCCCODECCONFIGURATOR_H

//  INCLUDES

#include <e32base.h>

#include "mccsymstreambase.h"

// FORWARD DECLARATIONS

class MMMFAudioInput;

class MMMFAudioOutput;

class MDataSink;

class MDataSource;

class TMccCodecInfo;

class CMMFFormatEncode;

class CMMFFormatDecode;

class CMccVideoSource;

class CMccVideoSink;

class CPayloadFormatWrite;

class CPayloadFormatRead;

class TMccFileSourceSetting;

class CMccRtpMediaClock;

class CMMFDevSound;

class CMccFileSink;

// CLASS DECLARATION

/**

*  Mcc Codec configuration static methods declaration

*

*  @lib Mccsubthread.lib

*  @since Series 60 3.0

*/

NONSHARABLE_CLASS( MccCodecConfigurator )

    {

    public: // New functions

        /**

        * Generic codec configuration function.

        * @since Series 60 3.0

        * @param aCodec Codec information

        * @return void

        */

        static void ConfigureCodecL( MDataSource& aDatasource,

                                     MDataSink& aDatasink, 

                                     const TMccCodecInfo& aCodec,

                                     CMccRtpMediaClock& aClock,

                                     CMccSymStreamBase::TCodecState aCodecState,

                                     MDataSink* aAssociatedDatasink = 0 );

        /**

         * Changes the current encoder bitrate

         * @since Series 60 3.0

         * @param aCodec Codec info

         * @param aBitrate New bitrate

         * @param aSounddevice Reference to DevSound

         * @return void

         */

        static void ChangeBitrateL( const TMccCodecInfo& aCodec,

                                    TUint aBitrate, 

                                    CMMFDevSound& aSounddevice );

        /**

        * Gets default values of codec

        */

        static void GetCodecDefaultsL( const TUid aType,

        		                       TDes8& aParam, 

        		                       TMccCodecInfo& aCodec );

        /**

         * Checks whether codec is iLBC and if bitrate change needs a

         * codec stop/resume in order for the reconfiguration to succeed.

         * @since S60 v3.2

         * @param aOrigBitrate Original bitrate

         * @param aRequBitrate Requested bitrate

         * @param aCodec FourCC code of the codec

         * @return TBool ETrue if stop/resume is needed for bitrate change

         *               and codec is iLBC

         */

        static TBool IlbcNeedsStopResume( TInt aOrigBitrate,

            TInt aRequBitrate, const TFourCC& aCodec );

    private:

        /**

        * Configures a codec that is used for uplink/recording

        * @since Series 60 3.0

        * @param aRecordDevice MMF Recording device

        * @param aFormatter Encoder for record data

        * @param aCodec Codec parameters

        * @param aCodecState

        * @return void

        */

        static void DoConfigureLiveAudioUplinkStreamL(

        	MMMFAudioInput& aRecordDevice,

            CPayloadFormatWrite& aFormatter,

            const TMccCodecInfo& aCodec,

            CMccRtpMediaClock& aClock,

            CMccSymStreamBase::TCodecState aCodecState );

        /**

        * Configures a codec that is used for downlink/playback

        * @since Series 60 3.0

        * @param aPlayDevice MMF Playback device

        * @param aFormatter Decoder for playback data

        * @param aCodec Codec parameters

        * @param aCodecState

        * @return void

        */

        static void DoConfigureLiveAudioDownlinkStreamL(

        	MMMFAudioOutput& aPlayDevice,

            CPayloadFormatRead& aFormatter,

            const TMccCodecInfo& aCodec,

            CMccSymStreamBase::TCodecState aCodecState );

       /**

        * Configures a codec that is used for video downlink

        * @since Series 60 3.0

        * @param aPlayDevice MMF Playback device

        * @param aFormatter Decoder for playback data

        * @param aCodec Codec parameters

        * @return void

        */

        static void DoConfigureLiveVideoDownlinkStreamL(

            MDataSink* aDataSink,

            CPayloadFormatRead& aFormatter,

            const TMccCodecInfo& aCodec );

        /**

        * Configures a codec for display sink

        * @since Series 60 3.0

        * @param aCodec Codec parameters

        * @param aDatasink

        * @return void

        */

        static void DoConfigureDisplayL( 

                        const TMccCodecInfo& aCodec,

                        MDataSink* aDatasink );

        /**

        * Configures a codec that is used for uplink video from clip

        * @since Series 60 3.0

        * @param aFormatter Encoder for record data

        * @param aCodec Codec parameters

        * @param aAssociatedSink

        * @return void

        */

        static void DoConfigureClipUplinkStreamL(

            CPayloadFormatWrite& aFormatter,

            const TMccCodecInfo& aCodec,

            MDataSink* aAssociatedSink,

            CMccRtpMediaClock& aClock );

        /**

        * Configures a codec that is used for uplink live video

        * @since Series 60 3.0

        * @param aFormatter Encoder for record data

        * @param aCodec Codec parameters

        * @param aAssociatedSink

        * @return void

        */

        static void DoConfigureLiveVideoUplinkStreamL( 

        	CMccVideoSource& aDataSource,

            CPayloadFormatWrite& aFormatter,

            const TMccCodecInfo& aCodec,

            MDataSink* aAssociatedSink,

            CMccRtpMediaClock& aClock );

        /**

        * Configures the uplink AMR codec

        * @since Series 60 3.0

        * @param [input] aPlaybackDev MMF Audio datasink

         * @param [input] aCodec Codec info

        * @return void

        */

        static void DoConfigureAmrL( MMMFAudioOutput& aPlaybackDev, 

                                     const TMccCodecInfo&  );

        /**

        * Configures the downlink AMR codec

        * @since Series 60 3.0

        * @param [input] aRecordDev MMF Audio datasource

        * @param [input] aCodec Codec info

        * @return void

        */

        static void DoConfigureAmrL( MMMFAudioInput& aRecordDev,  

                                     const TMccCodecInfo& aCodec );

        /**

        * Configures the uplink G.711 codec

        * @since Series 60 3.0

        * @param [input] aDatasink MMF Audio datasink

        * @param [input] aCodec Codec parameters

        * @param aCodecState

        * @return void

        */

        static void DoConfigureG711L( MMMFAudioOutput& aPlaybackDev, 

            const TMccCodecInfo& aCodec,

            CMccSymStreamBase::TCodecState aCodecState );

        /**

        * Configures the downlink G.711 codec

        * @since Series 60 3.0

        * @param [input] aDatasource MMF Audio datasource

        * @param [input] aCodec Codec parameters

        * @param aCodecState

        * @return void

        */

        static void DoConfigureG711L( MMMFAudioInput& aRecordDev,

            const TMccCodecInfo& aCodec,

            CMccSymStreamBase::TCodecState aCodecState );

         /**

        * Configures the uplink G.729 codec

        * @since Series 60 3.0

        * @param aDatasink MMF Audio datasink

        * @param aBitrate Bitrate for the codec

        * @return void

        */

        static void DoConfigureG729( MMMFAudioOutput& aPlaybackDev );

        /**

        * Configures the downlink G.729 codec

        * @since Series 60 3.0

        * @param [input] aDatasource    MMF Audio datasource

        * @param [input] aEnableCng     Is comfort noise generation activated

        * @return void

        */

        static void DoConfigureG729L( MMMFAudioInput& aRecordDev,

                                      TBool aEnableCng );

        /**

        * Configures the uplink iLBC codec

        * @since Series 60 3.0

        * @param aDatasink MMF Audio datasink

        * @param aCodec Codec parameters

        * @param aCodecState

        * @return void

        */

        static void DoConfigureIlbcL( MMMFAudioOutput& aPlaybackDev, 

                const TMccCodecInfo& aCodec,

                CMccSymStreamBase::TCodecState aCodecState );

        /**

        * Configures the downlink iLBC codec

        * @since Series 60 3.0

        * @param aDatasource MMF Audio datasource

        * @param aCodec Codec parameters

        * @param aCodecState

        * @return void

        */

        static void DoConfigureIlbcL( MMMFAudioInput& aRecordDev, 

                const TMccCodecInfo& aCodec,

                CMccSymStreamBase::TCodecState aCodecState );

        /**

        * Configures the camera source

        * @since Series 60 3.0

        * @param [input] aVideoSource source to be configured

        * @param [input] aCodec Codec parameters

        * @return void

        */

        static void DoConfigureCameraL( CMccVideoSource& aVideoSource, 

                const TMccCodecInfo& aCodec );

        /**

        * Configures the file sink

        * @since Series 60 3.0

        * @param [input] aFileSink sink to be configured

        * @param [input] aCodec Codec parameters

        * @return void

        */

        static void DoConfigureFileSinkL( CMccFileSink& aFileSink, 

                const TMccCodecInfo& aCodec );

        /**

        * Configures a DTMF mediaformat.

        *

        * @since   S60 3.0

        * @param   aPayloadDecoder     Decoder for DTMF payload

        * @param   aCodec              Mediaformat parameters

        * @return  void

        */

        static void DoConfigureDtmfFormatL(

        	CPayloadFormatRead& aPayloadDecoder,

            const TMccCodecInfo& aCodec );

        /**

        * Configures a DTMF mediaformat.

        *

        * @since   S60 3.0

        * @param   aPayloadEncoder     Encoder for DTMF payload

        * @param   aCodec              Mediaformat parameters

        * @param   aClock              Mediaclock for timestamp synchronization

        * @return  void

        */

        static void DoConfigureDtmfFormatL(

            CPayloadFormatWrite& aPayloadEncoder,

            const TMccCodecInfo& aCodec,

            CMccRtpMediaClock& aClock );

        /**

        * Gets configures of the camera source

        */

		static void DoGetCameraConfigurationL( const TMccCodecInfo& aCodec, 

		                                       const TDesC8& aParam );

		/**

        * Gets settings of the clip source

        */                                    

	    static void DoGetClipConfigurationL( TDes8& aParam );

        /**

        * Converts a "boolean" setting parameter to a real Symbian style

        * boolean.

        * @since Series 60 3.0

        * @param aParam     Boolean parameter to convert

        * @return TBool     Converted parameter

        */

        static TBool ConvertBoolean( TBool aParam );

	    /**

	    * Checks whether bitrate is supported

	    */ 

	    static TBool IsSupportedAmrNbBitrate( TInt aBitrate );

	    /**

	    * Checks whether bitrate is supported

	    */ 

	    static TBool IsSupportedAmrWbBitrate( TInt aBitrate );

	    static void PassPrerollFromSinkToSourceL(MDataSink* aDataSink,  MDataSource* aDataSource);

    private:    // Friend classes

        #if defined( TEST_EUNIT )

        friend class UT_CMccCodecConfigurator;

        #endif

    };

#endif      // MCCCODECCONFIGURATOR_H

// End of File