RealtimeMidiParserListener

java.lang.Object
- org.jfugue.midi.TrackTimeManager
- - org.jfugue.realtime.RealtimeMidiParserListener

All Implemented Interfaces:

ParserListener
```
public class RealtimeMidiParserListener
extends TrackTimeManager
implements ParserListener
```
The callbacks in RealtimeMidiParserListener are only called when a user sends a Pattern to the RealtimePlayer. Otherwise, individual events like "note on" or "change instrument" are handled by RealtimePlayer itself. When this listener receives an event from the parser, it schedules the event with a command that will execute directly on the RealtimePlayer.

Constructor Summary

Constructors
Constructor and Description

RealtimeMidiParserListener(RealtimePlayer player)

Constructors
Constructor and Description
`RealtimeMidiParserListener(RealtimePlayer player)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`afterParsingFinished()` Called when the parser has parsed its last item.
`void`	`beforeParsingStarts()` Called when the parser first starts up, but before it starts parsing anything.
`void`	`finish()`
`long`	`getCurrentTime()`
`RealtimePlayer`	`getRealtimePlayer()`
`void`	`onBarLineParsed(long time)` The separator character which indicates a bar line has been parsed.
`void`	`onChannelPressureParsed(byte pressure)`
`void`	`onChordParsed(Chord chord)`
`void`	`onControllerEventParsed(byte controller, byte value)`
`void`	`onEventScheduled(long timeInMillis, ScheduledEvent event)`
`void`	`onEventUnscheduled(long timeInMillis, ScheduledEvent event)`
`void`	`onFunctionParsed(java.lang.String id, java.lang.Object message)`
`void`	`onInstrumentParsed(byte instrument)` Called when the parser encounters a new instrument selection.
`void`	`onInterpolatorStarted(RealtimeInterpolator interpolator, long durationInMillis)`
`void`	`onInterpolatorStopping(RealtimeInterpolator interpolator)`
`void`	`onKeySignatureParsed(byte key, byte scale)`
`void`	`onLayerChanged(byte layer)` Called when the parser encounters a new layer.
`void`	`onLyricParsed(java.lang.String lyric)`
`void`	`onMarkerParsed(java.lang.String marker)`
`void`	`onNoteParsed(Note note)` We may have actually parsed a musical note! In previous versions of JFugue, ParserListener had separate listeners for parallel notes and sequential notes (now termed harmonic and melodic notes, respectively) In this version of JFugue, whether a note is the first note, a harmonic note, or a melodic note is kept as a property on the Note object itself.
`void`	`onNotePressed(Note note)` Used to indicate when a note is pressed.
`void`	`onNoteReleased(Note note)` Used to indicate when a note is released.
`void`	`onPitchWheelParsed(byte lsb, byte msb)`
`void`	`onPolyphonicPressureParsed(byte key, byte pressure)`
`void`	`onSystemExclusiveParsed(byte... bytes)`
`void`	`onTempoChanged(int tempoBPM)` Called when the parser encounters a new tempo selection.
`void`	`onTimeSignatureParsed(byte numerator, byte powerOfTwo)` The first parameter is the number of beats per measure; The second parameter is the power by which 2 must be raised to create the note that represents one beat.
`void`	`onTrackBeatTimeBookmarked(java.lang.String timeBookmarkID)`
`void`	`onTrackBeatTimeBookmarkRequested(java.lang.String timeBookmarkID)`
`void`	`onTrackBeatTimeRequested(double time)`
`void`	`onTrackChanged(byte track)` Called when the parser encounters a new track (also known as a channel; previously in JFugue, known as a Voice).
`void`	`scheduleCommand(long timeInMillis, org.jfugue.realtime.RealtimeMidiParserListener.Command command)`
`void`	`scheduleEvent(long timeInMillis, ScheduledEvent event)`
`void`	`unscheduleEvent(long timeInMillis, ScheduledEvent event)`

Methods inherited from class org.jfugue.midi.TrackTimeManager
addTrackTickTimeBookmark, advanceTrackBeatTime, createTrack, getCurrentLayerNumber, getCurrentTrackNumber, getInitialNoteBeatTimeForHarmonicNotes, getLastCreatedTrackNumber, getLatestTrackBeatTime, getTrackBeatTime, getTrackBeatTimeBookmark, setAllTrackBeatTime, setCurrentLayerNumber, setCurrentTrack, setInitialNoteBeatTimeForHarmonicNotes, setTrackBeatTime

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - RealtimeMidiParserListener
```
public RealtimeMidiParserListener(RealtimePlayer player)
                           throws javax.sound.midi.MidiUnavailableException
```
    Throws:
    
    javax.sound.midi.MidiUnavailableException
- Method Detail
  - getCurrentTime
```
public long getCurrentTime()
```
  - finish
```
public void finish()
```
  - getRealtimePlayer
```
public RealtimePlayer getRealtimePlayer()
```
  - scheduleCommand
```
public void scheduleCommand(long timeInMillis,
                            org.jfugue.realtime.RealtimeMidiParserListener.Command command)
```
  - scheduleEvent
```
public void scheduleEvent(long timeInMillis,
                          ScheduledEvent event)
```
  - unscheduleEvent
```
public void unscheduleEvent(long timeInMillis,
                            ScheduledEvent event)
```
  - beforeParsingStarts
```
public void beforeParsingStarts()
```
    Description copied from interface: ParserListener
    
    Called when the parser first starts up, but before it starts parsing anything. Provides listeners with a chance to initialize variables and get ready for the parser events.
    
    Specified by:
    
    beforeParsingStarts in interface ParserListener
  - afterParsingFinished
```
public void afterParsingFinished()
```
    Description copied from interface: ParserListener
    
    Called when the parser has parsed its last item. Provides listeners with a chance to clean up.
    
    Specified by:
    
    afterParsingFinished in interface ParserListener
  - onTrackChanged
```
public void onTrackChanged(byte track)
```
    Description copied from interface: ParserListener
    
    Called when the parser encounters a new track (also known as a channel; previously in JFugue, known as a Voice). Tracks correspond to MIDI tracks/channels.
    
    Specified by:
    
    onTrackChanged in interface ParserListener
    
    Parameters:
    
    track - the new track event that has been parsed
  - onLayerChanged
```
public void onLayerChanged(byte layer)
```
    Description copied from interface: ParserListener
    
    Called when the parser encounters a new layer. A layer deals with polyphony within a track. While any track may have layers, layers are intended for use with the percussion track, where each layer may represent notes for a specific percussive instrument. Layers can essentially be thought of as a "track within a track." Each layer maintains its own time progression, so "L1 Eq Eq L2 Cq Gq" would be the same as saying "Eq+Cq Eq+Gq". Layers are a JFugue feature, and are not a part of the MIDI specification.
    
    Specified by:
    
    onLayerChanged in interface ParserListener
  - onInstrumentParsed
```
public void onInstrumentParsed(byte instrument)
```
    Description copied from interface: ParserListener
    
    Called when the parser encounters a new instrument selection.
    
    Specified by:
    
    onInstrumentParsed in interface ParserListener
    
    Parameters:
    
    instrument - the MIDI instrument value that has been parsed
  - onTempoChanged
```
public void onTempoChanged(int tempoBPM)
```
    Description copied from interface: ParserListener
    
    Called when the parser encounters a new tempo selection.
    
    Specified by:
    
    onTempoChanged in interface ParserListener
    
    Parameters:
    
    tempoBPM - The new tempo value
  - onKeySignatureParsed
```
public void onKeySignatureParsed(byte key,
                                 byte scale)
```
    Specified by:
    
    onKeySignatureParsed in interface ParserListener
  - onTimeSignatureParsed
```
public void onTimeSignatureParsed(byte numerator,
                                  byte powerOfTwo)
```
    Description copied from interface: ParserListener
    
    The first parameter is the number of beats per measure; The second parameter is the power by which 2 must be raised to create the note that represents one beat. Example 1: For a 5/8 time signature, expect 5,3 (since 2^3 = 8) Example 2: For a 4/4 time signature, expect 4,2 (since 2^2 = 4)
    
    Specified by:
    
    onTimeSignatureParsed in interface ParserListener
  - onBarLineParsed
```
public void onBarLineParsed(long time)
```
    Description copied from interface: ParserListener
    
    The separator character which indicates a bar line has been parsed. Generally, you will want to care about this if you're counting measures, but this should have no effect on the rendering of a parsed piece of music.
    
    Specified by:
    
    onBarLineParsed in interface ParserListener
    
    Parameters:
    
    time - This is the id of the measure, which is an optional numeric value following the bar character.
  - onTrackBeatTimeBookmarked
```
public void onTrackBeatTimeBookmarked(java.lang.String timeBookmarkID)
```
    Specified by:
    
    onTrackBeatTimeBookmarked in interface ParserListener
  - onTrackBeatTimeBookmarkRequested
```
public void onTrackBeatTimeBookmarkRequested(java.lang.String timeBookmarkID)
```
    Specified by:
    
    onTrackBeatTimeBookmarkRequested in interface ParserListener
  - onTrackBeatTimeRequested
```
public void onTrackBeatTimeRequested(double time)
```
    Specified by:
    
    onTrackBeatTimeRequested in interface ParserListener
  - onPitchWheelParsed
```
public void onPitchWheelParsed(byte lsb,
                               byte msb)
```
    Specified by:
    
    onPitchWheelParsed in interface ParserListener
  - onChannelPressureParsed
```
public void onChannelPressureParsed(byte pressure)
```
    Specified by:
    
    onChannelPressureParsed in interface ParserListener
  - onPolyphonicPressureParsed
```
public void onPolyphonicPressureParsed(byte key,
                                       byte pressure)
```
    Specified by:
    
    onPolyphonicPressureParsed in interface ParserListener
  - onSystemExclusiveParsed
```
public void onSystemExclusiveParsed(byte... bytes)
```
    Specified by:
    
    onSystemExclusiveParsed in interface ParserListener
  - onControllerEventParsed
```
public void onControllerEventParsed(byte controller,
                                    byte value)
```
    Specified by:
    
    onControllerEventParsed in interface ParserListener
  - onLyricParsed
```
public void onLyricParsed(java.lang.String lyric)
```
    Specified by:
    
    onLyricParsed in interface ParserListener
  - onMarkerParsed
```
public void onMarkerParsed(java.lang.String marker)
```
    Specified by:
    
    onMarkerParsed in interface ParserListener
  - onFunctionParsed
```
public void onFunctionParsed(java.lang.String id,
                             java.lang.Object message)
```
    Specified by:
    
    onFunctionParsed in interface ParserListener
  - onNotePressed
```
public void onNotePressed(Note note)
```
    Description copied from interface: ParserListener
    
    Used to indicate when a note is pressed. Used in realtime cases when notes are actually being pressed and released. Parsers that do not operate in realtime are not expected to report onNotePressed. Expect the Note event to contain only the note number and note-on velocity.
    
    Specified by:
    
    onNotePressed in interface ParserListener
  - onNoteReleased
```
public void onNoteReleased(Note note)
```
    Description copied from interface: ParserListener
    
    Used to indicate when a note is released. Used in realtime cases when notes are actually being pressed and released. Parsers that do not operate in realtime are not expected to report onNoteReleased. Expect the Note event to contain only the note number and note-off velocity. Duration may not be set on the Note from onNoteReleased.
    
    Specified by:
    
    onNoteReleased in interface ParserListener
  - onNoteParsed
```
public void onNoteParsed(Note note)
```
    Description copied from interface: ParserListener
    
    We may have actually parsed a musical note! In previous versions of JFugue, ParserListener had separate listeners for parallel notes and sequential notes (now termed harmonic and melodic notes, respectively) In this version of JFugue, whether a note is the first note, a harmonic note, or a melodic note is kept as a property on the Note object itself.
    
    Specified by:
    
    onNoteParsed in interface ParserListener
    
    Parameters:
    
    note - The note that was parsed. Please see the Note class for more details about notes!
    
    See Also:
    
    Note
  - onChordParsed
```
public void onChordParsed(Chord chord)
```
    Specified by:
    
    onChordParsed in interface ParserListener
  - onEventScheduled
```
public void onEventScheduled(long timeInMillis,
                             ScheduledEvent event)
```
  - onEventUnscheduled
```
public void onEventUnscheduled(long timeInMillis,
                               ScheduledEvent event)
```
  - onInterpolatorStarted
```
public void onInterpolatorStarted(RealtimeInterpolator interpolator,
                                  long durationInMillis)
```
  - onInterpolatorStopping
```
public void onInterpolatorStopping(RealtimeInterpolator interpolator)
```

Class RealtimeMidiParserListener

Constructor Summary

Method Summary

Methods inherited from class org.jfugue.midi.TrackTimeManager

Methods inherited from class java.lang.Object

Constructor Detail

RealtimeMidiParserListener

Method Detail

getCurrentTime

finish

getRealtimePlayer

scheduleCommand

scheduleEvent

unscheduleEvent

beforeParsingStarts

afterParsingFinished

onTrackChanged

onLayerChanged

onInstrumentParsed

onTempoChanged

onKeySignatureParsed

onTimeSignatureParsed

onBarLineParsed

onTrackBeatTimeBookmarked

onTrackBeatTimeBookmarkRequested

onTrackBeatTimeRequested

onPitchWheelParsed

onChannelPressureParsed

onPolyphonicPressureParsed

onSystemExclusiveParsed

onControllerEventParsed

onLyricParsed

onMarkerParsed

onFunctionParsed

onNotePressed

onNoteReleased

onNoteParsed

onChordParsed

onEventScheduled

onEventUnscheduled

onInterpolatorStarted

onInterpolatorStopping