Package org.jfugue.parser
Class ParserListenerAdapter
- java.lang.Object
-
- org.jfugue.parser.ParserListenerAdapter
-
- All Implemented Interfaces:
ParserListener
- Direct Known Subclasses:
ComputeDurationForEachTrackTool
,GetInstrumentsUsedTool
,LilyPondParserListener
public class ParserListenerAdapter extends java.lang.Object implements ParserListener
-
-
Constructor Summary
Constructors Constructor Description ParserListenerAdapter()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method 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
onBarLineParsed(long id)
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
onFunctionParsed(java.lang.String id, java.lang.Object message)
void
onInstrumentParsed(byte instrument)
Called when the parser encounters a new instrument selection.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).
-
-
-
Method Detail
-
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 interfaceParserListener
-
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 interfaceParserListener
-
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 interfaceParserListener
- 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 interfaceParserListener
-
onInstrumentParsed
public void onInstrumentParsed(byte instrument)
Description copied from interface:ParserListener
Called when the parser encounters a new instrument selection.- Specified by:
onInstrumentParsed
in interfaceParserListener
- 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 interfaceParserListener
- Parameters:
tempoBPM
- The new tempo value
-
onKeySignatureParsed
public void onKeySignatureParsed(byte key, byte scale)
- Specified by:
onKeySignatureParsed
in interfaceParserListener
-
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 interfaceParserListener
-
onBarLineParsed
public void onBarLineParsed(long id)
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 interfaceParserListener
- Parameters:
id
- 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 interfaceParserListener
-
onTrackBeatTimeBookmarkRequested
public void onTrackBeatTimeBookmarkRequested(java.lang.String timeBookmarkId)
- Specified by:
onTrackBeatTimeBookmarkRequested
in interfaceParserListener
-
onTrackBeatTimeRequested
public void onTrackBeatTimeRequested(double time)
- Specified by:
onTrackBeatTimeRequested
in interfaceParserListener
-
onPitchWheelParsed
public void onPitchWheelParsed(byte lsb, byte msb)
- Specified by:
onPitchWheelParsed
in interfaceParserListener
-
onChannelPressureParsed
public void onChannelPressureParsed(byte pressure)
- Specified by:
onChannelPressureParsed
in interfaceParserListener
-
onPolyphonicPressureParsed
public void onPolyphonicPressureParsed(byte key, byte pressure)
- Specified by:
onPolyphonicPressureParsed
in interfaceParserListener
-
onSystemExclusiveParsed
public void onSystemExclusiveParsed(byte... bytes)
- Specified by:
onSystemExclusiveParsed
in interfaceParserListener
-
onControllerEventParsed
public void onControllerEventParsed(byte controller, byte value)
- Specified by:
onControllerEventParsed
in interfaceParserListener
-
onLyricParsed
public void onLyricParsed(java.lang.String lyric)
- Specified by:
onLyricParsed
in interfaceParserListener
-
onMarkerParsed
public void onMarkerParsed(java.lang.String marker)
- Specified by:
onMarkerParsed
in interfaceParserListener
-
onFunctionParsed
public void onFunctionParsed(java.lang.String id, java.lang.Object message)
- Specified by:
onFunctionParsed
in interfaceParserListener
-
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 interfaceParserListener
-
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 interfaceParserListener
-
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 interfaceParserListener
- 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 interfaceParserListener
-
-