com.soundhelix.component.sequenceengine

Interface SequenceEngine

All Superinterfaces:

Component, RandomSeedable, XMLConfigurable

All Known Implementing Classes:

AbstractFreeMultiPatternSequenceEngine, AbstractMultiPatternSequenceEngine, AbstractSequenceEngine, ArpeggioSequenceEngine, ChordSequenceEngine, DrumSequenceEngine, FreeMultiPatternSequenceEngine, FreePatternSequenceEngine, MelodySequenceEngine, MultiPatternSequenceEngine, PadSequenceEngine, PatternSequenceEngine

public interface SequenceEngine
extends Component

Represents a generator for sequences. Generated sequences are combined into a track.

Author:

Thomas Schuerger (thomas@schuerger.com)

Method Summary

Methods

Modifier and Type	Method and Description
int	getActivityVectorCount() Returns the required number of ActivityVectors.
Track	render(SongContext songContext, ActivityVector[] activityVectors) Renders one or more sequences (i.e., voices) as a track.

Methods inherited from interface com.soundhelix.component.XMLConfigurable

configure

Methods inherited from interface com.soundhelix.component.RandomSeedable

getRandomSeed, setRandomSeed

Method Detail

render

Track render(SongContext songContext,
           ActivityVector[] activityVectors)

Renders one or more sequences (i.e., voices) as a track. The method should check the given ActivityVectors to decide when to insert notes and when to insert pauses. The method should also take care that played notes are not sustained beyond inactive intervals of the ActivityVector (however, it is not strictly forbidden to do so). The returned track must contain at least one sequence. The length of each sequence must match the length of the song. The method must take the song's harmony into consideration.

Parameters:

songContext - the song context

activityVectors - the activity vectors

Returns:

the track

getActivityVectorCount

int getActivityVectorCount()

Returns the required number of ActivityVectors. For most implementations, this will be 1, but certain implementations, like for multi-instrument sequences, more than 1 might be required.

Returns:

the number of ActivityVectors