--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/devsound/a3facf/inc/tonedata.h	Tue Feb 02 01:56:55 2010 +0200
@@ -0,0 +1,269 @@
+// 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 "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:
+//
+
+
+
+/**
+ @file
+ @publishedPartner 
+ @released
+*/
+
+#ifndef TTONEDATA_H
+#define TTONEDATA_H
+
+#include <e32base.h>
+
+const TInt KMdaInfiniteDurationDTMFToneOnLength = -1;
+
+/*
+ *  Includes information about tone type, data, length.
+ *  @lib ttonedata.lib
+ */
+class TToneData
+{
+public:
+
+enum TToneType
+	{
+	/* Simple Tone */    
+	ESimple = 0,
+	/* Dual Tone */
+	EDual = 1,
+	/* TMF String Tone */
+	EDtmfString = 2,
+	/* Sequence */
+	ESequence = 3,
+	/* Fixed Sequence*/
+	EFixedSequence = 4 
+	};
+
+
+	IMPORT_C TToneData();
+
+	/*
+	 * Sets type of the tone. (Simple, Dual, Sequence etc.)
+	 * 
+	 * @param aType Type of the tone.
+	 */
+	IMPORT_C void SetType(TToneType aType);
+
+	/*
+	 * Sets tone duration in micro seconds.
+	 * 
+	 * @param aDuration Tone duration in microseconds.
+	 */
+	IMPORT_C void SetDuration(TTimeIntervalMicroSeconds aDuration);
+
+	/*
+	 * Sets tone one freqyency.
+	 *
+	 * @param aFrequencyOne Frequency of the tone one.
+	 */
+	IMPORT_C void SetFrequencyOne(TInt aFrequencyOne);
+
+	/*
+	 * Sets tone two freqyency.
+	 *
+	 * @param aFrequencyOne Frequency of the tone two.
+	 */
+	IMPORT_C void SetFrequencyTwo(TInt aFrequencyTwo);
+
+	/*
+	 * Sets tone sequence number.
+	 *
+	 * @param aSequenceNumber Number of the sequence.
+	 */
+	IMPORT_C void SetSequenceNumber(TInt aSequenceNumber);
+
+	/*
+	 * Sets tone sequence data.
+	 *
+	 * @param aSequenceData Reference of the sequence data.
+	 */
+	IMPORT_C void SetSequenceData(TDesC8& aSequenceData);
+
+	/*
+	 * Sets tone repeat count, if count is KMdaRepeatForever, tone will be repeated indefinitely.
+	 *
+	 * @param aRepeatCount Repeat count of the tone.
+	 */
+	IMPORT_C void SetRepeatCount(TInt aRepeatCount);
+
+	/*
+	 * Sets tone trailing silence. 
+	 * 
+	 * @param aRepeatTrailingSilence An interval of silence which will be played after each tone. 
+	 */
+	IMPORT_C void SetRepeatTrailingSilence(TTimeIntervalMicroSeconds aRepeatTrailingSilence);
+
+	/*
+	 * Defines the duration of tone on, tone off and tone pause to be used during the DTMF tone playback operation.
+	 *
+	 * @param aToneOnLength The period over which the tone will be played. If this is set to zero, then the tone is not played.
+	 * @param aToneOffLength The period over which the no tone will be played.
+	 * @param aPauseLength The period over which the tone playing will be paused.
+	 */
+	IMPORT_C void SetDtmfLengths(TTimeIntervalMicroSeconds32 aToneOnLength, TTimeIntervalMicroSeconds32 aToneOffLength, TTimeIntervalMicroSeconds32 aPauseLength);
+
+	/*
+	 * Sets tone DTMF string.
+	 *
+	 * @param aDTMFString Reference of the DTMF string.
+	 */
+	IMPORT_C void SetDTMFString(TDesC& aDTMFString);
+
+	/*
+	 * Gets tone type. (Simple, Dual, Sequence etc.)
+	 *
+	 * @param aType Type of the tone.
+	 */
+	IMPORT_C void GetType(TToneType& aType);
+	
+	/*
+	 * Gets tone duration in micro seconds.
+	 *
+	 * @param aDuration Tone duration in microseconds.
+	 */
+	IMPORT_C void GetDuration(TTimeIntervalMicroSeconds& aDuration);
+
+	/*
+	 * Gets frequency of the tone one.
+	 *
+	 * @return Frequency of the tone one.
+	 */
+	IMPORT_C TInt GetFrequencyOne();
+	
+	/*
+	 * Gets frequency of the tone two.
+	 *
+	 * @return Frequency of the tone two.
+	 */
+	IMPORT_C TInt GetFrequencyTwo();
+	
+	/*
+	 * Gets sequence number.
+	 *
+	 * @return Sequence number.
+	 */
+	IMPORT_C TInt GetSequenceNumber();
+		  
+	/*
+	 * Gets sequence data of the tone.
+	 * Client should not delete this pointer.
+	 *
+	 * @return Pointer to tone sequence data.
+	 */
+	IMPORT_C TDesC8* GetSequenceData();
+			
+	/*
+	 * Gets tone repeat count.
+	 *
+	 * @return Repeat count.
+	 */
+	IMPORT_C TInt GetRepeatCount();
+	
+	/*
+	 * Gets tone trailing silence duration.
+	 *
+	 * @param aRepeatTrailingSilence Trailing silence duration.
+	 */
+	IMPORT_C void GetRepeatTrailingSilence(TTimeIntervalMicroSeconds& aRepeatTrailingSilence);
+			   
+	/*
+	 * Gets tone DTMF lengts duration.
+	 *
+	 * @param aToneOnLength The period over which the tone will be played.
+	 * @param aToneOffLength The period over which the no tone will be played.
+	 * @param aPauseLength The period over which the tone playing will be paused.
+	 */
+	IMPORT_C void GetDtmfLenghts(TTimeIntervalMicroSeconds32& aToneOnLength, TTimeIntervalMicroSeconds32& aToneOffLength, TTimeIntervalMicroSeconds32& aPauseLength);
+
+	/*
+	 * Gets DTMF string of the tone.
+	 * Client should not delete this pointer
+	 *
+	 * @return Pointer to tone DTMF string.
+	 */
+	IMPORT_C TDesC* GetDTMFString();
+
+	private: // data
+
+
+	/* Type of the tone. */
+
+	TToneType iType;
+
+	
+	/* Duration of the tone. */
+	 
+	TTimeIntervalMicroSeconds iDuration;
+
+	
+	/* Frequency of the tone one. */
+	 
+	TInt iFrequencyOne;
+
+	
+	/* Frequency of the tone two. */
+	 
+	TInt iFrequencyTwo;
+
+	
+	/* Sequence number of the tone. */
+	 
+	TInt iSequenceNumber;
+
+	
+	/* Repeat count of the tone. */
+	 
+	TInt iRepeatCount;
+
+	
+	/* Repeat traingling silence of the tone. */
+	 
+	TTimeIntervalMicroSeconds iRepeatTrainglingSilence;
+
+	
+	/* The period over which the tone will be played. */
+	 
+	TTimeIntervalMicroSeconds32 iToneOnLength;
+
+	
+	/* The period over which the no tone will be played. */
+	 
+	TTimeIntervalMicroSeconds32 iToneOffLength;
+
+	
+	/* The period over which the tone playing will be paused. */
+	 
+	TTimeIntervalMicroSeconds32 iPauseLength;
+
+	
+	/* Pointer to data of the tone sequence.
+	 * Not own.
+	 */
+	 
+	TDesC8 *iSequenceData;
+
+	
+	/* Pointer to string of the DTMF tone.
+	 * Not own.
+	 */
+	 
+	TDesC *iDTMFString;
+	};
+
+#endif // TTONEDATA_H