marytts.util.data.audio

Class MaryAudioUtils

java.lang.Object

marytts.util.data.audio.MaryAudioUtils

public class MaryAudioUtils
extends Object

Author:

Marc Schröder

Constructor Summary

Constructors

Constructor and Description
MaryAudioUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static AudioInputStream	createSingleAudioInputStream(Vector<AudioInputStream> audioInputStreams) Create a single AudioInputStream from a vector of AudioInputStreams.
static AudioFileFormat.Type	getAudioFileFormatType(String name) Return an audio file format type for the given string.
static double[]	getSamplesAsDoubleArray(AudioInputStream ais)
static void	playWavFile(String filename, int loop) Play back a file loop times (0 = only once).
static void	playWavFile(String filename, int loop, boolean waitUntilCompleted) Play back a file loop times (0 = only once).
static void	stopWavFile() Stop wav play back
static void	timedRecord(File targetFile, long millis, AudioFormat audioFormat) Record a sound file with the recording being limited to a given amount of time
static void	timedRecord(String filename, long millis, AudioFormat audioFormat) Record a sound file with the recording being limited to a given amount of time
static void	writeWavFile(double[] x, String outputFile, AudioFormat format)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MaryAudioUtils

public MaryAudioUtils()

Method Detail

createSingleAudioInputStream

public static AudioInputStream createSingleAudioInputStream(Vector<AudioInputStream> audioInputStreams)

Create a single AudioInputStream from a vector of AudioInputStreams. The AudioInputStreams are expected to have the same AudioFormat.

Parameters:

audioInputStreams - a vector containing one or more AudioInputStreams.

Returns:

a single AudioInputStream

Throws:

NullPointerException - if any of the arguments are null

IllegalArgumentException - if the vector contains no elements, any element is not an AudioInputStream.

getAudioFileFormatType

public static AudioFileFormat.Type getAudioFileFormatType(String name)

Return an audio file format type for the given string. In addition to the built-in types, this can deal with MP3 supported by tritonus.

Parameters:

name - name

Returns:

the audio file format type if it is known, or null.

timedRecord

public static void timedRecord(String filename,
               long millis,
               AudioFormat audioFormat)

Record a sound file with the recording being limited to a given amount of time

Parameters:

filename - name of the sound file

millis - the given amount of time in milliseconds

audioFormat - the audio format for the actual sound file

timedRecord

public static void timedRecord(File targetFile,
               long millis,
               AudioFormat audioFormat)

Record a sound file with the recording being limited to a given amount of time

Parameters:

targetFile - name of the sound file

millis - the given amount of time in milliseconds

audioFormat - the audio format for the actual sound file

playWavFile

public static void playWavFile(String filename,
               int loop)

Play back a file loop times (0 = only once). Play in the background, non-blocking.

Parameters:

filename - name of the wav file

loop - number of times the file should be repeated (0 = play only once).

playWavFile

public static void playWavFile(String filename,
               int loop,
               boolean waitUntilCompleted)

Play back a file loop times (0 = only once). Play in the background, non-blocking.

Parameters:

filename - name of the wav file

loop - number of times the file should be repeated (0 = play only once).

waitUntilCompleted - whether or not to wait until the file has finished playing before returning.

stopWavFile

public static void stopWavFile()

Stop wav play back

getSamplesAsDoubleArray

public static double[] getSamplesAsDoubleArray(AudioInputStream ais)

writeWavFile

public static void writeWavFile(double[] x,
                String outputFile,
                AudioFormat format)
                         throws IOException

Throws:

IOException