Package org.jamdev.jpamutils.wavFiles

Class WavFile

java.lang.Object

javax.sound.sampled.spi.AudioFileReader

org.jamdev.jpamutils.wavFiles.WavFile

public class WavFile
extends AudioFileReader

A WAV file reader. Modified to be more object orientated. This code reads WAV files. There are many decent documents on the web describing the WAV file format. I didn't bother looking for the official document. If it exists, I'm not even sure if it is freely available. We should update this comment if we find out anything helpful here. I used http://www.sonicspot.com/guide/wavefiles.html

Author:

Anthony Green (green@redhat.com), Jamie Macaulay

Constructor Summary

Constructors

Constructor	Description
WavFile(File file)
WavFile(URL file)

Method Summary

Modifier and Type	Method	Description
AudioFileFormat	getAudioFileFormat()
AudioFileFormat	getAudioFileFormat(File file)
AudioFileFormat	getAudioFileFormat(InputStream in)
AudioFileFormat	getAudioFileFormat(URL url)
AudioInputStream	getAudioInputStream()
AudioInputStream	getAudioInputStream(File file)
AudioInputStream	getAudioInputStream(InputStream stream)
AudioInputStream	getAudioInputStream(URL url)
int	getByteLength()	Get the length of the file in bytes,
File	getFile()	Get the file object for the .wav file.
URL	getFileURL()	Get the file object for the .wav file.
static int[]	getSampleAmplitudes(AudioFormat wavHeader, byte[] data)	Get the amplitudes of the wave samples (depends on the header)
static byte[]	getSingleChannelByte(AudioFormat wavHeader, byte[] bytes, int channel)	Get a multi channel .wav file and return the byte stream for just one of the channels.
static byte[]	trim(AudioFormat wavHeader, byte[] bytes, int maxSamples)	Trim the byte data.

Methods inherited from class java.lang.Object

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

Constructor Details

WavFile

public WavFile(File file) throws UnsupportedAudioFileException, IOException

Throws:

UnsupportedAudioFileException

IOException

WavFile

public WavFile(URL file) throws UnsupportedAudioFileException, IOException

Throws:

UnsupportedAudioFileException

IOException

Method Details

getAudioFileFormat

public AudioFileFormat getAudioFileFormat(File file) throws UnsupportedAudioFileException, IOException

Specified by:

getAudioFileFormat in class AudioFileReader

Throws:

UnsupportedAudioFileException

IOException

getAudioFileFormat

public AudioFileFormat getAudioFileFormat()

getAudioFileFormat

public AudioFileFormat getAudioFileFormat(InputStream in) throws UnsupportedAudioFileException, IOException

Specified by:

getAudioFileFormat in class AudioFileReader

Throws:

UnsupportedAudioFileException

IOException

getAudioFileFormat

public AudioFileFormat getAudioFileFormat(URL url) throws UnsupportedAudioFileException, IOException

Specified by:

getAudioFileFormat in class AudioFileReader

Throws:

UnsupportedAudioFileException

IOException

getAudioInputStream

public AudioInputStream getAudioInputStream(File file) throws UnsupportedAudioFileException, IOException

Specified by:

getAudioInputStream in class AudioFileReader

Throws:

UnsupportedAudioFileException

IOException

getAudioInputStream

public AudioInputStream getAudioInputStream() throws UnsupportedAudioFileException, IOException

Throws:

UnsupportedAudioFileException

IOException

getAudioInputStream

public AudioInputStream getAudioInputStream(InputStream stream) throws UnsupportedAudioFileException, IOException

Specified by:

getAudioInputStream in class AudioFileReader

Throws:

UnsupportedAudioFileException

IOException

getAudioInputStream

public AudioInputStream getAudioInputStream(URL url) throws UnsupportedAudioFileException, IOException

Specified by:

getAudioInputStream in class AudioFileReader

Throws:

UnsupportedAudioFileException

IOException

getSampleAmplitudes

public static int[] getSampleAmplitudes(AudioFormat wavHeader, byte[] data)

Get the amplitudes of the wave samples (depends on the header)

Returns:

amplitudes array (signed 16-bit)

trim

public static byte[] trim(AudioFormat wavHeader, byte[] bytes, int maxSamples)

Trim the byte data. Trimmed from center left and right so that the size is no larger than maxSamples.

Parameters:

wavHeader - - the wave file header

bytes - - a SINGLE-channel byte array

maxSamples - - the sample size of the trimmed clip.

Returns:

the byte array for one channel.

getSingleChannelByte

public static byte[] getSingleChannelByte(AudioFormat wavHeader, byte[] bytes, int channel)

Get a multi channel .wav file and return the byte stream for just one of the channels.

Parameters:

wavHeader - - the wave file header

bytes - - the multi-channel byte array

channel - - the channel to extract. This should never be higher than the total number of channels.

Returns:

the byte array for one channel.

getFile

public File getFile()

Get the file object for the .wav file.

Returns:

the file object.

getFileURL

public URL getFileURL()

Get the file object for the .wav file.

Returns:

the file object.

getByteLength

public int getByteLength()

Get the length of the file in bytes,

Returns:

the length of the file in bytes