Class SongMetaEvents

java.lang.Object
org.jjazz.song.api.SongMetaEvents
All Implemented Interfaces:
PropertyChangeListener, EventListener, ClsChangeListener, SgsChangeListener

public class SongMetaEvents extends Object implements ClsChangeListener, SgsChangeListener, PropertyChangeListener
A helper class which listens to Song/ChordLeadSheet/SongStructure change events to provide higher-level property change events.

  • Field Details

    • PROP_CLS_SGS_CHANGE

      public static final String PROP_CLS_SGS_CHANGE
      Fired when the song's ChordLeadSheet or SongStructure has changed.

      OldValue=the source ClsChangeEvent or SgsChangeEvent

      See Also:
    • PROP_MUSIC_GENERATION

      public static final String PROP_MUSIC_GENERATION
      Fired when the "musical content" of the song is modified, i.e. a new music generation task is needed.

      For example source changes can be chord symbol changes, inserted bars, rhythm parameter value changes -but not a section name change. For ClsChangeEvents which normally generate a SgsChange (e.g. SectionAddedEvent -> SptAddedEvent), the PROP_MUSIC_GENERATION event is fired only for the SgsChangeEvent.

      Because a rhythm generation engine might adjust the generated music to the tempo, a song tempo change is considered as a musical content change.

      OldValue=the source SongPropertyChangeEvent or ClsChangeEvent or SgsChangeEvent

      See Also:
    • PROP_SIZE_IN_BEATS

      public static final String PROP_SIZE_IN_BEATS
      Fired when at least one song bar was added/removed/moved, or a time signature was changed.

      OldValue=the source ClsChangeEvent or SgsChangeEvent

      See Also:
  • Method Details