org.jfugue.extras
Class DurationPatternTransformer

java.lang.Object
  extended by org.jfugue.PatternTransformer
      extended by org.jfugue.extras.DurationPatternTransformer
All Implemented Interfaces:
java.util.EventListener, ParserListener

public class DurationPatternTransformer
extends PatternTransformer

The DurationPatternTransformer multiplies the duration of all notes in the given Pattern by a factor passed as a parameter.

This transformer can be used to increase or decrease the duration of notes. To increase the duration, use a variable greater than 1.0. To decrease the duration, use a value less than 1.0. The default value for this transformer is 1.0, which will result in no change to your Pattern.

For general information on how Pattern Transformers work, refer to the JFugue documentation.

Version:
2.0
Author:
David Koelle

Field Summary
static java.lang.String FACTOR
          Pass this String to putVariable, along with the factor by which you wish to alter the duration.
 
Fields inherited from class org.jfugue.PatternTransformer
returnPattern
 
Constructor Summary
DurationPatternTransformer()
          Instantiates a new DurationPatternTransformer object.
DurationPatternTransformer(double delta)
          Instantiates a new DurationPatternTransformer object, given a value by which to multiply the duration
 
Method Summary
 java.lang.String getDescription()
          Indicates what this PatternTransformer does.
 java.lang.String getParameters()
          Returns a string declaring what variables DurationPatternTransformer can use to perform the transformation.
 void noteEvent(Note note)
          Transforms the given note
 void parallelNoteEvent(Note note)
          Transforms the given note
 void sequentialNoteEvent(Note note)
          Transforms the given note
 
Methods inherited from class org.jfugue.PatternTransformer
channelPressureEvent, controllerEvent, getParameter, instrumentEvent, keySignatureEvent, layerEvent, measureEvent, pitchBendEvent, polyphonicPressureEvent, putParameter, tempoEvent, timeEvent, transform, voiceEvent
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

FACTOR

public static final java.lang.String FACTOR
Pass this String to putVariable, along with the factor by which you wish to alter the duration.

See Also:
Constant Field Values
Constructor Detail

DurationPatternTransformer

public DurationPatternTransformer()
Instantiates a new DurationPatternTransformer object. The default value by which to multiply the duration is 1.0, which will result in no change to the given Music String.


DurationPatternTransformer

public DurationPatternTransformer(double delta)
Instantiates a new DurationPatternTransformer object, given a value by which to multiply the duration

Method Detail

getParameters

public java.lang.String getParameters()
Returns a string declaring what variables DurationPatternTransformer can use to perform the transformation.

DurationPatternTransformer requires the following:
'factor' - Double - Factor by which to multiply the existing duration of a note. Greater than 1.0 produces longer notes, less than 1.0 produces shorter notes. Default is 1.0

Overrides:
getParameters in class PatternTransformer

getDescription

public java.lang.String getDescription()
Description copied from class: PatternTransformer
Indicates what this PatternTransformer does.

Overrides:
getDescription in class PatternTransformer
Returns:
A String giving a quick description of this transformer

noteEvent

public void noteEvent(Note note)
Transforms the given note

Specified by:
noteEvent in interface ParserListener
Overrides:
noteEvent in class PatternTransformer
Parameters:
note - the event that has been parsed
See Also:
Note

sequentialNoteEvent

public void sequentialNoteEvent(Note note)
Transforms the given note

Specified by:
sequentialNoteEvent in interface ParserListener
Overrides:
sequentialNoteEvent in class PatternTransformer
Parameters:
note - the event that has been parsed
See Also:
Note

parallelNoteEvent

public void parallelNoteEvent(Note note)
Transforms the given note

Specified by:
parallelNoteEvent in interface ParserListener
Overrides:
parallelNoteEvent in class PatternTransformer
Parameters:
note - the event that has been parsed
See Also:
Note