Dual Tone Multi-Frequency Class.
Esempio n. 1
0
        /// <summary>
        /// Get array of touch tones for given string.
        /// </summary>
        /// <param name="keys">String of touch tone characters to convert to touch tones.</param>
        /// <param name="keyDuration">Duration of touch tone key press in seconds, typically fractional.</param>
        /// <param name="interKeyPause">Time to wait between key presses in seconds, typically fractional.</param>
        /// <returns>Array of touch tones for given string.</returns>
        /// <remarks>Non-touch tone characters are ignored. Commas are interpreted as a one second pause.</remarks>
        public static DTMF[] GetTouchTones(string keys, double keyDuration, double interKeyPause)
        {
            List <DTMF> touchTones = new List <DTMF>();
            TouchTone   touchTone;
            DTMF        pause     = new DTMF(0.0D, 0.0D, interKeyPause);
            DTMF        longPause = new DTMF(0.0D, 0.0D, 1.0D);

            foreach (char key in keys)
            {
                if (key == ',')
                {
                    // Interpret commas as long pauses
                    touchTones.Add(longPause);
                }
                else if (TryParse(key, out touchTone))
                {
                    if (touchTones.Count > 0)
                    {
                        touchTones.Add(pause);
                    }

                    touchTone.Duration = keyDuration;
                    touchTones.Add(touchTone);
                }
            }

            return(touchTones.ToArray());
        }
Esempio n. 2
0
        /// <summary>
        /// Generates the specified dual-tone multi-frequencies <paramref name="repeatCount"/> times storing them in the specified <see cref="WaveFile"/>.
        /// </summary>
        /// <param name="destination"><see cref="WaveFile"/> used to store generated dual-tone multi-frequencies.</param>
        /// <param name="tones">Dual-tone multi-frequencies to generate.</param>
        /// <param name="volume">Volume of generated dual-tones as a percentage (0 to 1).</param>
        /// <param name="repeatCount">Number of times to repeat each tone.</param>
        /// <exception cref="ArgumentOutOfRangeException">Value must be expressed as a fractional percentage between zero and one.</exception>
        /// <exception cref="InvalidOperationException"><see cref="DTMF"/> only generated for <see cref="WaveFile"/> with a sample rate of 8, 16, 24, 32 or 64 bits per sample.</exception>
        public static void Generate(WaveFile destination, DTMF[] tones, double volume, int repeatCount)
        {
            if (volume < 0.0D || volume > 1.0D)
            {
                throw new ArgumentOutOfRangeException("volume", "Value must be expressed as a fractional percentage between zero and one");
            }

            double amplitude = destination.AmplitudeScalar * volume;

            // Iterate through each repeat count
            for (int x = 0; x < repeatCount; x++)
            {
                // Interate through each tone
                foreach (DTMF tone in tones)
                {
                    // Iterate through each sample for total DTMF duration
                    for (long y = 0; y < tone.Duration * destination.SampleRate; y++)
                    {
                        // Compute frequencies of DTMF at given time and add to wave file
                        destination.AddSample(DTMF.ComputeFrequencies(tone, y, destination.SampleRate) * amplitude);
                    }
                }
            }
        }
Esempio n. 3
0
File: DTMF.cs Progetto: rmc00/gsf
        /// <summary>
        /// Generates the specified dual-tone multi-frequencies <paramref name="repeatCount"/> times storing them in the specified <see cref="WaveFile"/>.
        /// </summary>
        /// <param name="destination"><see cref="WaveFile"/> used to store generated dual-tone multi-frequencies.</param>
        /// <param name="tones">Dual-tone multi-frequencies to generate.</param>
        /// <param name="volume">Volume of generated dual-tones as a percentage (0 to 1).</param>
        /// <param name="repeatCount">Number of times to repeat each tone.</param>
        /// <exception cref="ArgumentOutOfRangeException">Value must be expressed as a fractional percentage between zero and one.</exception>
        /// <exception cref="InvalidOperationException"><see cref="DTMF"/> only generated for <see cref="WaveFile"/> with a sample rate of 8, 16, 24, 32 or 64 bits per sample.</exception>
        public static void Generate(WaveFile destination, DTMF[] tones, double volume, int repeatCount)
        {
            if (volume < 0.0D || volume > 1.0D)
                throw new ArgumentOutOfRangeException("volume", "Value must be expressed as a fractional percentage between zero and one");

            double amplitude = destination.AmplitudeScalar * volume;

            // Iterate through each repeat count
            for (int x = 0; x < repeatCount; x++)
            {
                // Interate through each tone
                foreach (DTMF tone in tones)
                {
                    // Iterate through each sample for total DTMF duration
                    for (long y = 0; y < tone.Duration * destination.SampleRate; y++)
                    {
                        // Compute frequencies of DTMF at given time and add to wave file
                        destination.AddSample(DTMF.ComputeFrequencies(tone, y, destination.SampleRate) * amplitude);
                    }
                }
            }
        }
Esempio n. 4
0
File: DTMF.cs Progetto: rmc00/gsf
 /// <summary>
 /// Generates a single instance of each of the specified dual-tone multi-frequencies storing them in the specified <see cref="WaveFile"/>.
 /// </summary>
 /// <param name="destination"><see cref="WaveFile"/> used to store generated dual-tone multi-frequencies.</param>
 /// <param name="tones">Dual-tone multi-frequencies to generate.</param>
 /// <param name="volume">Volume of generated dual-tones as a percentage (0 to 1).</param>
 public static void Generate(WaveFile destination, DTMF[] tones, double volume)
 {
     Generate(destination, tones, volume, 1);
 }
Esempio n. 5
0
File: DTMF.cs Progetto: rmc00/gsf
 /// <summary>
 /// Generates the specified dual-tone multi-frequency <paramref name="repeatCount"/> times storing it in the specified <see cref="WaveFile"/>.
 /// </summary>
 /// <param name="destination"><see cref="WaveFile"/> used to store generated dual-tone multi-frequencies.</param>
 /// <param name="tone">Dual-tone multi-frequency to generate.</param>
 /// <param name="volume">Volume of generated dual-tones as a percentage (0 to 1).</param>
 /// <param name="repeatCount">Number of times to repeat the tone.</param>
 public static void Generate(WaveFile destination, DTMF tone, double volume, int repeatCount)
 {
     Generate(destination, new DTMF[] { tone }, volume, repeatCount);
 }
Esempio n. 6
0
File: DTMF.cs Progetto: rmc00/gsf
 /// <summary>
 /// Generates the specified dual-tone multi-frequency storing it in the specified <see cref="WaveFile"/>.
 /// </summary>
 /// <param name="destination"><see cref="WaveFile"/> used to store generated dual-tone multi-frequencies.</param>
 /// <param name="tone">Dual-tone multi-frequency to generate.</param>
 /// <param name="volume">Volume of generated dual-tones as a percentage (0 to 1).</param>
 public static void Generate(WaveFile destination, DTMF tone, double volume)
 {
     Generate(destination, new DTMF[] { tone }, volume, 1);
 }
Esempio n. 7
0
File: DTMF.cs Progetto: rmc00/gsf
        // Static Methods

        /// <summary>
        /// Computes a dual-tone multi-frequency sound for the given <see cref="DTMF"/> information and time.
        /// </summary>
        /// <param name="tone">Instance of the <see cref="DTMF"/> specifying the duration as well as the low and high frequencies of the dual-tone.</param>
        /// <param name="sampleIndex">Sample index (represents time anywhere from zero to full length of tone).</param>
        /// <param name="sampleRate">Number of samples per second.</param>
        /// <returns>The amplitude for the dual-tone at the given time.</returns>
        /// <remarks>
        /// This method computes an amplitude representing the acoustic pressure of a
        /// <see cref="DTMF"/> of the given frequency for the given time.
        /// </remarks>
        public static double ComputeFrequencies(DTMF tone, long sampleIndex, int sampleRate)
        {
            return (Timbre.PureTone(tone.LowFrequency, sampleIndex, 0, sampleRate) + Timbre.PureTone(tone.HighFrequency, sampleIndex, 0, sampleRate)) / 2;
        }
Esempio n. 8
0
 /// <summary>
 /// Generates the specified dual-tone multi-frequency <paramref name="repeatCount"/> times storing it in the specified <see cref="WaveFile"/>.
 /// </summary>
 /// <param name="destination"><see cref="WaveFile"/> used to store generated dual-tone multi-frequencies.</param>
 /// <param name="tone">Dual-tone multi-frequency to generate.</param>
 /// <param name="volume">Volume of generated dual-tones as a percentage (0 to 1).</param>
 /// <param name="repeatCount">Number of times to repeat the tone.</param>
 public static void Generate(WaveFile destination, DTMF tone, double volume, int repeatCount)
 {
     Generate(destination, new[] { tone }, volume, repeatCount);
 }
Esempio n. 9
0
 /// <summary>
 /// Generates the specified dual-tone multi-frequency storing it in the specified <see cref="WaveFile"/>.
 /// </summary>
 /// <param name="destination"><see cref="WaveFile"/> used to store generated dual-tone multi-frequencies.</param>
 /// <param name="tone">Dual-tone multi-frequency to generate.</param>
 /// <param name="volume">Volume of generated dual-tones as a percentage (0 to 1).</param>
 public static void Generate(WaveFile destination, DTMF tone, double volume)
 {
     Generate(destination, new[] { tone }, volume, 1);
 }
Esempio n. 10
0
        // Static Methods

        /// <summary>
        /// Computes a dual-tone multi-frequency sound for the given <see cref="DTMF"/> information and time.
        /// </summary>
        /// <param name="tone">Instance of the <see cref="DTMF"/> specifying the duration as well as the low and high frequencies of the dual-tone.</param>
        /// <param name="sampleIndex">Sample index (represents time anywhere from zero to full length of tone).</param>
        /// <param name="sampleRate">Number of samples per second.</param>
        /// <returns>The amplitude for the dual-tone at the given time.</returns>
        /// <remarks>
        /// This method computes an amplitude representing the acoustic pressure of a
        /// <see cref="DTMF"/> of the given frequency for the given time.
        /// </remarks>
        public static double ComputeFrequencies(DTMF tone, long sampleIndex, int sampleRate)
        {
            return((Timbre.PureTone(tone.LowFrequency, sampleIndex, 0, sampleRate) + Timbre.PureTone(tone.HighFrequency, sampleIndex, 0, sampleRate)) / 2);
        }
Esempio n. 11
0
        /// <summary>
        /// Get array of touch tones for given string.
        /// </summary>
        /// <param name="keys">String of touch tone characters to convert to touch tones.</param>
        /// <param name="keyDuration">Duration of touch tone key press in seconds, typically fractional.</param>
        /// <param name="interKeyPause">Time to wait between key presses in seconds, typically fractional.</param>
        /// <returns>Array of touch tones for given string.</returns>
        /// <remarks>Non-touch tone characters are ignored. Commas are interpreted as a one second pause.</remarks>
        public static DTMF[] GetTouchTones(string keys, double keyDuration, double interKeyPause)
        {
            List<DTMF> touchTones = new List<DTMF>();
            TouchTone touchTone;
            DTMF pause = new DTMF(0.0D, 0.0D, interKeyPause);
            DTMF longPause = new DTMF(0.0D, 0.0D, 1.0D);

            foreach (char key in keys)
            {
                if (key == ',')
                {
                    // Interpret commas as long pauses
                    touchTones.Add(longPause);
                }
                else if (TouchTone.TryParse(key, out touchTone))
                {
                    if (touchTones.Count > 0)
                        touchTones.Add(pause);

                    touchTone.Duration = keyDuration;
                    touchTones.Add(touchTone);
                }
            }

            return touchTones.ToArray();
        }