Class DummyGenerator

java.lang.Object
org.jjazz.rhythmmusicgeneration.api.DummyGenerator
All Implemented Interfaces:
MusicGenerator
public class DummyGenerator extends Object implements MusicGenerator
A dummy generator that generate simple tracks for test purposes.

  • Constructor Details

    • DummyGenerator

      public DummyGenerator(Rhythm r)

  • Method Details

    • generateMusic

      public HashMap<RhythmVoice,Phrase> generateMusic(SongContext sgContext, RhythmVoice... rvs) throws MusicGenerationException
      Description copied from interface: MusicGenerator
      Generate the note Phrases which correspond to a musical accompaniment for a given rhythm.

      The service provider must compute one Phrase per RhythmVoice/Midi channel. The MidiMix from context provides the Midi channel associated to each RhythmVoice via MidiMix.getChannel(RhythmVoice). Phrases must be provided for all RhythmVoices (though a Phrase can be empty), including for the possible RhythmVoiceDelegates used by the Rhythm.

      If the context song contains several rhythms, the method must add notes ONLY for bars which use this MusicGenerator's rhythm. For example, if context range is bars 3-4 with rhythm1 on bar3 and rhythm2 on bar4, then the rhythm1 generator must add notes for bar 3 only.

      IMPORTANT: the following features are directly managed by the JJazzLab framework, notably by postprocessing the output of generateMusic():
      - Midi Instrument selection and settings (Program changes, Midi controller messages such as bank select, volume, reverb, panoramic)
      - RP_SYS_Mute rhythm parameter handling (muting a specific track for a specific SongPart)
      - RP_SYS_DrumsMix rhythm parameter handling (adjusting some drums track instruments velocity)
      - RP_SYS_CustomPhrase rhythm parameter handling (substitute a user-supplied phrase for a rhythm track)
      - RP_STD_Fill rhythm parameter handling for the "fade_out" value (MusicGenerator must handle the other values)
      - Handling of the channel's specific velocity shift
      - Handling of the instrument's specific transposition
      - Drums channel rerouting
      - NC chord symbols (produce no sound)

      Specified by:
      generateMusic in interface MusicGenerator
      Parameters:
      sgContext - The information to be used for music generation
      rvs - Generate music only for these RhythmVoices, or for all RhythmVoices if nothing specified
      Returns:
      One Phrase per rhythm voice/channel.
      Throws:
      MusicGenerationException - If generator could not produce the expected music for some reason.

    • getBasicBassPhrase

      public static Phrase getBasicBassPhrase(SimpleChordSequence cSeq, IntRange velocityRange, int channel)
      Get a basic bass phrase.

      For each chord play its bass note for the chord duration with random velocity.

      Parameters:
      cSeq -
      velocityRange - Use random notes velocity in this range
      channel - The channel of the returned phrase
      Returns:

    • getBasicMelodicPhrase

      public static Phrase getBasicMelodicPhrase(SimpleChordSequence cSeq, int channel)
      Get a basic random phrase for a melodic instrument (use chord notes).
      Parameters:
      cSeq -
      channel - The channel of the returned phrase
      Returns: