com.soundhelix.component.sequenceengine.impl

Class AbstractMultiPatternSequenceEngine

java.lang.Object

com.soundhelix.component.sequenceengine.impl.AbstractSequenceEngine

com.soundhelix.component.sequenceengine.impl.AbstractMultiPatternSequenceEngine

All Implemented Interfaces:

Component, RandomSeedable, SequenceEngine, XMLConfigurable

Direct Known Subclasses:

MultiPatternSequenceEngine, PatternSequenceEngine

public abstract class AbstractMultiPatternSequenceEngine
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, minus and plus signs. Integers play the corresponding note of the chord (0 is the base note, 1 the middle note and so on; the numbers may also be negative). A minus sign is a pause. A plus sign plays a transition note between the current chord and the chord of the next non-transition tone that will be played. The pitch of the transition note is based on the base notes of the two chords. This can be used for funky base lines.

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 boolean	isNormalizeChords The boolean indicating whether chords should be normalized.
protected Random	random The random generator.
protected static char	TRANSITION The transition character.

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

logger, patternRestartMode, randomSeed

Constructor Summary

Constructors

Constructor and Description
AbstractMultiPatternSequenceEngine() Constructor.

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	setNormalizeChords(boolean isNormalizeChords)
void	setPatterns(Pattern[] 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

TRANSITION

protected static final char TRANSITION

The transition character.

See Also:

Constant Field Values

random

protected Random random

The random generator.

isNormalizeChords

protected boolean isNormalizeChords

The boolean indicating whether chords should be normalized.

Constructor Detail

AbstractMultiPatternSequenceEngine

public AbstractMultiPatternSequenceEngine()

Constructor.

Method Detail

setPatterns

public void setPatterns(Pattern[] 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

setNormalizeChords

public void setNormalizeChords(boolean isNormalizeChords)