com.soundhelix.component.patternengine.impl

Class RandomPatternEngine

java.lang.Object

com.soundhelix.component.patternengine.impl.AbstractPatternEngine

com.soundhelix.component.patternengine.impl.StringPatternEngine

com.soundhelix.component.patternengine.impl.RandomPatternEngine

All Implemented Interfaces:

Component, PatternEngine, RandomSeedable, XMLConfigurable

public class RandomPatternEngine
extends StringPatternEngine

Implements a generic sequence engine that generates a random pattern, with random pitches, random note and pause lengths, random legato and random velocity, as well as the ability to repeat subpatterns.

Author:

Thomas Schuerger (thomas@schuerger.com)

Field Summary

Fields inherited from class com.soundhelix.component.patternengine.impl.AbstractPatternEngine

logger, randomSeed

Constructor Summary

Constructors

Constructor and Description
RandomPatternEngine()

Method Summary

Methods

Modifier and Type	Method and Description
void	configure(SongContext songContext, Node node) Configures the instance using the specified XML node.
void	setLegatoProbability(double legatoProbability)
void	setMaxActiveTicks(int maxActiveTicks)
void	setMaxVelocity(double maxVelocity)
void	setMinActiveTicks(int minActiveTicks)
void	setMinVelocity(double minVelocity)
void	setNoteLengths(int[] noteLengths)
void	setNoteProbability(double noteProbability)
void	setOffsets(com.soundhelix.component.patternengine.impl.RandomPatternEngine.PatternEntry[] offsets)
void	setPatternString(String patternString)
void	setPatternTicks(int patternTicks)
void	setPauseLengths(int[] pauseLengths)
void	setPitchVelocityCorrelation(double pitchVelocityCorrelation)
void	setUniquePatternParts(boolean uniquePatternParts)
void	setVelocityExponent(double velocityExponent)

Methods inherited from class com.soundhelix.component.patternengine.impl.StringPatternEngine

getPatternString, render, setPatternTicksPerBeat

Methods inherited from class com.soundhelix.component.patternengine.impl.AbstractPatternEngine

getRandomSeed, setRandomSeed

Methods inherited from class java.lang.Object

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

Constructor Detail

RandomPatternEngine

public RandomPatternEngine()

Method Detail

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.

Specified by:

configure in interface XMLConfigurable

Overrides:

configure in class StringPatternEngine

Parameters:

songContext - the song context

node - the parent XML node of the configuration tags

Throws:

XPathException - in case of an XPath problem

setPatternTicks

public void setPatternTicks(int patternTicks)

setNoteProbability

public void setNoteProbability(double noteProbability)

setLegatoProbability

public void setLegatoProbability(double legatoProbability)

setOffsets

public void setOffsets(com.soundhelix.component.patternengine.impl.RandomPatternEngine.PatternEntry[] offsets)

setMinVelocity

public void setMinVelocity(double minVelocity)

setMaxVelocity

public void setMaxVelocity(double maxVelocity)

setPatternString

public void setPatternString(String patternString)

Overrides:

setPatternString in class StringPatternEngine

setNoteLengths

public void setNoteLengths(int[] noteLengths)

setPauseLengths

public void setPauseLengths(int[] pauseLengths)

setPitchVelocityCorrelation

public void setPitchVelocityCorrelation(double pitchVelocityCorrelation)

setVelocityExponent

public void setVelocityExponent(double velocityExponent)

setMinActiveTicks

public void setMinActiveTicks(int minActiveTicks)

setMaxActiveTicks

public void setMaxActiveTicks(int maxActiveTicks)

setUniquePatternParts

public void setUniquePatternParts(boolean uniquePatternParts)