/*

* 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 the License "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 to provide TS conversion for an RTP-stream based on*

*/

#ifndef CRTPTSCONVERTER_H

#define CRTPTSCONVERTER_H

//  INCLUDES

#include <RtpHeader.h>

// CONSTANTS

const TUint KPipelineClockRate( 1000 );

// MACROS

// None

// DATA TYPES

// None

// FORWARD DECLARATIONS

// None

// CLASS DECLARATION

/**

*  Class for converting RTP-timestamps.

*

*  @lib CommonRecordingEngine.lib

*  @since Series 60 3.0

*/

class CRtpTsConverter : public CBase

    {

public: // Constructors and destructor

    /**

    * Two-phased constructor.

    * @param aClockRate the clockrate for the media stream.

    */

    IMPORT_C static CRtpTsConverter* NewL( const TUint aClockRate );

    /**

    * Destructor.

    */

    IMPORT_C virtual ~CRtpTsConverter();

public: // New functions

    /**

    * Initialize timestamp converter

    * @since Series 60 3.0

    * @param aRtcpPkt a RTCP packet for the media stream to be sychronized.

    * @return none.

    */

    IMPORT_C void Init( const TDesC8& aRtcpPkt );

    /**

    * Initialize timestamp converter

    * @since Series 60 3.0

    * @param aTs intial value of RTP timestamp

    * @return none.

    */

    IMPORT_C void Init( const TUint& aTs );

    /**

    * Gets status on initialization.

    * @since Series 60 3.0

    * @param none.

    * @return true if converter initialized, otherwise false.

    */

    IMPORT_C TBool Initiated();

    /**

    * Uninitializes the converter.

    * @since Series 60 3.0

    * @param none.

    * @return none.

    */

    IMPORT_C void UnInitiate();

    /**

    * Gets time stamp from a RTP packet.

    * @since Series 60 3.0

    * @param aTimestamp a RTP packet's TS to convert.

    * @param aUseWallClock if true converts to wall clock time.

    * @return a time stamp value.

    */

    IMPORT_C TUint ConvertTs( const TUint aTimestamp,

                              const TBool aUseWallClock = EFalse );

private: // Constructors and destructor

    /**

    * By default Symbian 2nd phase constructor is private.

    */

    void ConstructL();

    /**

    * C++ default constructor.

    * @param aClockRate the clockrate for the media stream.

    */

    CRtpTsConverter( const TUint aClockRate );

private: // New functions

    /**

    * Calculate the offset for adjusting the RTP timestamps.

    * @since Series 60 3.0

    * @param aRtpTime a RTP time stamp.

    * @param aSeekTime a wall clock time.

    * @param clockRate a wall clock time.

    * @return a offset for RTP TS adjustment.

    */

    TUint ComputeOffset( const TUint aRtpTime,

                         const TUint aSeekTime,

                         const TInt clockRate );

private: // Data

    /**

    * Clockrate.

    */

    const TUint iClockRate;

    /**

    * Offset.

    */

    TUint iOffset;

    /**

    * Initiated.

    */

    TBool iInitiated;

    };

#endif // CRTPTSCONVERTER_H

// End of File