core | ugens | analysis



A UGenInput represents parameter of the UGen that can be controlled by other UGens by patching to it. When not patched, a UGenInput produces a constant value, which can be changed at any time by calling setLastValue.

A UGenInput will have an InputType of either AUDIO or CONTROL. An AUDIO input will always have the same number of channels as the owning UGen, in other words the length of the array returned by getLastValues will have a length equal to channel count. A CONTROL input will always have one channel and its value can be conveniently queried by calling getLastValue().


Create a UGenInput with a particular type.
UGenInput(UGen.InputType type)
Create a UGenInput of the specified type with an initial value.
UGenInput(UGen.InputType type, float value)


type — the InputType of this UGenInput
value — the initial float value used for all last values



  * This sketch demonstrates how to create a simple synthesis chain that 
  * involves controlling the value of a UGenInput with the output of 
  * a UGen. In this case, we patch an Oscil generating a sine wave into 
  * the amplitude input of an Oscil generating a square wave. The result 
  * is known as amplitude modulation.
  * <p>
  * For more information about Minim and additional features, 
  * visit

import ddf.minim.*;
import ddf.minim.ugens.*;

Minim minim;
AudioOutput out;
Oscil       wave;
Oscil       mod;

void setup()
  size(512, 200, P3D);
  minim = new Minim(this);
  // use the getLineOut method of the Minim object to get an AudioOutput object
  out = minim.getLineOut();
  // create a triangle wave Oscil, set to 440 Hz, at 1.0 amplitude
  // in this case, the amplitude we construct the Oscil with 
  // doesn't matter because we will be patching something to
  // its amplitude input.
  wave = new Oscil( 440, 1.0f, Waves.TRIANGLE );
  // create a sine wave Oscil for modulating the amplitude of wave
  mod  = new Oscil( 2, 0.4f, Waves.SINE );
  // connect up the modulator
  mod.patch( wave.amplitude );
  // patch wave to the output
  wave.patch( out );

void draw()
  // draw the waveforms
  for(int i = 0; i < out.bufferSize() - 1; i++)
    line( i, 50 + out.left.get(i)*50, i+1, 50 + out.left.get(i+1)*50 );
    line( i, 150 + out.right.get(i)*50, i+1, 150 + out.right.get(i+1)*50 );


Web & Application