// Copyright (c) 2002-2009 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:

//

#ifndef __MMFCLIENTAUDIOCONVERTER_H

#define __MMFCLIENTAUDIOCONVERTER_H

#include <e32std.h>

#include <e32base.h>

#include <mdaaudiosampleeditor.h>

#include <mmf/server/mmffile.h>

#include <mmf/server/mmfdes.h>

#include <mmf/server/mmfurl.h>

#include <mmf/common/mmfcontroller.h>

#include "mmfclientutility.h"

/**

Concrete implementation of the CMdaAudioConvertUtility API.

@see CMdaAudioConvertUtility

*/

class CMMFMdaAudioConvertUtility;

NONSHARABLE_CLASS( CMMFMdaAudioConvertUtility ): public CBase,

								   				 public MMMFControllerEventMonitorObserver,

								   				 public MMMFFindAndOpenControllerObserver

	{

friend class CMdaAudioConvertUtility;

// for testing only

friend class CTestStepUnitMMFAudClient;

public:

	~CMMFMdaAudioConvertUtility();

	void OpenL(const TDesC& aPrimaryFile, const TDesC& aSecondaryFile);

	// Open existing file and new/existing secondary

	void OpenL(const TDesC& aPrimaryFile,

			   TMdaClipLocation* aLocation,	// Normally file or descriptor

			   TMdaClipFormat* aFormat,		// Data format

			   TMdaPackage* aArg1 = NULL,	// Normally codec to use

			   TMdaPackage* aArg2 = NULL);	// Normally audio settings

	void OpenL(TMdaClipLocation* aPriLocation, 

			   TMdaClipLocation* aSecLocation, 

			   TMdaClipFormat* aPriFormat, 

			   TMdaClipFormat* aSecFormat, 

			   TMdaPackage* aPriArg1 = NULL, // Normally source codec to use

			   TMdaPackage* aPriArg2 = NULL, // Normally source audio settings

			   TMdaPackage* aSecArg1 = NULL, // Normally sink codec to use

			   TMdaPackage* aSecArg2 = NULL);// Normally sink audio settings

	// new controller based open

	void OpenL(TMdaClipLocation* aPriLocation, 

			   TMdaClipLocation* aSecLocation, 

			   TUid aControllerUid, // the controller to use

			   TUid aDestFormatUid,

			   TFourCC aDestDataType);	

	//from MMMFControllerEventMonitorObserver

	void HandleEvent(const TMMFEvent& aEvent);

	// from MMMFFindAndOpenControllerObserver 

	virtual void MfaocComplete(

		TInt& aError, 

		RMMFController* aController, 

		TUid aControllerUid, 

		TMMFMessageDestination* aSourceHandle, 

		TMMFMessageDestination* aSinkHandle);

	void UseSharedHeap();

protected:

	CMMFMdaAudioConvertUtility(CMdaAudioConvertUtility* aParent, MMdaObjectStateChangeObserver& aCallback);

	void ConstructL(TInt aPriority, TInt aPref);

private:

	CMdaAudioClipUtility::TState State();

	void Close();

	void PlayL();		// N.B. ConvertL should be used in preference to PlayL

	void RecordL();		// N.B. ConvertL should be used in preference to RecordL

	void ConvertL();

	void Stop();

	void CropL(TBool aCropToEnd = ETrue);

	void SetPosition(const TTimeIntervalMicroSeconds& aPosition);

	const TTimeIntervalMicroSeconds& Position();

	const TTimeIntervalMicroSeconds& RecordTimeAvailable();

	const TTimeIntervalMicroSeconds& Duration();

	void SetPlayWindow(const TTimeIntervalMicroSeconds& aStart, const TTimeIntervalMicroSeconds& aEnd);

	void ClearPlayWindow();

	void SetRepeats(TInt aRepeatNumberOfTimes, const TTimeIntervalMicroSeconds& aTrailingSilence);

	void SetMaxWriteLength(TInt aMaxWriteLength /*= KMdaClipLocationMaxWriteLengthNone*/);

	void SetPriority(TInt aPriority, TInt aPref);  

	void CropL(const TTimeIntervalMicroSeconds & aCropBegin, 

			   const TTimeIntervalMicroSeconds & aCropEnd);

	// Codec support

	void GetSupportedDestinationDataTypesL(RArray<TFourCC>& aSupportedDestinationDataTypes);

	void SetSourceDataTypeL(TFourCC aDataType)	;

	void SetDestinationDataTypeL(TFourCC aCodec);

	TFourCC DestinationDataTypeL();

	TFourCC SourceDataTypeL();

	// Bit rate support	

	void SetDestinationBitRateL(TUint aBitRate);

	TUint DestinationBitRateL();

	void GetSupportedConversionBitRatesL(RArray<TUint>& aSupportedBitRates);

	TUint SourceBitRateL();

	// Sample rate support

	void SetSourceSampleRateL(TUint aSampleRate);

	void SetDestinationSampleRateL(TUint aSampleRate);

	TUint DestinationSampleRateL();

	void GetSupportedConversionSampleRatesL(RArray<TUint>& aSupportedSampleRates);

	TUint SourceSampleRateL();

	// Format support

	void SetSourceFormatL(TUid aRecordFormat);

	void SetDestinationFormatL(TUid aFormatUid);

	TUid DestinationFormatL();

	TUid SourceFormatL();

	// Number of channels

	void SetSourceNumberOfChannelsL(TUint aNumberOfChannels);

	void SetDestinationNumberOfChannelsL(TUint aNumberOfChannels);

	TUint DestinationNumberOfChannelsL();

	void GetSupportedConversionNumberOfChannelsL(RArray<TUint>& aSupportedNumChannels);

	TUint SourceNumberOfChannelsL();

	const CMMFControllerImplementationInformation& ControllerImplementationInformationL();

	TInt CustomCommandSync(const TMMFMessageDestinationPckg& aDestination, TInt aFunction, const TDesC8& aDataTo1, const TDesC8& aDataTo2, TDes8& aDataFrom);

	TInt CustomCommandSync(const TMMFMessageDestinationPckg& aDestination, TInt aFunction, const TDesC8& aDataTo1, const TDesC8& aDataTo2);

	void CustomCommandAsync(const TMMFMessageDestinationPckg& aDestination, TInt aFunction, const TDesC8& aDataTo1, const TDesC8& aDataTo2, TDes8& aDataFrom, TRequestStatus& aStatus);

	void CustomCommandAsync(const TMMFMessageDestinationPckg& aDestination, TInt aFunction, const TDesC8& aDataTo1, const TDesC8& aDataTo2, TRequestStatus& aStatus);

	CMdaAudioConvertUtility* Parent() const;

	void Reset();

	TInt ControllerOpen();

	void ConfigureSourceSinkL(TMdaClipLocation* aPriLocation, TMdaClipLocation* aSecLocation);

	TInt SetThreadPriority(const TThreadPriority& aThreadPriority) const;

private:

	MMdaObjectStateChangeObserver& iCallback;

	CMMFMdaObjectStateChangeObserverCallback* iAsyncCallback;

	RMMFController iController;

	CMMFControllerEventMonitor* iControllerEventMonitor;

	// Source and sink handle info

	TMMFMessageDestination iSourceHandle;

	TMMFMessageDestination iSinkHandle;

	// Custom commands

	RMMFAudioControllerCustomCommands iAudioControllerCustomCommands;

	RMMFAudioPlayControllerCustomCommands iAudioPlayControllerCustomCommands;

	RMMFAudioRecordControllerCustomCommands iAudioRecordControllerCustomCommands;

	TMMFPrioritySettings iPrioritySettings;

	TTimeIntervalMicroSeconds iPosition;

	TTimeIntervalMicroSeconds iPositionTemp;

	TTimeIntervalMicroSeconds iDuration;

	TTimeIntervalMicroSeconds iRecordTimeAvailable;

	CMdaAudioClipUtility::TState iState;

	// Convert window start and end times and whether it has been set

	TTimeIntervalMicroSeconds iConvertStart;

	TTimeIntervalMicroSeconds iConvertEnd;

	TBool iConvertWindowSet;

	// parent class for callback

	CMdaAudioConvertUtility* iParent;

	RArray<TUid> iMediaIds;

	// keeping track of cropped clip duration

	TBool iHasCropped;

	TTimeIntervalMicroSeconds iCroppedDuration;

	CMMFControllerImplementationInformation* iControllerImplementationInformation;

	TUid iControllerUid;

	// utility class to find and open a suitable controller asynchronously

	CMMFFindAndOpenController* iFindAndOpenController;

	TUid iSourceFormatUid;		// for SetSourceFormat()

	TUid iSinkFormatUid;		// for SetSinkFormat()

	TFourCC iSourceDataType;	// for SetSourceDataType()

	TFourCC iSinkDataType;		// for SetSinkDataType()

	TInt iSourceSampleRate;		// for SetSourceSampleRateL()

	TInt iSinkSampleRate;		// for SetDestinationSampleRateL()

	TInt iSourceChannels;		// for SetSourceNumberOfChannelsL()

	TInt iSinkChannels;			// for SetDestinationNumberOfChannelsL()

	};

#endif