com.soundhelix.component.sequenceengine.impl

Class MelodySequenceEngine

java.lang.Object

com.soundhelix.component.sequenceengine.impl.AbstractSequenceEngine

com.soundhelix.component.sequenceengine.impl.MelodySequenceEngine

All Implemented Interfaces:

Component, RandomSeedable, SequenceEngine, XMLConfigurable

public class MelodySequenceEngine
extends AbstractSequenceEngine

Implements a sequence engine that uses a randomly generated melody, played with a given rhythmic pattern. For each distinct chord section, a random number of melodies between minMelodies and maxMelodies are generated. For each occurrence of a chord section, its generated melodies are used in a round-robin fashion.

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 inherited from class com.soundhelix.component.sequenceengine.impl.AbstractSequenceEngine

logger, patternRestartMode, randomSeed

Constructor Summary

Constructors

Constructor and Description
MelodySequenceEngine() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	configure(SongContext songContext, Node node) Configures the instance using the specified XML node.
int	getMaxPitch()
int	getMinPitch()
int[]	getPitchDistances()
Track	render(SongContext songContext, ActivityVector[] activityVectors) Renders one or more sequences (i.e., voices) as a track.
void	setMaxPitch(int maxPitch)
void	setMelodies(int[] melodies)
void	setMinPitch(int minPitch)
void	setPattern(Pattern pattern)
void	setPitchDistances(int[] pitchDistances)

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

Constructor Detail

MelodySequenceEngine

public MelodySequenceEngine()

Constructor.

Method Detail

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

configure

public void configure(SongContext songContext,
             Node node)
               throws XPathException

Description copied from interface: XMLConfigurable

Configures the instance using the specified XML node. The method should read all supported configuration tags and should call the corresponding setter methods of the class. All settings of the class that are settable using XML should also be settable by using public methods (for example, if the beats per minute are settable using an XML tag, then the class should also provide a public method setBPM(), which does the same). XML configuration can also be a recursive process, if XML settings contain nodes that require XML configuration themselves, but this is up to the implementation of this method. The method should (but need not) use XPath to access the node's tags. Only the node and its descendant nodes may be used for configuration.

Parameters:

songContext - the song context

node - the parent XML node of the configuration tags

Throws:

XPathException - in case of an XPath problem

setPattern

public void setPattern(Pattern pattern)

getMinPitch

public int getMinPitch()

setMinPitch

public void setMinPitch(int minPitch)

getMaxPitch

public int getMaxPitch()

setMaxPitch

public void setMaxPitch(int maxPitch)

getPitchDistances

public int[] getPitchDistances()

setPitchDistances

public void setPitchDistances(int[] pitchDistances)

setMelodies

public void setMelodies(int[] melodies)