com.jsyn.unitgen

Class GrainFarm

java.lang.Object

com.jsyn.unitgen.UnitGenerator

com.jsyn.unitgen.GrainFarm

All Implemented Interfaces:

UnitSource

Direct Known Subclasses:

SampleGrainFarm

public class GrainFarm
extends UnitGenerator
implements UnitSource

A unit generator that generates a cloud of sound using multiple Grains. Special thanks to my friend Ross Bencina for his excellent article on Granular Synthesis. Several of his ideas are reflected in this architecture. "Implementing Real-Time Granular Synthesis" by Ross Bencina, Audio Anecdotes III, 2001.

   synth.add( sampleGrainFarm = new GrainFarm() );
   grainFarm.allocate( NUM_GRAINS );

Author:

Phil Burk (C) 2011 Mobileer Inc

See Also:

Grain, GrainSourceSine, RaisedCosineEnvelope

Field Summary

Fields

Modifier and Type	Field and Description
UnitInputPort	amplitude
UnitInputPort	amplitudeRange
UnitInputPort	density
UnitInputPort	duration
UnitInputPort	durationRange
UnitOutputPort	output
UnitInputPort	rate A scaler for playback rate.
UnitInputPort	rateRange

Fields inherited from class com.jsyn.unitgen.UnitGenerator

FALSE, PORT_NAME_AMPLITUDE, PORT_NAME_CUTOFF, PORT_NAME_FREQUENCY, PORT_NAME_FREQUENCY_SCALER, PORT_NAME_INPUT, PORT_NAME_OUTPUT, PORT_NAME_PAN, PORT_NAME_PHASE, PORT_NAME_PRESSURE, PORT_NAME_TIMBRE, PORT_NAME_TIME, synthesisEngine, TRUE, VERY_SMALL_FLOAT

Constructor Summary

Constructors

Constructor and Description
GrainFarm()

Method Summary

Modifier and Type	Method and Description
void	allocate(int numGrains)
void	generate(int start, int limit) Perform essential synthesis function.
UnitOutputPort	getOutput()
void	setGrainArray(Grain[] grains)
void	setupGrain(Grain grain, int i)

Methods inherited from class com.jsyn.unitgen.UnitGenerator

addPort, addPort, autoStop, convertHalfLifeToMultiplier, convertTimeToRate, flattenOutputs, generate, getCircuit, getFramePeriod, getFrameRate, getId, getPortByName, getPorts, getSynthesisEngine, getSynthesizer, getTopUnit, getUnitGenerator, incrementWrapPhase, isEnabled, isStartRequired, printConnections, printConnections, printConnections, pullData, setCircuit, setEnabled, setFrameRate, setPort, setSynthesisEngine, start, start, start, stop, stop, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.jsyn.unitgen.UnitSource

getUnitGenerator

Field Detail

rate

public UnitInputPort rate

A scaler for playback rate. Nominally 1.0.

rateRange

public UnitInputPort rateRange

amplitude

public UnitInputPort amplitude

amplitudeRange

public UnitInputPort amplitudeRange

density

public UnitInputPort density

duration

public UnitInputPort duration

durationRange

public UnitInputPort durationRange

output

public UnitOutputPort output

Constructor Detail

GrainFarm

public GrainFarm()

Method Detail

setGrainArray

public void setGrainArray(Grain[] grains)

setupGrain

public void setupGrain(Grain grain,
                       int i)

allocate

public void allocate(int numGrains)

getOutput

public UnitOutputPort getOutput()

Specified by:

getOutput in interface UnitSource

generate

public void generate(int start,
                     int limit)

Description copied from class: UnitGenerator

Perform essential synthesis function.

Specified by:

generate in class UnitGenerator

Parameters:

start - offset into port buffers

limit - limit offset into port buffers for loop