be.tarsos.dsp.granulator

Class Granulator

java.lang.Object

be.tarsos.dsp.granulator.Granulator

All Implemented Interfaces:

AudioProcessor

public class Granulator
extends java.lang.Object
implements AudioProcessor

Granulator plays back samples using granular synthesis. Methods can be used to control playback rate, pitch, grain size, grain interval and grain randomness and position (this last case assumes that the playback rate is zero).

Author:

ollie, Joren

Field Summary

Fields

Modifier and Type	Field and Description
static float	ADAPTIVE_INTERP_HIGH_THRESH
static float	ADAPTIVE_INTERP_LOW_THRESH

Constructor Summary

Constructors

Constructor and Description
Granulator(float sampleRate, int bufferSize) Instantiates a new GranularSamplePlayer.

Method Summary

Modifier and Type	Method and Description
float	getFrameCubic(double posInMS) Retrieves a frame of audio using cubic interpolation.
double	getFrameLinear(double posInMS) Retrieves a frame of audio using linear interpolation.
float	getFrameNoInterp(double posInMS) Retrieves a frame of audio using no interpolation.
float	getValueFraction(float fraction) Returns the value of the buffer at the given fraction along its length (0 = start, 1 = end).
boolean	process(AudioEvent audioEvent) Process the audio event.
void	processingFinished() Notify the AudioProcessor that no more data is available and processing has finished.
void	setGrainInterval(int grainInterval)
void	setGrainRandomness(float grainRandomness)
void	setGrainSize(int grainSize)
void	setPitchShiftFactor(float currentFactor)
void	setPosition(float position)
void	setTimestretchFactor(float currentFactor)
void	start()

Methods inherited from class java.lang.Object

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

Field Detail

ADAPTIVE_INTERP_LOW_THRESH

public static final float ADAPTIVE_INTERP_LOW_THRESH

See Also:

Constant Field Values

ADAPTIVE_INTERP_HIGH_THRESH

public static final float ADAPTIVE_INTERP_HIGH_THRESH

See Also:

Constant Field Values

Constructor Detail

Granulator

public Granulator(float sampleRate,
                  int bufferSize)

Instantiates a new GranularSamplePlayer.

Parameters:

sampleRate - the sample rate.

bufferSize - the size of an output buffer.

Method Detail

start

public void start()

process

public boolean process(AudioEvent audioEvent)

Description copied from interface: AudioProcessor

Process the audio event. Do the actual signal processing on an (optionally) overlapping buffer.

Specified by:

process in interface AudioProcessor

Parameters:

audioEvent - The audio event that contains audio data.

Returns:

False if the chain needs to stop here, true otherwise. This can be used to implement e.g. a silence detector.

getFrameLinear

public double getFrameLinear(double posInMS)

Retrieves a frame of audio using linear interpolation. If the frame is not in the sample range then zeros are returned.

Parameters:

posInMS - The frame to read -- can be fractional (e.g., 4.4).

result - The framedata to fill.

getFrameNoInterp

public float getFrameNoInterp(double posInMS)

Retrieves a frame of audio using no interpolation. If the frame is not in the sample range then zeros are returned.

Parameters:

posInMS - The frame to read -- will take the last frame before this one.

getFrameCubic

public float getFrameCubic(double posInMS)

Retrieves a frame of audio using cubic interpolation. If the frame is not in the sample range then zeros are returned.

Parameters:

posInMS - The frame to read -- can be fractional (e.g., 4.4).

processingFinished

public void processingFinished()

Description copied from interface: AudioProcessor

Notify the AudioProcessor that no more data is available and processing has finished. Can be used to deallocate resources or cleanup.

Specified by:

processingFinished in interface AudioProcessor

getValueFraction

public float getValueFraction(float fraction)

Returns the value of the buffer at the given fraction along its length (0 = start, 1 = end). Uses linear interpolation.

Parameters:

fraction - the point along the buffer to inspect.

Returns:

the value at that point.

setTimestretchFactor

public void setTimestretchFactor(float currentFactor)

setPitchShiftFactor

public void setPitchShiftFactor(float currentFactor)

setGrainInterval

public void setGrainInterval(int grainInterval)

setGrainSize

public void setGrainSize(int grainSize)

setGrainRandomness

public void setGrainRandomness(float grainRandomness)

setPosition

public void setPosition(float position)

Parameters:

position - in seconds