MidicaPLParser (Midica 1.5.6

java.lang.Object
- org.midica.file.read.SequenceParser
- - org.midica.file.read.MidicaPLParser

All Implemented Interfaces:

IParser
```
public class MidicaPLParser
extends SequenceParser
```
This class is used to parse a MidicaPL source file.

Author:

Jan Trukenmüller

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`BANK_SEP`
`static java.lang.String`	`BAR_LINE`
`private static java.util.regex.Pattern`	`barLinePattern`
`static java.lang.String`	`BLOCK_CLOSE`
`static java.lang.String`	`BLOCK_OPEN`
`static java.lang.String`	`CALL`
`private static java.util.regex.Pattern`	`callPattern`
`static java.lang.String`	`CHORD`
`static java.lang.String`	`CHORD_ASSIGNER`
`static java.lang.String`	`CHORD_SEPARATOR`
`private static java.util.regex.Pattern`	`chordAssignPattern`
`private static java.util.TreeMap<java.lang.String,java.util.TreeSet<java.lang.Integer>>`	`chords`
`private static java.util.regex.Pattern`	`chordSepPattern`
`private static java.lang.String`	`chosenCharset`
`static java.lang.String`	`COMMENT`
`static java.lang.String`	`COMPACT_CHANNEL`
`static java.lang.String`	`COMPACT_NOTE_SEP`
`static java.lang.String`	`COMPACT_OPT_CLOSE`
`static java.lang.String`	`COMPACT_OPT_OPEN`
`private static java.util.regex.Pattern`	`compactChannelPattern`
`private static java.util.HashSet<java.lang.String>`	`compactOptionsWithoutRest`
`private static java.util.HashSet<java.lang.String>`	`compactOptionsWithRest`
`private static java.util.regex.Pattern`	`compactOptPattern`
`static java.lang.String`	`COND_EQ`
`static java.lang.String`	`COND_GE`
`static java.lang.String`	`COND_GT`
`static java.lang.String`	`COND_IN`
`static java.lang.String`	`COND_IN_SEP`
`static java.lang.String`	`COND_LE`
`static java.lang.String`	`COND_LT`
`static java.lang.String`	`COND_NDEF`
`static java.lang.String`	`COND_NEQ`
`static int`	`COND_TYPE_ELSE`
`static int`	`COND_TYPE_ELSIF`
`static int`	`COND_TYPE_IF`
`static int`	`COND_TYPE_NONE`
`private boolean`	`condChainHit`
`private boolean`	`condChainOpened`
`private static java.util.regex.Pattern`	`condInPattern`
`private static java.util.regex.Pattern`	`condPattern`
`static java.lang.String`	`CONST`
`protected static java.util.HashMap<java.lang.String,java.lang.String>`	`constants`
`private static java.util.regex.Pattern`	`crlfSkPattern`
`private java.util.ArrayList<java.lang.String>`	`currentFunction`
`private java.lang.String`	`currentFunctionName`
`private java.lang.String`	`currentLineContent`
`private int`	`currentLineNumber`
`private int`	`currentMode`
`private java.util.ArrayList<java.lang.String>`	`currentPattern`
`private java.lang.String`	`currentPatternName`
`static java.lang.String`	`D`
`static java.lang.String`	`DEFINE`
`private static java.util.HashSet<java.lang.String>`	`definedFunctionNames`
`private static java.util.HashSet<java.lang.String>`	`definedPatternNames`
`static java.lang.String`	`DOT`
`static java.lang.String`	`DURATION`
`static java.lang.String`	`DURATION_PERCENT`
`static java.lang.String`	`ELSE`
`static java.lang.String`	`ELSIF`
`static java.lang.String`	`END`
`private java.io.File`	`file`
`private static java.util.HashMap<java.lang.String,java.util.ArrayList<java.lang.String>>`	`fileCache`
`private static java.util.regex.Pattern`	`flatPattern`
`private static boolean`	`frstInstrBlkOver`
`static java.lang.String`	`FUNCTION`
`private static java.util.Deque<java.io.File>`	`functionFileStack`
`private static java.util.Deque<java.lang.Integer>`	`functionLineStack`
`private static java.util.Deque<java.lang.String>`	`functionNameStack`
`private static java.util.HashMap<java.lang.String,java.util.ArrayList<java.lang.String>>`	`functions`
`private static java.util.HashMap<java.lang.String,java.io.File>`	`functionToFile`
`private static java.util.HashMap<java.lang.String,java.lang.Integer>`	`functionToLineOffset`
`static java.lang.String`	`GLOBAL`
`static java.lang.String`	`IF`
`static java.lang.String`	`INCLUDE`
`static java.lang.String`	`INSTRUMENT`
`protected static java.util.ArrayList<Instrument>`	`instruments`
`static java.lang.String`	`INSTRUMENTS`
`private static boolean`	`instrumentsParsed`
`private static java.util.regex.Pattern`	`invalidNoteIdxPattern`
`private static boolean`	`isChInstMetaParsRun`
`private static boolean`	`isCondCheckParsRun`
`private static boolean`	`isConstParsRun`
`private static boolean`	`isDefaultParsRun`
`private static boolean`	`isDefineParsRun`
`private static boolean`	`isFuncNameParsRun`
`private static boolean`	`isFuncParsRun`
`static boolean`	`isPlayingTupletBlock`
`private boolean`	`isRootParser` Indicates if the current parser object parses the file chosen by the user.
`private static boolean`	`isSoftKaraoke`
`static java.lang.String`	`KEY_MAJ`
`static java.lang.String`	`KEY_MIN`
`static java.lang.String`	`KEY_SEPARATOR`
`static java.lang.String`	`KEY_SIG`
`static java.lang.String`	`L`
`static java.lang.String`	`LENGTH`
`static java.lang.String`	`LENGTH_1`
`static java.lang.String`	`LENGTH_16`
`static java.lang.String`	`LENGTH_2`
`static java.lang.String`	`LENGTH_32`
`static java.lang.String`	`LENGTH_4`
`static java.lang.String`	`LENGTH_8`
`static java.lang.String`	`LENGTH_M1`
`static java.lang.String`	`LENGTH_M16`
`static java.lang.String`	`LENGTH_M2`
`static java.lang.String`	`LENGTH_M32`
`static java.lang.String`	`LENGTH_M4`
`static java.lang.String`	`LENGTH_M8`
`static java.lang.String`	`LENGTH_PLUS`
`static java.lang.String`	`LENGTH_ZERO`
`static java.lang.String`	`LYRICS`
`static java.lang.String`	`LYRICS_COMMA`
`static java.lang.String`	`LYRICS_CR`
`static java.lang.String`	`LYRICS_LF`
`static java.lang.String`	`LYRICS_SPACE`
`private static LyricUtil`	`lyricUtil`
`static java.lang.String`	`M`
`static java.lang.String`	`MAGIC_VAR_ALL`
`static java.lang.String`	`MAGIC_VAR_NC`
`static java.lang.String`	`MAGIC_VAR_REV`
`private static java.util.Deque<java.util.HashMap<java.lang.String,java.lang.String>>`	`magicVarStack`
`private static int`	`MAX_RECURSION_DEPTH_CONST`
`private static int`	`MAX_RECURSION_DEPTH_FUNCTION`
`private static int`	`MAX_RECURSION_DEPTH_PATTERN`
`private static int`	`MAX_RECURSION_DEPTH_VAR`
`private static java.util.TreeMap<java.lang.Long,java.lang.Long>`	`measureLengthHistory`
`static java.lang.String`	`META`
`static java.lang.String`	`META_ARTIST`
`static java.lang.String`	`META_COMPOSER`
`static java.lang.String`	`META_COPYRIGHT`
`static java.lang.String`	`META_LYRICIST`
`static java.lang.String`	`META_SK_AUTHOR`
`static java.lang.String`	`META_SK_COPYRIGHT`
`static java.lang.String`	`META_SK_INFO`
`static java.lang.String`	`META_SK_LANG`
`static java.lang.String`	`META_SK_TITLE`
`static java.lang.String`	`META_SK_VERSION`
`static java.lang.String`	`META_SOFT_KARAOKE`
`static java.lang.String`	`META_TITLE`
`private static java.util.HashMap<java.lang.String,java.lang.StringBuilder>`	`metaInfo`
`private static int`	`MODE_DEFAULT`
`private static int`	`MODE_FUNCTION`
`private static int`	`MODE_INSTRUMENTS`
`private static int`	`MODE_META`
`private static int`	`MODE_PATTERN`
`private static int`	`MODE_SOFT_KARAOKE`
`static java.lang.String`	`MULTIPLE`
`private static int`	`nestableBlkDepth`
`private static java.util.Deque<NestableBlock>`	`nestableBlkStack`
`static java.lang.String`	`OPT_ASSIGNER`
`static java.lang.String`	`OPT_DURATION`
`static java.lang.String`	`OPT_ELSE`
`static java.lang.String`	`OPT_ELSIF`
`static java.lang.String`	`OPT_IF`
`static java.lang.String`	`OPT_LENGTH`
`static java.lang.String`	`OPT_LYRICS`
`static java.lang.String`	`OPT_MULTIPLE`
`static java.lang.String`	`OPT_QUANTITY`
`static java.lang.String`	`OPT_SEPARATOR`
`static java.lang.String`	`OPT_SHIFT`
`static java.lang.String`	`OPT_TREMOLO`
`static java.lang.String`	`OPT_TUPLET`
`static java.lang.String`	`OPT_VELOCITY`
`private static java.util.regex.Pattern`	`optAssignPattern`
`static java.lang.String`	`ORIGINAL_COMMENT`
`static java.lang.String`	`ORIGINAL_DEFINE`
`static java.lang.String`	`ORIGINAL_INCLUDE`
`static java.lang.String`	`P`
`static java.lang.String`	`PARAM_ASSIGNER`
`static java.lang.String`	`PARAM_CLOSE`
`static java.lang.String`	`PARAM_INDEX_CLOSE`
`static java.lang.String`	`PARAM_INDEX_OPEN`
`static java.lang.String`	`PARAM_NAMED_CLOSE`
`static java.lang.String`	`PARAM_NAMED_OPEN`
`static java.lang.String`	`PARAM_OPEN`
`static java.lang.String`	`PARAM_SEPARATOR`
`private static java.util.Deque<java.util.ArrayList<java.lang.String>>`	`paramStackIndexed`
`private static java.util.Deque<java.util.HashMap<java.lang.String,java.lang.String>>`	`paramStackNamed`
`static java.lang.String`	`PARTIAL_SYNC_RANGE`
`static java.lang.String`	`PARTIAL_SYNC_SEP`
`static java.lang.String`	`PATTERN`
`static java.lang.String`	`PATTERN_INDEX_SEP`
`private static java.util.Deque<java.io.File>`	`patternFileStack`
`private static java.util.Deque<java.lang.Integer>`	`patternLineStack`
`private static java.util.Deque<java.lang.String>`	`patternNameStack`
`static java.util.HashMap<java.lang.String,java.util.ArrayList<java.lang.String>>`	`patterns`
`private static java.util.HashMap<java.lang.String,java.io.File>`	`patternToFile`
`private static java.util.HashMap<java.lang.String,java.lang.Integer>`	`patternToLineOffset`
`static java.lang.String`	`PROG_BANK_SEP`
`static java.lang.String`	`Q`
`static java.lang.String`	`QUANTITY`
`private static java.util.HashSet<java.lang.String>`	`redefinitions`
`static java.lang.String`	`REST`
`private static int`	`REST_VALUE`
`static java.lang.String`	`S`
`private static java.util.regex.Pattern`	`sharpPattern`
`static java.lang.String`	`SHIFT`
`private static java.util.HashMap<java.lang.String,java.util.ArrayList<java.lang.String>>`	`softKaraokeInfo`
`static java.lang.String`	`SOUNDBANK`
`private static boolean`	`soundbankParsed`
`static java.lang.String`	`SOUNDFONT`
`private static java.util.Deque<StackTraceElement>`	`stackTrace`
`static java.lang.String`	`T`
`static java.lang.String`	`TEMPO`
`private static int`	`TICK_BANK_BEFORE_PROGRAM`
`static java.lang.String`	`TIME_SIG`
`static java.lang.String`	`TIME_SIG_SLASH`
`static java.lang.String`	`TR`
`static java.lang.String`	`TREMOLO`
`static java.lang.String`	`TRIPLET`
`static java.lang.String`	`TUPLET`
`static java.lang.String`	`TUPLET_FOR`
`static java.lang.String`	`TUPLET_INTRO`
`static java.lang.String`	`V`
`static java.lang.String`	`VAR`
`static java.lang.String`	`VAR_ASSIGNER`
`static java.lang.String`	`VAR_SYMBOL`
`private static java.util.regex.Pattern`	`varAssignPattern`
`protected static java.util.HashMap<java.lang.String,java.lang.String>`	`variables`
`private static java.util.regex.Pattern`	`varPattern`
`static java.lang.String`	`VELOCITY`
`private static java.util.regex.Pattern`	`whitespace`

Fields inherited from class org.midica.file.read.SequenceParser
transposeLevel

Constructor Summary

Constructors
Constructor and Description

MidicaPLParser(boolean isRootParser)
Creates a new MidicaPL parser.

Constructors
Constructor and Description
`MidicaPLParser(boolean isRootParser)` Creates a new MidicaPL parser.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private java.lang.String`	`addMultipleIfNotYetDone(java.lang.String original)` Adds the option MULTIPLE to an option string, if it has not yet been added.
`java.lang.String[]`	`addShift(java.lang.String[] tokens, int shift)` Adds the shift option to the given command, if it’s a note, chord or call command.
`void`	`adjustCompactNoteLength(int channel, java.lang.String length, boolean fromTupletBlock)` Sets the channel’s compact note length (and natural length) of compact commands, if necessary.
`private void`	`applySyllable(java.lang.String syllable, long tick)` Unescapes the given syllable and puts it into the MIDI sequence.
`private void`	`assertNoOpenOTO(java.lang.String dictKey)` Checks if any channel has an open one-time option for compact syntax.
`void`	`assertNoOpenOTO(java.lang.String dictKey, java.lang.String lineContent, int lineNumber)` Checks if any channel has an open one-time option for compact syntax.
`private void`	`checkBarLine(int channel, java.util.regex.Matcher barLineMatcher, int barLineCounter)` Checks if a bar line is correctly set.
`private void`	`checkIfCmdExists(java.lang.String cmd)` Throws an error if the given command does not exist.
`private void`	`checkInstrumentsParsed()` Checks if the first instruments block is expected to be parsed already and have not yet been parsed.
`private void`	`checkNesting(java.lang.String cmd)` Checks nesting of named or nestable blocks.
`private void`	`checkNestingAtEOF()` Checks nesting of named or nestable blocks at end of file.
`private void`	`checkPatternIndices(java.lang.String indicesStr)` Checks if the given string consists of comma-separated note index numbers.
`private java.lang.String`	`clean(java.lang.String input)` Cuts away any leading and trailing whitespaces from an input string and returns the resulting string.
`private java.lang.String`	`cleanLine(java.lang.String line)` Removes comments and leding and trailing whitespaces from a source code line.
`private void`	`cleanLines(java.util.ArrayList<java.lang.String> lines)` Removes comments and leding and trailing whitespaces from a whole list of source code lines.
`private void`	`compilePatterns()` Create regex patterns.
`boolean`	`evalCondition(java.lang.String condition)` Evaluates the given if/elsif condition.
`int`	`getCompactChannel(java.lang.String token)` Returns the channel of a compact (multi-note) channel command.
`boolean`	`isCompactCmd(java.lang.String token)` Checks if the given token indicates a compact (multi-note) channel command.
`boolean`	`isCompactPatternCall(java.lang.String lengthOrPatternCall)` Checks if the given string is a pattern call or a normal length definition.
`private boolean`	`isMetaCmd(java.lang.String cmd)` Determins if the given command is a META command.
`private boolean`	`mustIgnore(java.lang.String cmd)` Determins if a command must be ignored in the current parsing run and mode.
`void`	`parse(java.lang.Object fileAsObj)` Parses a MidicaPL source file.
`private void`	`parseBLOCK(java.lang.String[] tokens, boolean isFake)` Parses opening or closing a nestable block.
`private void`	`parseCALL(java.lang.String[] tokens, boolean isFake)` Parses a CALL command.
`private void`	`parseChannelCmd(java.lang.String[] tokens, boolean isFake)` Parses a channel command.
`private java.util.ArrayList<java.lang.Integer>`	`parseChord(java.lang.String token)` Analyzes the note/chord string of a channel command.
`private void`	`parseCHORD(java.lang.String[] tokens)` Parses a CHORD command.
`private boolean`	`parseChordNotes(java.lang.String[] tokens)` Splits a channel command with a chord into the single notes and applies one channel command for each note.
`private void`	`parseCompactCmd(java.lang.String[] tokens, boolean isFake)` Parses a compact (multi-note) channel command.
`java.util.ArrayList<CommandOption>`	`parseCompactOptions(java.lang.String compactElement, boolean isFake)` Parses the options of a compact element.
`private void`	`parseCONST(java.lang.String[] tokens)` Parses a CONST command.
`private void`	`parseDEFINE(java.lang.String[] tokens)` Parses a DEFINE command.
`static int`	`parseDuration(java.lang.String s)` Parses the duration string from a channel command and calculates the duration in ticks.
`private static int`	`parseDurationSummand(java.lang.String s)` Parses the duration string from one duration summand channel command and calculates the duration in ticks.
`private void`	`parseEND(java.lang.String[] tokens)` Parses an END command.
`private void`	`parseFUNCTION(java.lang.String[] tokens)` Parses a FUNCTION command.
`private void`	`parseGlobalCmd(java.lang.String[] tokens, boolean isFake)` Parses a global command.
`private void`	`parseINCLUDE(java.lang.String[] tokens)` Parses an INCLUDE command.
`private void`	`parseInstrumentCmd(java.lang.String[] tokens, boolean isFake)` Parses an instrument command inside an INSTRUMENTS block or a single line INSTRUMENT change.
`void`	`parseLine(java.lang.String line)` Parses one single line of a MidicaPL source file.
`private void`	`parseMETA(java.lang.String[] tokens)` Parses a META command.
`private void`	`parseMetaCmd(java.lang.String[] tokens)` Parses one command inside of a META block.
`private void`	`parseModeCmd(java.lang.String[] tokens)` Parses a mode command.
`private int`	`parseNote(java.lang.String noteName)` Returns the note value of a given string.
`private int`	`parseNote(java.lang.String note, int channel)` Returns the note value of a given string in the context of the given channel.
`(package private) CommandOption`	`parseOption(java.lang.String[] optParts, boolean isFake)` Parses one single command option.
`private java.util.ArrayList<CommandOption>`	`parseOptions(java.lang.String optString, boolean isFake)` Parses the options part of a command.
`private java.lang.Object[]`	`parseParameters(java.lang.String paramStr)` Parses (indexed and named) parameters of a function call or a pattern usage.
`private void`	`parsePATTERN(java.lang.String[] tokens)` Parses a PATTERN command.
`private void`	`parsePatternCall(java.lang.String[] tokens, boolean isFake)` Parses a channel call with a pattern instead of a note length.
`private void`	`parsePatternLine(java.lang.String[] tokens)` Parses a line inside of a pattern definition.
`private void`	`parseRootLevelCmd(java.lang.String[] tokens)` Parses a command that is not allowed inside of any block and has nothing to do with blocks.
`private void`	`parseSingleLineInstrumentSwitch(java.lang.String[] tokens, boolean isFake)` Parses a single line instrument switch command (outside of an instruments bock).
`private void`	`parseSOFT_KARAOKE(java.lang.String[] tokens)` Parses a SOFT_KARAOKE command.
`private void`	`parseSoftKaraokeCmd(java.lang.String[] tokens)` Parses one command inside of a SOFT_KARAOKE block.
`private void`	`parseSOUNDBANK(java.lang.String[] tokens)` Parses a SOUNDBANK command.
`private void`	`parseTokens(java.lang.String[] tokens)` Parses the tokens of one MidicaPL command.
`private void`	`parseVAR(java.lang.String[] tokens, boolean isFake)` Parses a VAR command.
`private void`	`parsingRun(java.util.ArrayList<java.lang.String> lines)` Parses all MidicaPL source lines for a specific purpose.
`private java.lang.String`	`patternIndicesToChord(java.lang.String indicesStr, java.lang.Integer[] noteNumbers)` Translates a string with comma-separated indices to a chord with comma-separated notes.
`private void`	`postprocessInstrumentsIfNotYetDone()` Postprocesses a finished INSTRUMENTS block, if not yet done.
`private void`	`postprocessMeta()` Postprocesses a finished META block.
`static void`	`refreshSyntax()` Restores the configured MidicaPL keywords and symbols.
`java.util.ArrayList<java.lang.Long>`	`rememberTickstamps()` Creates and returns a snapshot of the tickstamps of all channels.
`java.lang.String[]`	`reorganizeCompactCmd(java.lang.String[] tokens)` Transforms compact channel commands with 3 tokens to those with only 2 tokens, if necessary.
`private java.lang.String[]`	`reorganizePatternCallTokens(java.lang.String[] tokens, int indexOffset)` Ensures that (nested or real) pattern call tokens contain the pattern call and the options token in the right position.
`private java.lang.String`	`replaceConstants(java.lang.String str)` Replaces all constants in the given string by their values.
`private int`	`replaceInstrument(java.lang.String shortcut, int channel)` Transforms an instrument or drumkit name or number string into the corresponding MIDI number.
`private void`	`replaceShortcuts(java.lang.String[] tokens)` Replaces shortcuts in normal channel commands.
`java.lang.String`	`replaceVariables(java.lang.String str)` Replaces all variables (or parameters) in the given string by their values.
`private void`	`reset()` Initializes the parser for a new parsing run.
`void`	`restoreTickstamps(java.util.ArrayList<java.lang.Long> tickstamps)` Restores a snapshot of tickstamps for each channel.
`private void`	`synchronize(java.lang.String channelDesc)` Synchronizes all channels according to the given channel description.
`int`	`toChannel(java.lang.String s)` Parses a channel number.
`private float`	`toFloat(java.lang.String s)` Parses a String that is expected to be a float.
`private static int`	`toInt(java.lang.String s)` Parses a String that is expected to be an integer, accepting only values >= 0.
`private static int`	`toInt(java.lang.String s, boolean greaterZero)` Parses a String that is expected to be an integer.
`private void`	`trackNesting(java.lang.String cmd)` Tracks nesting and mode of nestable and named blocks.

Methods inherited from class org.midica.file.read.SequenceParser
getFileName, getFilePath, getTransposeLevel, postprocessSequence, preprocess, setTransposeLevel, transpose

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

- Field Detail
  - OPT_LENGTH
```
public static final java.lang.String OPT_LENGTH
```
    See Also:
    
    Constant Field Values
  - OPT_VELOCITY
```
public static final java.lang.String OPT_VELOCITY
```
    See Also:
    
    Constant Field Values
  - OPT_MULTIPLE
```
public static final java.lang.String OPT_MULTIPLE
```
    See Also:
    
    Constant Field Values
  - OPT_DURATION
```
public static final java.lang.String OPT_DURATION
```
    See Also:
    
    Constant Field Values
  - OPT_QUANTITY
```
public static final java.lang.String OPT_QUANTITY
```
    See Also:
    
    Constant Field Values
  - OPT_LYRICS
```
public static final java.lang.String OPT_LYRICS
```
    See Also:
    
    Constant Field Values
  - OPT_TUPLET
```
public static final java.lang.String OPT_TUPLET
```
    See Also:
    
    Constant Field Values
  - OPT_TREMOLO
```
public static final java.lang.String OPT_TREMOLO
```
    See Also:
    
    Constant Field Values
  - OPT_SHIFT
```
public static final java.lang.String OPT_SHIFT
```
    See Also:
    
    Constant Field Values
  - OPT_IF
```
public static final java.lang.String OPT_IF
```
    See Also:
    
    Constant Field Values
  - OPT_ELSIF
```
public static final java.lang.String OPT_ELSIF
```
    See Also:
    
    Constant Field Values
  - OPT_ELSE
```
public static final java.lang.String OPT_ELSE
```
    See Also:
    
    Constant Field Values
  - compactOptionsWithRest
```
private static final java.util.HashSet<java.lang.String> compactOptionsWithRest
```
  - compactOptionsWithoutRest
```
private static final java.util.HashSet<java.lang.String> compactOptionsWithoutRest
```
  - MODE_DEFAULT
```
private static final int MODE_DEFAULT
```
    See Also:
    
    Constant Field Values
  - MODE_INSTRUMENTS
```
private static final int MODE_INSTRUMENTS
```
    See Also:
    
    Constant Field Values
  - MODE_FUNCTION
```
private static final int MODE_FUNCTION
```
    See Also:
    
    Constant Field Values
  - MODE_PATTERN
```
private static final int MODE_PATTERN
```
    See Also:
    
    Constant Field Values
  - MODE_META
```
private static final int MODE_META
```
    See Also:
    
    Constant Field Values
  - MODE_SOFT_KARAOKE
```
private static final int MODE_SOFT_KARAOKE
```
    See Also:
    
    Constant Field Values
  - COND_TYPE_NONE
```
public static final int COND_TYPE_NONE
```
    See Also:
    
    Constant Field Values
  - COND_TYPE_IF
```
public static final int COND_TYPE_IF
```
    See Also:
    
    Constant Field Values
  - COND_TYPE_ELSIF
```
public static final int COND_TYPE_ELSIF
```
    See Also:
    
    Constant Field Values
  - COND_TYPE_ELSE
```
public static final int COND_TYPE_ELSE
```
    See Also:
    
    Constant Field Values
  - TICK_BANK_BEFORE_PROGRAM
```
private static final int TICK_BANK_BEFORE_PROGRAM
```
    See Also:
    
    Constant Field Values
  - REST_VALUE
```
private static final int REST_VALUE
```
    See Also:
    
    Constant Field Values
  - MAX_RECURSION_DEPTH_FUNCTION
```
private static final int MAX_RECURSION_DEPTH_FUNCTION
```
    See Also:
    
    Constant Field Values
  - MAX_RECURSION_DEPTH_PATTERN
```
private static final int MAX_RECURSION_DEPTH_PATTERN
```
    See Also:
    
    Constant Field Values
  - MAX_RECURSION_DEPTH_CONST
```
private static final int MAX_RECURSION_DEPTH_CONST
```
    See Also:
    
    Constant Field Values
  - MAX_RECURSION_DEPTH_VAR
```
private static final int MAX_RECURSION_DEPTH_VAR
```
    See Also:
    
    Constant Field Values
  - BANK_SEP
```
public static java.lang.String BANK_SEP
```
  - TEMPO
```
public static java.lang.String TEMPO
```
  - TIME_SIG
```
public static java.lang.String TIME_SIG
```
  - TIME_SIG_SLASH
```
public static java.lang.String TIME_SIG_SLASH
```
  - KEY_SIG
```
public static java.lang.String KEY_SIG
```
  - KEY_SEPARATOR
```
public static java.lang.String KEY_SEPARATOR
```
  - KEY_MAJ
```
public static java.lang.String KEY_MAJ
```
  - KEY_MIN
```
public static java.lang.String KEY_MIN
```
  - PARTIAL_SYNC_RANGE
```
public static java.lang.String PARTIAL_SYNC_RANGE
```
  - PARTIAL_SYNC_SEP
```
public static java.lang.String PARTIAL_SYNC_SEP
```
  - CHORD
```
public static java.lang.String CHORD
```
  - CHORD_ASSIGNER
```
public static java.lang.String CHORD_ASSIGNER
```
  - CHORD_SEPARATOR
```
public static java.lang.String CHORD_SEPARATOR
```
  - COMPACT_CHANNEL
```
public static java.lang.String COMPACT_CHANNEL
```
  - COMPACT_NOTE_SEP
```
public static java.lang.String COMPACT_NOTE_SEP
```
  - COMPACT_OPT_OPEN
```
public static java.lang.String COMPACT_OPT_OPEN
```
  - COMPACT_OPT_CLOSE
```
public static java.lang.String COMPACT_OPT_CLOSE
```
  - COMMENT
```
public static java.lang.String COMMENT
```
  - CONST
```
public static java.lang.String CONST
```
  - VAR
```
public static java.lang.String VAR
```
  - VAR_ASSIGNER
```
public static java.lang.String VAR_ASSIGNER
```
  - VAR_SYMBOL
```
public static java.lang.String VAR_SYMBOL
```
  - DEFINE
```
public static java.lang.String DEFINE
```
  - DOT
```
public static java.lang.String DOT
```
  - END
```
public static java.lang.String END
```
  - BLOCK_OPEN
```
public static java.lang.String BLOCK_OPEN
```
  - BLOCK_CLOSE
```
public static java.lang.String BLOCK_CLOSE
```
  - GLOBAL
```
public static java.lang.String GLOBAL
```
  - CALL
```
public static java.lang.String CALL
```
  - INCLUDE
```
public static java.lang.String INCLUDE
```
  - SOUNDBANK
```
public static java.lang.String SOUNDBANK
```
  - SOUNDFONT
```
public static java.lang.String SOUNDFONT
```
  - INSTRUMENT
```
public static java.lang.String INSTRUMENT
```
  - INSTRUMENTS
```
public static java.lang.String INSTRUMENTS
```
  - META
```
public static java.lang.String META
```
  - META_COPYRIGHT
```
public static java.lang.String META_COPYRIGHT
```
  - META_TITLE
```
public static java.lang.String META_TITLE
```
  - META_COMPOSER
```
public static java.lang.String META_COMPOSER
```
  - META_LYRICIST
```
public static java.lang.String META_LYRICIST
```
  - META_ARTIST
```
public static java.lang.String META_ARTIST
```
  - META_SOFT_KARAOKE
```
public static java.lang.String META_SOFT_KARAOKE
```
  - META_SK_VERSION
```
public static java.lang.String META_SK_VERSION
```
  - META_SK_LANG
```
public static java.lang.String META_SK_LANG
```
  - META_SK_TITLE
```
public static java.lang.String META_SK_TITLE
```
  - META_SK_AUTHOR
```
public static java.lang.String META_SK_AUTHOR
```
  - META_SK_COPYRIGHT
```
public static java.lang.String META_SK_COPYRIGHT
```
  - META_SK_INFO
```
public static java.lang.String META_SK_INFO
```
  - LENGTH
```
public static java.lang.String LENGTH
```
  - LENGTH_ZERO
```
public static java.lang.String LENGTH_ZERO
```
  - LENGTH_32
```
public static java.lang.String LENGTH_32
```
  - LENGTH_16
```
public static java.lang.String LENGTH_16
```
  - LENGTH_8
```
public static java.lang.String LENGTH_8
```
  - LENGTH_4
```
public static java.lang.String LENGTH_4
```
  - LENGTH_2
```
public static java.lang.String LENGTH_2
```
  - LENGTH_1
```
public static java.lang.String LENGTH_1
```
  - LENGTH_M1
```
public static java.lang.String LENGTH_M1
```
  - LENGTH_M2
```
public static java.lang.String LENGTH_M2
```
  - LENGTH_M4
```
public static java.lang.String LENGTH_M4
```
  - LENGTH_M8
```
public static java.lang.String LENGTH_M8
```
  - LENGTH_M16
```
public static java.lang.String LENGTH_M16
```
  - LENGTH_M32
```
public static java.lang.String LENGTH_M32
```
  - L
```
public static java.lang.String L
```
  - LYRICS
```
public static java.lang.String LYRICS
```
  - LYRICS_SPACE
```
public static java.lang.String LYRICS_SPACE
```
  - LYRICS_CR
```
public static java.lang.String LYRICS_CR
```
  - LYRICS_LF
```
public static java.lang.String LYRICS_LF
```
  - LYRICS_COMMA
```
public static java.lang.String LYRICS_COMMA
```
  - FUNCTION
```
public static java.lang.String FUNCTION
```
  - PATTERN
```
public static java.lang.String PATTERN
```
  - PATTERN_INDEX_SEP
```
public static java.lang.String PATTERN_INDEX_SEP
```
  - PARAM_OPEN
```
public static java.lang.String PARAM_OPEN
```
  - PARAM_CLOSE
```
public static java.lang.String PARAM_CLOSE
```
  - PARAM_SEPARATOR
```
public static java.lang.String PARAM_SEPARATOR
```
  - PARAM_ASSIGNER
```
public static java.lang.String PARAM_ASSIGNER
```
  - PARAM_NAMED_OPEN
```
public static java.lang.String PARAM_NAMED_OPEN
```
  - PARAM_NAMED_CLOSE
```
public static java.lang.String PARAM_NAMED_CLOSE
```
  - PARAM_INDEX_OPEN
```
public static java.lang.String PARAM_INDEX_OPEN
```
  - PARAM_INDEX_CLOSE
```
public static java.lang.String PARAM_INDEX_CLOSE
```
  - MAGIC_VAR_ALL
```
public static java.lang.String MAGIC_VAR_ALL
```
  - MAGIC_VAR_NC
```
public static java.lang.String MAGIC_VAR_NC
```
  - MAGIC_VAR_REV
```
public static java.lang.String MAGIC_VAR_REV
```
  - M
```
public static java.lang.String M
```
  - MULTIPLE
```
public static java.lang.String MULTIPLE
```
  - OPT_ASSIGNER
```
public static java.lang.String OPT_ASSIGNER
```
  - OPT_SEPARATOR
```
public static java.lang.String OPT_SEPARATOR
```
  - P
```
public static java.lang.String P
```
  - BAR_LINE
```
public static java.lang.String BAR_LINE
```
  - REST
```
public static java.lang.String REST
```
  - S
```
public static java.lang.String S
```
  - SHIFT
```
public static java.lang.String SHIFT
```
  - IF
```
public static java.lang.String IF
```
  - ELSIF
```
public static java.lang.String ELSIF
```
  - ELSE
```
public static java.lang.String ELSE
```
  - COND_EQ
```
public static java.lang.String COND_EQ
```
  - COND_NEQ
```
public static java.lang.String COND_NEQ
```
  - COND_NDEF
```
public static java.lang.String COND_NDEF
```
  - COND_LT
```
public static java.lang.String COND_LT
```
  - COND_LE
```
public static java.lang.String COND_LE
```
  - COND_GT
```
public static java.lang.String COND_GT
```
  - COND_GE
```
public static java.lang.String COND_GE
```
  - COND_IN
```
public static java.lang.String COND_IN
```
  - COND_IN_SEP
```
public static java.lang.String COND_IN_SEP
```
  - PROG_BANK_SEP
```
public static java.lang.String PROG_BANK_SEP
```
  - Q
```
public static java.lang.String Q
```
  - QUANTITY
```
public static java.lang.String QUANTITY
```
  - D
```
public static java.lang.String D
```
  - DURATION
```
public static java.lang.String DURATION
```
  - DURATION_PERCENT
```
public static java.lang.String DURATION_PERCENT
```
  - TR
```
public static java.lang.String TR
```
  - TREMOLO
```
public static java.lang.String TREMOLO
```
  - T
```
public static java.lang.String T
```
  - TUPLET
```
public static java.lang.String TUPLET
```
  - V
```
public static java.lang.String V
```
  - VELOCITY
```
public static java.lang.String VELOCITY
```
  - TRIPLET
```
public static java.lang.String TRIPLET
```
  - TUPLET_INTRO
```
public static java.lang.String TUPLET_INTRO
```
  - TUPLET_FOR
```
public static java.lang.String TUPLET_FOR
```
  - LENGTH_PLUS
```
public static java.lang.String LENGTH_PLUS
```
  - ORIGINAL_DEFINE
```
public static java.lang.String ORIGINAL_DEFINE
```
  - ORIGINAL_INCLUDE
```
public static java.lang.String ORIGINAL_INCLUDE
```
  - ORIGINAL_COMMENT
```
public static java.lang.String ORIGINAL_COMMENT
```
  - instruments
```
protected static java.util.ArrayList<Instrument> instruments
```
  - lyricUtil
```
private static LyricUtil lyricUtil
```
  - whitespace
```
private static java.util.regex.Pattern whitespace
```
  - fileCache
```
private static java.util.HashMap<java.lang.String,java.util.ArrayList<java.lang.String>> fileCache
```
  - functions
```
private static java.util.HashMap<java.lang.String,java.util.ArrayList<java.lang.String>> functions
```
  - functionToFile
```
private static java.util.HashMap<java.lang.String,java.io.File> functionToFile
```
  - functionToLineOffset
```
private static java.util.HashMap<java.lang.String,java.lang.Integer> functionToLineOffset
```
  - patterns
```
public static java.util.HashMap<java.lang.String,java.util.ArrayList<java.lang.String>> patterns
```
  - patternToFile
```
private static java.util.HashMap<java.lang.String,java.io.File> patternToFile
```
  - patternToLineOffset
```
private static java.util.HashMap<java.lang.String,java.lang.Integer> patternToLineOffset
```
  - chords
```
private static java.util.TreeMap<java.lang.String,java.util.TreeSet<java.lang.Integer>> chords
```
  - instrumentsParsed
```
private static boolean instrumentsParsed
```
  - metaInfo
```
private static java.util.HashMap<java.lang.String,java.lang.StringBuilder> metaInfo
```
  - softKaraokeInfo
```
private static java.util.HashMap<java.lang.String,java.util.ArrayList<java.lang.String>> softKaraokeInfo
```
  - frstInstrBlkOver
```
private static boolean frstInstrBlkOver
```
  - chosenCharset
```
private static java.lang.String chosenCharset
```
  - definedFunctionNames
```
private static java.util.HashSet<java.lang.String> definedFunctionNames
```
  - definedPatternNames
```
private static java.util.HashSet<java.lang.String> definedPatternNames
```
  - nestableBlkDepth
```
private static int nestableBlkDepth
```
  - nestableBlkStack
```
private static java.util.Deque<NestableBlock> nestableBlkStack
```
  - stackTrace
```
private static java.util.Deque<StackTraceElement> stackTrace
```
  - functionNameStack
```
private static java.util.Deque<java.lang.String> functionNameStack
```
  - functionLineStack
```
private static java.util.Deque<java.lang.Integer> functionLineStack
```
  - functionFileStack
```
private static java.util.Deque<java.io.File> functionFileStack
```
  - paramStackNamed
```
private static java.util.Deque<java.util.HashMap<java.lang.String,java.lang.String>> paramStackNamed
```
  - paramStackIndexed
```
private static java.util.Deque<java.util.ArrayList<java.lang.String>> paramStackIndexed
```
  - magicVarStack
```
private static java.util.Deque<java.util.HashMap<java.lang.String,java.lang.String>> magicVarStack
```
  - patternNameStack
```
private static java.util.Deque<java.lang.String> patternNameStack
```
  - patternLineStack
```
private static java.util.Deque<java.lang.Integer> patternLineStack
```
  - patternFileStack
```
private static java.util.Deque<java.io.File> patternFileStack
```
  - redefinitions
```
private static java.util.HashSet<java.lang.String> redefinitions
```
  - soundbankParsed
```
private static boolean soundbankParsed
```
  - constants
```
protected static java.util.HashMap<java.lang.String,java.lang.String> constants
```
  - variables
```
protected static java.util.HashMap<java.lang.String,java.lang.String> variables
```
  - varPattern
```
private static java.util.regex.Pattern varPattern
```
  - callPattern
```
private static java.util.regex.Pattern callPattern
```
  - barLinePattern
```
private static java.util.regex.Pattern barLinePattern
```
  - condPattern
```
private static java.util.regex.Pattern condPattern
```
  - condInPattern
```
private static java.util.regex.Pattern condInPattern
```
  - crlfSkPattern
```
private static java.util.regex.Pattern crlfSkPattern
```
  - sharpPattern
```
private static java.util.regex.Pattern sharpPattern
```
  - flatPattern
```
private static java.util.regex.Pattern flatPattern
```
  - optAssignPattern
```
private static java.util.regex.Pattern optAssignPattern
```
  - chordAssignPattern
```
private static java.util.regex.Pattern chordAssignPattern
```
  - varAssignPattern
```
private static java.util.regex.Pattern varAssignPattern
```
  - chordSepPattern
```
private static java.util.regex.Pattern chordSepPattern
```
  - compactChannelPattern
```
private static java.util.regex.Pattern compactChannelPattern
```
  - compactOptPattern
```
private static java.util.regex.Pattern compactOptPattern
```
  - invalidNoteIdxPattern
```
private static java.util.regex.Pattern invalidNoteIdxPattern
```
  - isSoftKaraoke
```
private static boolean isSoftKaraoke
```
  - isPlayingTupletBlock
```
public static boolean isPlayingTupletBlock
```
  - measureLengthHistory
```
private static java.util.TreeMap<java.lang.Long,java.lang.Long> measureLengthHistory
```
  - isDefineParsRun
```
private static boolean isDefineParsRun
```
  - isConstParsRun
```
private static boolean isConstParsRun
```
  - isChInstMetaParsRun
```
private static boolean isChInstMetaParsRun
```
  - isFuncNameParsRun
```
private static boolean isFuncNameParsRun
```
  - isFuncParsRun
```
private static boolean isFuncParsRun
```
  - isCondCheckParsRun
```
private static boolean isCondCheckParsRun
```
  - isDefaultParsRun
```
private static boolean isDefaultParsRun
```
  - file
```
private java.io.File file
```
  - currentLineNumber
```
private int currentLineNumber
```
  - currentLineContent
```
private java.lang.String currentLineContent
```
  - currentMode
```
private int currentMode
```
  - currentFunctionName
```
private java.lang.String currentFunctionName
```
  - currentFunction
```
private java.util.ArrayList<java.lang.String> currentFunction
```
  - currentPatternName
```
private java.lang.String currentPatternName
```
  - currentPattern
```
private java.util.ArrayList<java.lang.String> currentPattern
```
  - condChainOpened
```
private boolean condChainOpened
```
  - condChainHit
```
private boolean condChainHit
```
  - isRootParser
```
private boolean isRootParser
```
    Indicates if the current parser object parses the file chosen by the user.
    Otherwise it parses an included file.
- Constructor Detail
  - MidicaPLParser
```
public MidicaPLParser(boolean isRootParser)
```
    Creates a new MidicaPL parser.
    
    Parameters:
    
    isRootParser - true, if the parser object is created in order to parse a user-defined file. false, if the parser object is created in order to parse a file which has been included by another MidicaPL file.
- Method Detail
  - refreshSyntax
```
public static void refreshSyntax()
```
    Restores the configured MidicaPL keywords and symbols.
  - parse
```
public void parse(java.lang.Object fileAsObj)
           throws ParseException
```
    Parses a MidicaPL source file. Creates a MIDI sequence from that file.
    
    Parameters:
    
    fileAsObj - MidicaPL source file.
    
    Throws:
    
    ParseException - If the file or URL can not be parsed correctly.
  - compilePatterns
```
private void compilePatterns()
```
    Create regex patterns. This is called after the define run so that the syntax keywords cannot change any more.
  - parseLine
```
public void parseLine(java.lang.String line)
               throws ParseException
```
    Parses one single line of a MidicaPL source file. The line is expected to be cleaned already from comments and leading/trailing whitespaces. Can also be called from a NestableBlock.
    
    Parameters:
    
    line - The line to be parsed.
    
    Throws:
    
    ParseException - If the line cannot be parsed.
  - isMetaCmd
```
private boolean isMetaCmd(java.lang.String cmd)
```
    Determins if the given command is a META command.
    
    Parameters:
    
    cmd - The command to be judged.
    
    Returns:
    
    true, if cmd is a meta command, otherwise: false.
  - rememberTickstamps
```
public java.util.ArrayList<java.lang.Long> rememberTickstamps()
                                                       throws ParseException
```
    Creates and returns a snapshot of the tickstamps of all channels. The indexes of the returned structure are the channels. The values are the tickstamps.
    
    Returns:
    
    snapshot of tickstamps
    
    Throws:
    
    ParseException - if something went wrong.
  - restoreTickstamps
```
public void restoreTickstamps(java.util.ArrayList<java.lang.Long> tickstamps)
```
    Restores a snapshot of tickstamps for each channel.
    
    Parameters:
    
    tickstamps - the tickstamps to be restored - indexes are channels, values are tickstamps.
  - toChannel
```
public int toChannel(java.lang.String s)
              throws ParseException
```
    Parses a channel number.
    
    Parameters:
    
    s - Channel number string.
    
    Returns:
    
    Parsed channel number.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parsingRun
```
private void parsingRun(java.util.ArrayList<java.lang.String> lines)
                 throws ParseException,
                        java.io.IOException
```
    Parses all MidicaPL source lines for a specific purpose. E.g. find definition commands, chords, functions, and so on.
    
    Parameters:
    
    lines - All lines of the MidicaPL source.
    
    Throws:
    
    ParseException - if one of the lines cannot be parsed.
    
    java.io.IOException - if the file path cannot be calculated.
  - parseTokens
```
private void parseTokens(java.lang.String[] tokens)
                  throws ParseException
```
    Parses the tokens of one MidicaPL command.
    
    Parameters:
    
    tokens - The tokens from one MidicaPL line.
    
    Throws:
    
    ParseException - If the tokens cannot be parsed.
  - checkIfCmdExists
```
private void checkIfCmdExists(java.lang.String cmd)
                       throws ParseException
```
    Throws an error if the given command does not exist.
    
    Each command is also checked at the place it’s parsed. But sometimes this is too late. Different parsing runs ignore different lines, so that the real error is not shown but a consecutive error with a much higher line number.
    
    Example:
```
DEFINE CHORD CRD
// ...
CHORD cmay c,e,g
// ...
0 cmay /4
```
    This would say: unknown note: cmay
    
    But correct is: unknown command: CHORD
    
    We need this check early or otherwise the error messages could be confusing.
    Parameters:
    
    cmd - The command to be checked
    
    Throws:
    
    ParseException - if the command does not exist.
  - mustIgnore
```
private boolean mustIgnore(java.lang.String cmd)
                    throws ParseException
```
    Determins if a command must be ignored in the current parsing run and mode.
    
    Also sets the current mode or nesting depth, if this is required but no further parsing is needed.
    
    This is called for each line in each parsing run.
    
    There are different parsing runs, in the following order:
    - parse define commands
    - parse chords and the first instruments block
    - get all needed function names from call commands
    - parse functions
    - parse everything else
    Parameters:
    
    cmd - The first token in the line
    
    Returns:
    
    true, if the current line must be ignored.
    
    Throws:
    
    ParseException - if this method is called without configuring the parsing run before.
  - trackNesting
```
private void trackNesting(java.lang.String cmd)
```
    Tracks nesting and mode of nestable and named blocks. Used only if nothing more is needed. Otherwise the nesting will be tracked by the according parse method.
    
    Parameters:
    
    cmd - command to be tracked
  - checkNesting
```
private void checkNesting(java.lang.String cmd)
                   throws ParseException
```
    Checks nesting of named or nestable blocks.
    
    Parameters:
    
    cmd - The command to be checked
    
    Throws:
    
    ParseException - if the check fails.
  - checkNestingAtEOF
```
private void checkNestingAtEOF()
                        throws ParseException
```
    Checks nesting of named or nestable blocks at end of file.
    
    Throws:
    
    ParseException - if the check fails.
  - checkInstrumentsParsed
```
private void checkInstrumentsParsed()
                             throws ParseException
```
    Checks if the first instruments block is expected to be parsed already and have not yet been parsed. In this case an exception is thrown.
    - Does nothing if called in the wrong parsing run.
    - Does nothing if the instruments are already parsed.
    - Does nothing instruments are currently being parsed.
    Throws:
    
    ParseException - the first instruments block has not yet been parsed.
  - replaceShortcuts
```
private void replaceShortcuts(java.lang.String[] tokens)
                       throws ParseException
```
    Replaces shortcuts in normal channel commands.
    
    The following shortcuts are replaced:
    - percussion channel shortcut (this is also replaced for instrument commands)
    - note names
    - percussion shortcuts
    Parameters:
    
    tokens - Channel command token array.
    
    Throws:
    
    ParseException - if something goes wrong
  - replaceInstrument
```
private int replaceInstrument(java.lang.String shortcut,
                              int channel)
                       throws ParseException
```
    Transforms an instrument or drumkit name or number string into the corresponding MIDI number.
    
    This is only called while a command inside an INSTRUMENTS block is parsed.
    
    Parameters:
    
    shortcut - String containing the instrument/drumkit name or number
    
    channel - MIDI channel number
    
    Throws:
    
    ParseException - if the given shortcut is neither a valid shortcut nor a valid number.
  - parseDuration
```
public static int parseDuration(java.lang.String s)
                         throws ParseException
```
    Parses the duration string from a channel command and calculates the duration in ticks.
    
    The duration can be a sum of durations, separated by + characters.
    
    Parameters:
    
    s - The duration string, extracted from the MidicaPL line.
    
    Returns:
    
    The duration of the note in ticks.
    
    Throws:
    
    ParseException - If the duration string cannot be parsed.
  - parseDurationSummand
```
private static int parseDurationSummand(java.lang.String s)
                                 throws ParseException
```
    Parses the duration string from one duration summand channel command and calculates the duration in ticks.
    
    Parameters:
    
    s - One duration summand, extracted from the MidicaPL line.
    
    Returns:
    
    The duration of the summand in ticks.
    
    Throws:
    
    ParseException - If the duration summand cannot be parsed.
  - parseModeCmd
```
private void parseModeCmd(java.lang.String[] tokens)
                   throws ParseException
```
    Parses a mode command.
    
    This is one of the following commands:
    - INSTRUMENTS
    - FUNCTION
    - PATTERN
    - META
    - SOFT_KARAOKE
    - END
    Determines the type of mode command and calls the appropriate method to parse that command type.
    Parameters:
    
    tokens - Mode command token array.
    
    Throws:
    
    ParseException - If the mode command cannot be parsed.
  - parseRootLevelCmd
```
private void parseRootLevelCmd(java.lang.String[] tokens)
                        throws ParseException
```
    Parses a command that is not allowed inside of any block and has nothing to do with blocks.
    
    This is one of the following commands:
    - DEFINE
    - CHORD
    - INCLUDE
    - SOUNDBANK
    Checks if we are in the root level.
    
    Determines the type of root-level command and calls the appropriate method to parse that command.
    Parameters:
    
    tokens - Mode command token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed or is inside of a block.
  - parseEND
```
private void parseEND(java.lang.String[] tokens)
               throws ParseException
```
    Parses an END command. An END command is a mode command that finishes a previously opened mode.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseFUNCTION
```
private void parseFUNCTION(java.lang.String[] tokens)
                    throws ParseException
```
    Parses a FUNCTION command. A FUNCTION command is a mode command that opens a FUNCTION definition.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parsePATTERN
```
private void parsePATTERN(java.lang.String[] tokens)
                   throws ParseException
```
    Parses a PATTERN command. A PATTERN command is a mode command that opens a PATTERN definition.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseMETA
```
private void parseMETA(java.lang.String[] tokens)
                throws ParseException
```
    Parses a META command. A META command is a mode command that opens a META definition block.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseSOFT_KARAOKE
```
private void parseSOFT_KARAOKE(java.lang.String[] tokens)
                        throws ParseException
```
    Parses a SOFT_KARAOKE command. A SOFT_KARAOKE command is a mode command that opens a SOFT_KARAOKE definition block inside of a META block.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseBLOCK
```
private void parseBLOCK(java.lang.String[] tokens,
                        boolean isFake)
                 throws ParseException
```
    Parses opening or closing a nestable block. By default, that is { or }.
    
    Parameters:
    
    tokens - Token array.
    
    isFake - true, if this is called inside a function definition or block.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseCHORD
```
private void parseCHORD(java.lang.String[] tokens)
                 throws ParseException
```
    Parses a CHORD command. A CHORD command defines which a new chord name and describes the included notes.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseCALL
```
private void parseCALL(java.lang.String[] tokens,
                       boolean isFake)
                throws ParseException
```
    Parses a CALL command. A CALL command calls a previously defined FUNCTION.
    
    Parameters:
    
    tokens - Token array.
    
    isFake - true, if this is called inside a function definition or block
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parsePatternCall
```
private void parsePatternCall(java.lang.String[] tokens,
                              boolean isFake)
                       throws ParseException
```
    Parses a channel call with a pattern instead of a note length.
    
    Parameters:
    
    tokens - Token array.
    
    isFake - true, if this is called inside a function definition or block
    
    Throws:
    
    ParseException - if something is wrong.
  - patternIndicesToChord
```
private java.lang.String patternIndicesToChord(java.lang.String indicesStr,
                                               java.lang.Integer[] noteNumbers)
                                        throws ParseException
```
    Translates a string with comma-separated indices to a chord with comma-separated notes.
    
    Needed for pattern calls.
    
    Parameters:
    
    indicesStr - the comma-separated indices string (e.g. “0,2,3”)
    
    noteNumbers - the note numbers to be used for the chord (e.g. [64, 66, 67, 76])
    
    Returns:
    
    the chord (e.g. “64,67,76”)
    
    Throws:
    
    ParseException - if an index is not a positie integer or too high for the given noteNumbers.
  - parseParameters
```
private java.lang.Object[] parseParameters(java.lang.String paramStr)
                                    throws ParseException
```
    Parses (indexed and named) parameters of a function call or a pattern usage.
    
    Returns the indexed parameters in index 0 and the named parameters in index 1 of the returned array.
    - Indexed parameters: ArrayList
    - Named parameters: HashMap<String, String>
    Parameters:
    
    paramStr - the parameter string
    
    Returns:
    
    indexed and named parameters as described above.
    
    Throws:
    
    ParseException - if something is wrong with the parameter string.
  - parsePatternLine
```
private void parsePatternLine(java.lang.String[] tokens)
                       throws ParseException
```
    Parses a line inside of a pattern definition.
    
    Parameters:
    
    tokens - command tokens
    
    Throws:
    
    ParseException - if something is wrong.
  - checkPatternIndices
```
private void checkPatternIndices(java.lang.String indicesStr)
                          throws ParseException
```
    Checks if the given string consists of comma-separated note index numbers.
    
    Needed to check a pattern at pattern line parsing time (before any pattern call).
    
    Parameters:
    
    indicesStr -
    
    Throws:
    
    ParseException
  - reorganizePatternCallTokens
```
private java.lang.String[] reorganizePatternCallTokens(java.lang.String[] tokens,
                                                       int indexOffset)
                                                throws ParseException
```
    Ensures that (nested or real) pattern call tokens contain the pattern call and the options token in the right position.
    
    For real pattern calls:
    - index 0: channel
    - index 1: chord
    - index 2: pattern call
    - index 3: options
    For nested pattern calls:
    - index 0: chord
    - index 1: pattern call
    - index 2: options
    For nested compact pattern calls:
    - index 0: :
    - index 1: the rest
    Parameters:
    
    tokens - tokens to be checked or changed
    
    indexOffset - pattern call index (**2** for real calls, 1 for nested calls)
    
    Returns:
    
    the corrected tokens, if changed, or the original tokens, if no change was necessary.
    
    Throws:
    
    ParseException - on syntax errors.
  - applySyllable
```
private void applySyllable(java.lang.String syllable,
                           long tick)
                    throws ParseException
```
    Unescapes the given syllable and puts it into the MIDI sequence.
    
    Takes care about SoftKaraoke.
    
    Parameters:
    
    syllable - the syllable to be unescaped.
    
    tick - the tick when the syllable occurs.
    
    Throws:
    
    ParseException - if a MIDI problem occurs.
  - evalCondition
```
public boolean evalCondition(java.lang.String condition)
                      throws ParseException
```
    Evaluates the given if/elsif condition.
    
    Parameters:
    
    condition - the condition to be evaluated.
    
    Returns:
    
    true, if the condition evaluates to true, otherwise: false.
    
    Throws:
    
    ParseException - if the condition is invalid
  - addShift
```
public java.lang.String[] addShift(java.lang.String[] tokens,
                                   int shift)
                            throws ParseException
```
    Adds the shift option to the given command, if it’s a note, chord or call command. Applies the shift option to all notes, if it’s a compact command.
    
    Parameters:
    
    tokens - command tokens
    
    Returns:
    
    the resulting command tokens.
    
    Throws:
    
    ParseException - if something goes wrong.
  - parseINCLUDE
```
private void parseINCLUDE(java.lang.String[] tokens)
                   throws ParseException
```
    Parses an INCLUDE command. An INCLUDE command parses another MidicaPL source file. Therefore another parser instance of this class is created.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseSOUNDBANK
```
private void parseSOUNDBANK(java.lang.String[] tokens)
                     throws ParseException
```
    Parses a SOUNDBANK command. A SOUNDBANK command includes a soundbank by file path or URL.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the soundbank cannot be loaded.
  - parseDEFINE
```
private void parseDEFINE(java.lang.String[] tokens)
                  throws ParseException
```
    Parses a DEFINE command. A DEFINE command is used to re-define a mode command name.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseCONST
```
private void parseCONST(java.lang.String[] tokens)
                 throws ParseException
```
    Parses a CONST command. A CONST command is used to define a constant.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseVAR
```
private void parseVAR(java.lang.String[] tokens,
                      boolean isFake)
               throws ParseException
```
    Parses a VAR command. A VAR command is used to define and/or (re)assign a variable.
    
    Parameters:
    
    tokens - Token array.
    
    isFake - true, if this is called inside a function definition or block
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - replaceConstants
```
private java.lang.String replaceConstants(java.lang.String str)
                                   throws ParseException
```
    Replaces all constants in the given string by their values.
    
    Parameters:
    
    str - The string to be replaced.
    
    Returns:
    
    The resulting string.
    
    Throws:
    
    ParseException - if the recursion depth is too high
  - replaceVariables
```
public java.lang.String replaceVariables(java.lang.String str)
                                  throws ParseException
```
    Replaces all variables (or parameters) in the given string by their values.
    
    Parameters:
    
    str - The string to be replaced.
    
    Returns:
    
    The resulting string.
    
    Throws:
    
    ParseException - if an undefined variable is found or the recursion depth is too high.
  - parseSingleLineInstrumentSwitch
```
private void parseSingleLineInstrumentSwitch(java.lang.String[] tokens,
                                             boolean isFake)
                                      throws ParseException
```
    Parses a single line instrument switch command (outside of an instruments bock).
    
    Parameters:
    
    tokens - Token array.
    
    isFake - true, if this is called inside a function definition or block
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseInstrumentCmd
```
private void parseInstrumentCmd(java.lang.String[] tokens,
                                boolean isFake)
                         throws ParseException
```
    Parses an instrument command inside an INSTRUMENTS block or a single line INSTRUMENT change. This command assigns a certain instrument to a certain channel. A bank number can also be assigned for the channel.
    
    TODO: test soundbanks with bankLSB > 0
    
    Parameters:
    
    tokens - Token array.
    
    isFake - true, if this is called inside a function definition or block
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseMetaCmd
```
private void parseMetaCmd(java.lang.String[] tokens)
                   throws ParseException
```
    Parses one command inside of a META block.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseSoftKaraokeCmd
```
private void parseSoftKaraokeCmd(java.lang.String[] tokens)
                          throws ParseException
```
    Parses one command inside of a SOFT_KARAOKE block.
    
    Parameters:
    
    tokens - Token array.
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseGlobalCmd
```
private void parseGlobalCmd(java.lang.String[] tokens,
                            boolean isFake)
                     throws ParseException
```
    Parses a global command. Global commands apply to every channel. So they always contain a syncronization of the current ticks of each channel.
    
    Parameters:
    
    tokens - Token array.
    
    isFake - true, if this is called inside a function definition or block
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - getCompactChannel
```
public int getCompactChannel(java.lang.String token)
                      throws ParseException
```
    Returns the channel of a compact (multi-note) channel command.
    
    Parameters:
    
    token - the command (first token) to be checked
    
    Returns:
    
    the channel number
    
    Throws:
    
    ParseException - if the channel cannot be determined
  - reorganizeCompactCmd
```
public java.lang.String[] reorganizeCompactCmd(java.lang.String[] tokens)
                                        throws ParseException
```
    Transforms compact channel commands with 3 tokens to those with only 2 tokens, if necessary.
    
    Needed in order to apply tuplets or shifts.
    
    Parameters:
    
    tokens - the original tokens
    
    Returns:
    
    the reorganized tokens
    
    Throws:
    
    ParseException - if the given tokens contain more than 3 elements
  - isCompactCmd
```
public boolean isCompactCmd(java.lang.String token)
```
    Checks if the given token indicates a compact (multi-note) channel command.
    
    Parameters:
    
    token - the command (first token) to be checked
    
    Returns:
    
    true if the token indicates a compact channel command; otherwise false.
  - parseCompactCmd
```
private void parseCompactCmd(java.lang.String[] tokens,
                             boolean isFake)
                      throws ParseException
```
    Parses a compact (multi-note) channel command.
    
    Parameters:
    
    tokens - Token array.
    
    isFake - true, if this is called inside a function definition or block
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - isCompactPatternCall
```
public boolean isCompactPatternCall(java.lang.String lengthOrPatternCall)
```
    Checks if the given string is a pattern call or a normal length definition.
    
    Parameters:
    
    lengthOrPatternCall - pattern call or length definition
    
    Returns:
    
    true if the string is a pattern call, otherwise false
  - adjustCompactNoteLength
```
public void adjustCompactNoteLength(int channel,
                                    java.lang.String length,
                                    boolean fromTupletBlock)
```
    Sets the channel’s compact note length (and natural length) of compact commands, if necessary.
    
    Parameters:
    
    channel - MIDI channel
    
    length - length string from the syntax
    
    fromTupletBlock - true if called from a tuplet block, otherwise false
  - parseChannelCmd
```
private void parseChannelCmd(java.lang.String[] tokens,
                             boolean isFake)
                      throws ParseException
```
    Parses a channel command. A channel command is a channel-based command like a note or a rest.
    
    Parameters:
    
    tokens - Token array.
    
    isFake - true, if this is called inside a function definition or block
    
    Throws:
    
    ParseException - If the command cannot be parsed.
  - parseCompactOptions
```
public java.util.ArrayList<CommandOption> parseCompactOptions(java.lang.String compactElement,
                                                              boolean isFake)
                                                       throws ParseException
```
    Parses the options of a compact element.
    
    An element with compact options looks like: (name1=value1,name2=value2,…). If another type of compact element is given, null is returned.
    
    Parameters:
    
    compactElement - the element to be parsed
    
    isFake - true, if this is called inside a function definition, pattern definition or block.
    
    Returns:
    
    the options with their values, or null if the given element doesn’t contain options.
    
    Throws:
    
    ParseException - if the options cannot be parsed.
  - parseOptions
```
private java.util.ArrayList<CommandOption> parseOptions(java.lang.String optString,
                                                        boolean isFake)
                                                 throws ParseException
```
    Parses the options part of a command.
    
    The options may still contain unreplaced variables or parameters. These are replaced or left as-is. This depends on the current parsing run, the given isFake parameter, and other criteria.
    
    Parameters:
    
    optString - The raw options string of the command to be parsed.
    
    isFake - true, if this is called inside a function definition, pattern definition or block.
    
    Returns:
    
    All options and their values that have been found in the provided options string.
    
    Throws:
    
    ParseException - if the options cannot be parsed.
  - parseOption
```
CommandOption parseOption(java.lang.String[] optParts,
                          boolean isFake)
                   throws ParseException
```
    Parses one single command option.
    
    The given optParts may have one or two elements.
    
    The first element is the option name. The second element is the option’s value.
    
    Parameters:
    
    optParts - first element: name; second element: value (optional)
    
    isFake - true, if this is called inside a function definition, pattern definition or block.
    
    Returns:
    
    a parsed option, or null if it’s too early to parse the option.
    
    Throws:
    
    ParseException - if the options cannot be parsed.
  - parseNote
```
private int parseNote(java.lang.String note,
                      int channel)
               throws ParseException
```
    Returns the note value of a given string in the context of the given channel. (Used to parse a note from a channel command)
    
    The string can be:
    - the pause character (in this case REST_VALUE is returned)
    - the note value in numeric characters
    - the note name as defined by the chosen configuration (if the channel is not the percussion channel)
    - the percussion name as defined by the chosen configutation (if channel is 9)
    Parameters:
    
    note - The note string to be parsed.
    
    channel - The channel number.
    
    Returns:
    
    MIDI note value of the given note
    
    Throws:
    
    ParseExceptionif - the note or percussion name is unknown or the note value is out of the legal range for MIDI notes
    
    ParseException
  - parseNote
```
private int parseNote(java.lang.String noteName)
               throws ParseException
```
    Returns the note value of a given string. (Used for parsing a note from a chord definition)
    
    The string can be:
    - the note value in numeric characters
    - the note name as defined by the chosen configuration
    Parameters:
    
    noteName - string defining the note
    
    Returns:
    
    MIDI note value of the given note
    
    Throws:
    
    ParseException - if the note name is unknown or the note value is out of the legal range for MIDI notes
  - parseChord
```
private java.util.ArrayList<java.lang.Integer> parseChord(java.lang.String token)
                                                   throws ParseException
```
    Analyzes the note/chord string of a channel command. This token can be a note string, a note number, a predefined chord or an inline chord, consisting of any combination of the former.
    
    Parameters:
    
    token - The note/chord part of a channel command (second column).
    
    Returns:
    
    a collection of all included notes, or null, if the token contains only a single note.
    
    Throws:
    
    ParseException - if one of the notes cannot be parsed.
  - parseChordNotes
```
private boolean parseChordNotes(java.lang.String[] tokens)
                         throws ParseException
```
    Splits a channel command with a chord into the single notes and applies one channel command for each note.
    
    Parameters:
    
    tokens - Token array.
    
    Returns:
    
    true, if the channel command contains a chord, otherwise false.
    
    Throws:
    
    ParseException - if one of the notes cannot be parsed.
  - addMultipleIfNotYetDone
```
private java.lang.String addMultipleIfNotYetDone(java.lang.String original)
                                          throws ParseException
```
    Adds the option MULTIPLE to an option string, if it has not yet been added. This is used if a note of a predefined chord is produced - so that the next note of the same chord starts at the same tick.
    
    Parameters:
    
    original - token containing the velocity and the option string: token[2]
    
    Returns:
    
    same token but with the MULTIPLE option
    
    Throws:
    
    ParseException - if the original options cannot be parsed
  - assertNoOpenOTO
```
public void assertNoOpenOTO(java.lang.String dictKey,
                            java.lang.String lineContent,
                            int lineNumber)
                     throws ParseException
```
    Checks if any channel has an open one-time option for compact syntax. In this case, an exception is thrown.
    
    Parameters:
    
    dictKey - dictionary key for the error message
    
    lineContent - content of the opening or closing line of the block
    
    lineNumber - line number causing the problem (opening or closing of the block)
    
    Throws:
    
    ParseException - if an open one-time option is found.
  - assertNoOpenOTO
```
private void assertNoOpenOTO(java.lang.String dictKey)
                      throws ParseException
```
    Checks if any channel has an open one-time option for compact syntax. In this case, an exception is thrown.
    
    Parameters:
    
    dictKey - dictionary key for the error message
    
    Throws:
    
    ParseException - if an open one-time option is found.
  - synchronize
```
private void synchronize(java.lang.String channelDesc)
                  throws ParseException
```
    Synchronizes all channels according to the given channel description. Sets the current ticks of each of these channels to the value of the channel with the maximum current tick value.
    
    Parameters:
    
    channelDesc - channel description (e.g. “1-3,5,7-p”)
    
    Throws:
    
    ParseException - If the channel description cannot be parsed.
  - postprocessInstrumentsIfNotYetDone
```
private void postprocessInstrumentsIfNotYetDone()
                                         throws ParseException
```
    Postprocesses a finished INSTRUMENTS block, if not yet done.
    
    In this case:
    - Initializes the percussion channel.
    - Initializes all necessary data structures for all channels.
    Thereby all undefined channels will be initialized with a fake instrument so that the data structures work.
    Throws:
    
    ParseException - if something went wrong.
  - postprocessMeta
```
private void postprocessMeta()
                      throws ParseException
```
    Postprocesses a finished META block.
    
    Sets all defined meta events in the MIDI sequence.
    
    Throws:
    
    ParseException - if something went wrong.
  - toInt
```
private static int toInt(java.lang.String s,
                         boolean greaterZero)
                  throws ParseException
```
    Parses a String that is expected to be an integer.
    - If greaterZero is true: Accepts only values > 0
    - If greaterZero is false: Accepts everything (including negative values)
    Parameters:
    
    s - The string to be parsed.
    
    greaterZero - true, if only positive integers are allowed. false, if negative values are allowed.
    
    Returns:
    
    The parsed value.
    
    Throws:
    
    ParseException - If the string cannot be parsed.
  - toInt
```
private static int toInt(java.lang.String s)
                  throws ParseException
```
    Parses a String that is expected to be an integer, accepting only values >= 0.
    
    Parameters:
    
    s - The string to be parsed.
    
    Returns:
    
    The parsed value.
    
    Throws:
    
    ParseException - If the string cannot be parsed.
  - toFloat
```
private float toFloat(java.lang.String s)
               throws ParseException
```
    Parses a String that is expected to be a float.
    
    Parameters:
    
    s - The string to be parsed.
    
    Returns:
    
    The parsed value.
    
    Throws:
    
    ParseException - If the string cannot be parsed.
  - clean
```
private java.lang.String clean(java.lang.String input)
```
    Cuts away any leading and trailing whitespaces from an input string and returns the resulting string.
    
    Parameters:
    
    input - The string to be cleaned.
    
    Returns:
    
    Resulting string without leading or trailing whitespaces.
  - cleanLine
```
private java.lang.String cleanLine(java.lang.String line)
```
    Removes comments and leding and trailing whitespaces from a source code line.
    
    Parameters:
    
    line - The source code line.
    
    Returns:
    
    the cleaned line.
  - cleanLines
```
private void cleanLines(java.util.ArrayList<java.lang.String> lines)
```
    Removes comments and leding and trailing whitespaces from a whole list of source code lines.
    
    Parameters:
    
    lines - The source code lines to be cleaned.
  - checkBarLine
```
private void checkBarLine(int channel,
                          java.util.regex.Matcher barLineMatcher,
                          int barLineCounter)
                   throws ParseException
```
    Checks if a bar line is correctly set. Otherwise, throws an exception.
    
    Parameters:
    
    channel - midi channel
    
    barLineMatcher - the matcher matching the bar line (and maybe the tolerance value)
    
    barLineCounter - the bar line number to be checked (1st, 2nd, …) inside the compact command
    
    Throws:
    
    ParseException - if the bar line check fails
  - reset
```
private void reset()
            throws ParseException
```
    Initializes the parser for a new parsing run. This is called at the beginning of parse().
    
    Throws:
    
    ParseException - if sequence creation fails.

Class MidicaPLParser

Field Summary

Fields inherited from class org.midica.file.read.SequenceParser

Constructor Summary

Method Summary

Methods inherited from class org.midica.file.read.SequenceParser

Methods inherited from class java.lang.Object

Field Detail

OPT_LENGTH

OPT_VELOCITY

OPT_MULTIPLE

OPT_DURATION

OPT_QUANTITY

OPT_LYRICS

OPT_TUPLET

OPT_TREMOLO

OPT_SHIFT

OPT_IF

OPT_ELSIF

OPT_ELSE

compactOptionsWithRest

compactOptionsWithoutRest

MODE_DEFAULT

MODE_INSTRUMENTS

MODE_FUNCTION

MODE_PATTERN

MODE_META

MODE_SOFT_KARAOKE

COND_TYPE_NONE

COND_TYPE_IF

COND_TYPE_ELSIF

COND_TYPE_ELSE

TICK_BANK_BEFORE_PROGRAM

REST_VALUE

MAX_RECURSION_DEPTH_FUNCTION

MAX_RECURSION_DEPTH_PATTERN

MAX_RECURSION_DEPTH_CONST

MAX_RECURSION_DEPTH_VAR

BANK_SEP

TEMPO

TIME_SIG

TIME_SIG_SLASH

KEY_SIG

KEY_SEPARATOR

KEY_MAJ

KEY_MIN

PARTIAL_SYNC_RANGE

PARTIAL_SYNC_SEP

CHORD

CHORD_ASSIGNER

CHORD_SEPARATOR

COMPACT_CHANNEL

COMPACT_NOTE_SEP

COMPACT_OPT_OPEN

COMPACT_OPT_CLOSE

COMMENT

CONST

VAR

VAR_ASSIGNER

VAR_SYMBOL

DEFINE

DOT

END

BLOCK_OPEN

BLOCK_CLOSE

GLOBAL

CALL

INCLUDE

SOUNDBANK

SOUNDFONT

INSTRUMENT

INSTRUMENTS

META

META_COPYRIGHT

META_TITLE

META_COMPOSER

META_LYRICIST

META_ARTIST

META_SOFT_KARAOKE

META_SK_VERSION