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

 // ToneGenerator.h

 // 

 //

 #ifndef __TONEGENERATOR_H__

 #define __TONEGENERATOR_H__

 #include <e32base.h>

 //

 // Sine tone generator

 // 

 const TInt KMaxSineTable = 256;

 const TUint KToneBufferSize = 8192;

 // one second in microseconds

 const TInt KOneMillionMicroSeconds = 1000000;

 class TSineGen

 /**

 *@internalTechnology

 */

 	{

 public:

 	void SetFrequency(TInt aFrequency,TInt aAmplitude);

 	TInt NextSample();

 private:

 	TUint iPosition;

 	TUint iStep;

 	TInt iAmplitude;

 	static const TInt16 SineTable[KMaxSineTable];

 	static const TInt16 IncTable[KMaxSineTable];

 	};

 class TSineWave

 /**

 *@internalTechnology

 */

 	{

 public:

 	void Generate(TInt16* aDest,TInt aCount);

 	void SetFrequency(TInt aFrequency,TInt aAmplitude);

 	void SetFrequency(TInt aFrequency1,TInt aAmplitude1,TInt aFrequency2,TInt aAmplitude2);

 private:

 	TSineGen iGen1;

 	TSineGen iGen2;

 	};

 //

 // Tone synthesis interface

 // Defines the abstract interface for tone synthesis

 // Capable of filling buffers with audio data

 //

 class MMdaToneSynthesis

 /**

 *@internalTechnology

 */

 	{

 public:

 	// Allocate necessary resources for this kind of synthesis

 	virtual void Configure(TInt aRate, TInt aChannels, TInt aRepeats, TInt aSilence, TInt aRampUp)=0;

 	// Begin generating data from start again

 	virtual void Reset()=0;

 	// Fill supplied buffer with next block of 16bit PCM audio data

 	virtual TInt FillBuffer(TDes8& aBuffer)=0;

 	};

 //

 // Tone generator base class

 //

 class TMdaToneGenerator : public MMdaToneSynthesis

 	{

 public:

 	virtual void Configure(TInt aRate, TInt aChannels, TInt aRepeats, TInt aSilence, TInt aRampUp);

 	virtual TInt FillBuffer(TDes8& aBuffer);

 protected:

 	virtual TInt GetNextTone()=0;

 	//

 	TInt DurationToSamples(const TTimeIntervalMicroSeconds& aDuration);

 protected:

 	TSineWave iSineWave;

 	TInt iRate;

 	TInt iChannels;

 	TInt iSamplesLeft;

 	TInt iTrailingSilence;

 	TBool iRampUp;

 	TBool iRampDown;

 	TInt iRepeats;

 	TInt iSilenceBetweenRepeats;

 	TBool iAfterRepeatSilence;

 	TInt iRampUpCount;

 	TInt iRampUpLeft;

 	};

 //

 // Simple tone synthesis

 //

 class TMdaSimpleToneGenerator : public TMdaToneGenerator

 /**

 *@internalTechnology

 */

 	{

 public:

 	void SetFrequencyAndDuration(TInt aFrequency, const TTimeIntervalMicroSeconds& aDuration);

 	virtual void Reset();

 	virtual TInt GetNextTone();

 private:

 	TTimeIntervalMicroSeconds iDuration;

 	TInt iFrequency;

 	TBool iPlayed;

 	};

 /**

  * Dual tone synthesis

  * Generates a tone consisting of two sine waves of different 

  * frequencies summed together.

  * 

  * @internalTechnology

  */

 class TMdaDualToneGenerator : public TMdaToneGenerator

 	{

 public:

 	void SetFrequencyAndDuration(TInt aFrequencyOne, TInt aFrequencyTwo, const TTimeIntervalMicroSeconds& aDuration);

 	virtual void Reset();

 	virtual TInt GetNextTone();

 private:

 	TTimeIntervalMicroSeconds iDuration;

 	TInt iFrequencyOne;

 	TInt iFrequencyTwo;

 	TBool iPlayed;

 	};

 //

 // DTMF tone synthesis

 //

 class TMdaDTMFGenerator : public TMdaToneGenerator

 /**

 *@internalTechnology

 */

 	{

 public:

 	virtual void Reset();

 	void SetToneDurations(	const TTimeIntervalMicroSeconds32 aOn,

 							const TTimeIntervalMicroSeconds32 aOff,

 							const TTimeIntervalMicroSeconds32 aPause);

 	void SetString(const TDesC& aDTMFString); 

 private:

 	virtual TInt GetNextTone();

 private:

 	const TDesC* iDTMFString;

 	TTimeIntervalMicroSeconds32 iOn;

 	TTimeIntervalMicroSeconds32 iOff;

 	TTimeIntervalMicroSeconds32 iPause;

 	TInt iOnSamples;

 	TInt iOffSamples;

 	TInt iPauseSamples;

 	TInt iChar;

 	TBool iPlayToneOff;

 	};

 //

 // Tone sequence synthesis

 //

 const TInt KMaxSequenceStack = 6;

 class TMdaSequenceGenerator : public TMdaToneGenerator

 /**

 *@internalTechnology

 */

 	{

 public:

 	virtual void Reset();

 	void SetSequenceData(const TDesC8& aSequenceData); 

 private:

 	virtual TInt GetNextTone();

 private:

 	const TDesC8* iSequenceData;

 	const TInt16* iInstructionPtr;

 	const TInt16* iLastInstruction;

 	TInt iStack[KMaxSequenceStack];

 	TInt iStackIndex;

 	};

 const TInt KBufferLength = 0x1000;

 // Public Media Server includes

 class TMdaPtr8 : public TPtr8 //needed for this WINS Impl of Tone Gen

 	{

 public:

 	TMdaPtr8()

 		: TPtr8(0,0,0) {};

 	inline void Set(const TDes8& aDes)

 		{ TPtr8::Set((TUint8*)(aDes.Ptr()),aDes.Length(),aDes.MaxLength()); };

 	inline void SetLengthOnly(const TDes8& aDes)

 		{ TPtr8::Set((TUint8*)(aDes.Ptr()),aDes.Length(),aDes.Length()); };

 	inline void Set(const TPtrC8& aDes)

 		{ TPtr8::Set((TUint8*)(aDes.Ptr()),aDes.Length(),aDes.Length()); };

 	inline void Shift(TInt aOffset)

 		{ SetLength(Length()-aOffset); iMaxLength-=aOffset; iPtr+=aOffset; };

 	};

 #endif