ddf.minim.ugens

Class Vocoder

java.lang.Object

ddf.minim.UGen

ddf.minim.ugens.Vocoder

public class Vocoder
extends UGen

Vocoder is a UGen that performs very basic vocoding. It works by analyzing the audio input and the modulator input with FFTs and then multiplying the audio input's spectrum by the modulator's spectrum.

Author:

Damien Di Fede

Nested Class Summary

Nested classes/interfaces inherited from class ddf.minim.UGen

UGen.InputType, UGen.UGenInput

Field Summary

Fields

Modifier and Type	Field and Description
UGen.UGenInput	audio The audio you want processed by the Vocoder.
UGen.UGenInput	modulator The signal that will be used to transform the audio input.

Constructor Summary

Constructors

Constructor and Description
Vocoder(int windowSize, int windowCount) Constructs a Vocoder.

Method Summary

Modifier and Type	Method and Description
protected void	sampleRateChanged() Override this method in your derived class to receive a notification when the sample rate of your UGen has changed.
protected void	uGenerate(float[] out) Implement this method when you extend UGen.

Methods inherited from class ddf.minim.UGen

addAudio, addControl, addControl, addInput, channelCount, channelCountChanged, getLastValues, patch, patch, patch, printInputs, removeInput, sampleRate, setChannelCount, setSampleRate, tick, unpatch, unpatch

Methods inherited from class java.lang.Object

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

Field Detail

audio

public UGen.UGenInput audio

The audio you want processed by the Vocoder. If you are going for the classic robot vocals sound, you would patch the synth to this input, typically something with a lot of high frequency content, like Waves.SAW.

modulator

public UGen.UGenInput modulator

The signal that will be used to transform the audio input. If you are going for the classic robot vocals sound, you would patch the vocals to this input.

Constructor Detail

Vocoder

public Vocoder(int windowSize,
               int windowCount)

Constructs a Vocoder.

Parameters:

windowSize - int: the number of sample frames to use for each FFT analysis. Smaller window sizes will have better performance, but lower sound quality. the window size must also be a power of two, which is a requirement for using an FFT.

windowCount - int: the number of overlapping windows to use. this must be at least 1 with larger values causing the analysis windows to overlap with each other to a greater degree. For instance, with a windowSize of 1024 and a windowCount of 2, a 1024 sample frame FFT will be calculated every 512 sample frames. With 3 windows, every 341 samples, and so forth. More windows generally equates to better quality.

Method Detail

sampleRateChanged

protected void sampleRateChanged()

Description copied from class: UGen

Override this method in your derived class to receive a notification when the sample rate of your UGen has changed. You might need to do this to recalculate sample rate dependent values, such as the step size for an oscillator.

Overrides:

sampleRateChanged in class UGen

uGenerate

protected void uGenerate(float[] out)

Description copied from class: UGen

Implement this method when you extend UGen. It will be called when your UGen needs to generate one sample frame of audio. It is expected that you will assign values to the array and not simply modify the existing values. In the case where you write a UGen that takes audio input and modifies it, the pattern to follow is to have the first UGenInput you create be your audio input and then in uGenerate you will use the getLastValues method of your audio UGenInput to retrieve the audio you want to modify, which you will then modify however you need to, assigning the result to the values in channels.

Specified by:

uGenerate in class UGen

Parameters:

out - an array representing one sample frame.