/*

* Copyright (c) 2006-2009 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:    .rtp to .3gp file converter*

*/

#ifndef CIPTVRTPTO3GPCONVERTER_H

#define CIPTVRTPTO3GPCONVERTER_H

#include <e32base.h>

class RFs;

class MIptvRtpTo3gpObserver;

/**

 * .rtp to .3gp file converter

 *

 * @lib   IptvUtil.lib

 * @since Video Center 1.0

 */

class CIptvRtpTo3gpConverter : public CBase

    {

public: // Public constructors and destructors

    /**

     * Two-phased constructor

     *

     * @param aFs

     * @param aObserver  Observer to receive conversion notifications

     * @param aPriority

     */

    static CIptvRtpTo3gpConverter* NewL( RFs& aFs, MIptvRtpTo3gpObserver& aObserver, TInt aPriority );

    /**

     * C++ destructor

     */

    virtual ~CIptvRtpTo3gpConverter();

private: // private constructors

    /**

     * C++ default constructor

     *

     * @param aFs

     * @param aObserver

     */

    CIptvRtpTo3gpConverter( RFs& aFs, MIptvRtpTo3gpObserver& aObserver );

    /**

     * 2nd phase constructor

     *

     * @param aPriority

     */

    void ConstructL( TInt aPriority );

public: // public user API

    /**

     * Requests conversion generation

     *  

     * Conversion completation and failures are notified by the registered observer

     *  

     * @param aSrcRtpFilename  Filename for source .rtp clip

     * @param aDst3gpFilename  Filename for destination .3gp clip

     */

    void ConvertL( const TDesC& aSrcRtpFilename, const TDesC& aDst3gpFilename );

    /**

     * Cancels ongoing file conversion

     */

    void CancelConverstion();

private: // implementation, own methods

    /**

     * Actual cleanup for internal data/state

     *

     * @param aStatus status for conversion operation. If different than KErrNone, output

     *                file is removed

     */

    void DoCleanup( TInt aStatus );

    /**

     * Launches idle cleanup and notification

     *

     * @param aStatus convertion status, passed to DoCleanup

     */

    void DoIdleCleanupAndNotify( TInt aStatus );

    /**

     * Callback to cleanup up and notify

     *

     * @param aSelf wrapped 'this' pointer

     */

    static TInt CleanupAndNotifyCallback( TAny* aSelf );

private: // implementation, own data

    /**

     * Reference to file system server.

     */

    RFs& iFs;

    /**

     * Conversion observer

     */

    MIptvRtpTo3gpObserver& iObserver;

    /** 

     * Cache for 3gp file name

     * Own.

     */

    HBufC* i3gpFilename;

    /**

     * Idle callback cleanup and notify

     * Own.

     */

    CIdle* iIdle;

    /**

     * Status for converstion, passed through idle cleanup

     */

    TInt iIdleStatus;

    /**

     * Signals that a first keyframe has been written to file

     */

    TBool iKeyframeWritten;

    };

#endif // CIPTVRTPTO3GPCONVERTER_H