be.tarsos.dsp

Class AudioGenerator

java.lang.Object

be.tarsos.dsp.AudioGenerator

All Implemented Interfaces:

java.lang.Runnable

public class AudioGenerator
extends java.lang.Object
implements java.lang.Runnable

This class plays a file and sends float arrays to registered AudioProcessor implementors. This class can be used to feed FFT's, pitch detectors, audio players, ... Using a (blocking) audio player it is even possible to synchronize execution of AudioProcessors and sound. This behavior can be used for visualization.

Author:

Joren Six

Constructor Summary

Constructors

Constructor and Description
AudioGenerator(int audioBufferSize, int bufferOverlap) Create a new generator.

Method Summary

Modifier and Type	Method and Description
void	addAudioProcessor(AudioProcessor audioProcessor) Adds an AudioProcessor to the chain of processors.
TarsosDSPAudioFormat	getFormat()
void	removeAudioProcessor(AudioProcessor audioProcessor) Removes an AudioProcessor to the chain of processors and calls processingFinished.
void	run()
float	secondsProcessed()
void	setStepSizeAndOverlap(int audioBufferSize, int bufferOverlap) Set a new step size and overlap size.
void	stop() Stops dispatching audio data.

Methods inherited from class java.lang.Object

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

Constructor Detail

AudioGenerator

public AudioGenerator(int audioBufferSize,
                      int bufferOverlap)

Create a new generator.

Parameters:

audioBufferSize - The size of the buffer defines how much samples are processed in one step. Common values are 1024,2048.

bufferOverlap - How much consecutive buffers overlap (in samples). Half of the AudioBufferSize is common (512, 1024) for an FFT.

Method Detail

setStepSizeAndOverlap

public void setStepSizeAndOverlap(int audioBufferSize,
                                  int bufferOverlap)

Set a new step size and overlap size. Both in number of samples. Watch out with this method: it should be called after a batch of samples is processed, not during.

Parameters:

audioBufferSize - The size of the buffer defines how much samples are processed in one step. Common values are 1024,2048.

bufferOverlap - How much consecutive buffers overlap (in samples). Half of the AudioBufferSize is common (512, 1024) for an FFT.

addAudioProcessor

public void addAudioProcessor(AudioProcessor audioProcessor)

Adds an AudioProcessor to the chain of processors.

Parameters:

audioProcessor - The AudioProcessor to add.

removeAudioProcessor

public void removeAudioProcessor(AudioProcessor audioProcessor)

Removes an AudioProcessor to the chain of processors and calls processingFinished.

Parameters:

audioProcessor - The AudioProcessor to remove.

run

public void run()

Specified by:

run in interface java.lang.Runnable

stop

public void stop()

Stops dispatching audio data.

getFormat

public TarsosDSPAudioFormat getFormat()

secondsProcessed

public float secondsProcessed()

Returns:

The currently processed number of seconds.