/*

* 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:    Convertion methods for RTP file format.*

*/

#ifndef CRTPUTIL_H

#define CRTPUTIL_H

// INCLUDES

#include <e32base.h>

#include <etelmm.h>

// CONSTANTS

const TInt KSiKilo( 1000 );

const TInt KIntegerBytes( 4 );

const TInt KPacketSizeBytePoint( 0 );

const TInt KPacketSizeBytesLen( 4 );

const TInt KPacketTypeBytesLen( 1 );

const TInt KSpecialPacketLength( KPacketSizeBytesLen + KPacketTypeBytesLen + KIntegerBytes );

const TInt KPacketTypeBytePoint( KPacketSizeBytePoint + KPacketSizeBytesLen );

const TInt KUserIdLength( RMobilePhone::KIMSISize );

const TInt KDeviceIdLength( RMobilePhone::KPhoneSerialNumberSize );

_LIT8( KRtpClipMimetype, "application/x-nokia-teh-rtp" );

_LIT( KDvrTimeShiftFile, "c:\\timeshift." );

// MACROS

// None

// DATA TYPES

// None

// FORWARD DECLARATIONS

// None

// CLASS DECLARATION

/**

*  RTP format common functionalities for Common Recording Engine.

*

*  @lib CommonRecordingEngine.lib

*  @since Series 60 3.0

*/

class CRtpUtil : public CBase

    {

public: // Constructors and destructor

    /**

    * Two-phased constructor.

    */

    IMPORT_C static CRtpUtil* NewL();

    /**

    * Two-phased constructor.

    */

    IMPORT_C static CRtpUtil* NewLC();

    /**

    * Destructor.

    */

    IMPORT_C virtual ~CRtpUtil();

public: // New functions

    /**

    * Converts integer to a buffer.

    * @since Series 60 3.0

    * @param aValue a value to write.

    * @return a buffer where value stored.

    */

    IMPORT_C static HBufC8* MakeBytesLC( const TInt& aValue );

    /**

    * Converts integer to a buffer.

    * @since Series 60 3.0

    * @param aValue a value to write.

    * @param aBuf a buffer where value stored.

    * @return none.

    */

    IMPORT_C static void MakeBytesL( const TInt& aValue,

                                     TDes8& aBuf );

    /**

    * Converts integer to a buffer.

    * @since Series 60 3.0

    * @param aValue a value to write.

    * @param aBuf a buffer where value stored.

    * @return a system wide error code.

    */

    IMPORT_C static TInt MakeBytes( const TInt& aValue,

                                    TDes8& aBuf );

    /**

    * Converts bytes to integer.

    * @since Series 60 3.0

    * @param aBytes a buffer to convert.

    * @return an integer converted from bytes.

    */

    IMPORT_C static TInt GetValueL( const TDesC8& aBytes );

    /**

    * Converts bytes to integer.

    * @since Series 60 3.0

    * @param aBytes a buffer to convert.

    * @param aValue a integer converted from bytes.

    * @return none.

    */

    IMPORT_C static void GetValueL( const TDesC8& aBytes,

                                    TInt& aValue );

    /**

    * Converts bytes to integer.

    * @since Series 60 3.0

    * @param aBytes a buffer to convert.

    * @param aValue a integer converted from bytes.

    * @return a system wide error code.

    */

    IMPORT_C static TInt GetValue( const TDesC8& aBytes,

                                   TInt& aValue );

    /**

    * Converts bytes to integer.

    * @since Series 60 3.0

    * @param aBytes a buffer to convert.

    * @param aValue a integer converted from bytes.

    * @return a system wide error code.

    */

    IMPORT_C static TInt GetValue( const TDesC8& aBytes,

                                   TUint& aValue );

    /**

    * Generates special RTP packet.

    * @since Series 60 3.0

    * @param aType a type of RTP packet.

    * @return a buffer containing generated RTP packet.

    */

    IMPORT_C static HBufC8* SpecialPacketL( const TInt aType );

    /**

    * Getter for RTP clip mime type info.

    * @since Series 60 3.0

    * @param aBuf on return contains the mime type.

    * @return None.

    */

    IMPORT_C static void GetMimeInfo( TDes& aMime );

    /**

    * Getter for RTP clip mime type info.

    * @since Series 60 3.0

    * @param aBuf on return contains the mime type.

    * @return None.

    */

    IMPORT_C static void GetMimeInfo( TDes8& aMime );

    /**

    * Reads IMEI of the phone HW.

    * @since Series 60 3.0

    * @param aBuf on return contains the IMEI.

    * @return none.

    */

    IMPORT_C static void GetImeiL( TDes& aImsi );

private: // Constructors and destructor

    /**

    * C++ default constructor.

    */

    CRtpUtil();

    /**

    * Symbian 2nd phase constructor can leave and is private by default.

    */

    void ConstructL();

private: // New methods

    /**

    * Reads mobile info of the phone.

    * @since Series 60 3.0

    * @param none.

    * @return none.

    */

    void static GetMobilePhoneInfoL( RTelServer& aServer,

                                     RMobilePhone& aPhone );

  };

#endif // CRTPUTIL_H

// End of File