com.soundhelix.component.sequenceengine.impl

Class AbstractFreeMultiPatternSequenceEngine

java.lang.Object

com.soundhelix.component.sequenceengine.impl.AbstractSequenceEngine

com.soundhelix.component.sequenceengine.impl.AbstractFreeMultiPatternSequenceEngine

All Implemented Interfaces:

Component, RandomSeedable, SequenceEngine, XMLConfigurable

Direct Known Subclasses:

FreeMultiPatternSequenceEngine, FreePatternSequenceEngine

public abstract class AbstractFreeMultiPatternSequenceEngine
extends AbstractSequenceEngine

Implements a sequence engine that repeats a set of user-specified patterns in a voice each. A pattern is a string containing any number of comma-separated integers and minus signs. Integers play the corresponding semitone (0 is C, 1 is C#, etc.; the numbers may also be negative). A minus sign is a pause.

Author:

Thomas Schuerger (thomas@schuerger.com)

Nested Class Summary

Nested classes/interfaces inherited from class com.soundhelix.component.sequenceengine.impl.AbstractSequenceEngine

AbstractSequenceEngine.PatternRestartMode

Field Summary

Fields

Modifier and Type	Field and Description
protected Random	random The random generator.

Fields inherited from class com.soundhelix.component.sequenceengine.impl.AbstractSequenceEngine

logger, patternRestartMode, randomSeed

Constructor Summary

Constructors

Constructor and Description
AbstractFreeMultiPatternSequenceEngine()

Method Summary

Methods

Modifier and Type	Method and Description
Track	render(SongContext songContext, ActivityVector[] activityVectors) Renders one or more sequences (i.e., voices) as a track.
void	setPatterns(Pattern[] patterns) Sets the patterns.

Methods inherited from class com.soundhelix.component.sequenceengine.impl.AbstractSequenceEngine

configurePatternRestartMode, getActivityVectorCount, getNextPatternRestartTick, getRandomSeed, setPatternRestartMode, setRandomSeed

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.soundhelix.component.XMLConfigurable

configure

Field Detail

random

protected Random random

The random generator.

Constructor Detail

AbstractFreeMultiPatternSequenceEngine

public AbstractFreeMultiPatternSequenceEngine()

Method Detail

setPatterns

public void setPatterns(Pattern[] patterns)

Sets the patterns.

Parameters:

patterns - the patterns

render

public Track render(SongContext songContext,
           ActivityVector[] activityVectors)

Description copied from interface: SequenceEngine

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