abcjs-rails 1.1.0 → 1.1.1

data/app/assets/javascripts/abcjs/parse/abc_parse_directive.js

@@ -0,0 +1,546 @@
+/*global window */
+
+if (!window.ABCJS)
+	window.ABCJS = {};
+
+if (!window.ABCJS.parse)
+	window.ABCJS.parse = {};
+
+window.ABCJS.parse.parseDirective = {};
+
+(function() {
+	var tokenizer;
+	var warn;
+	var multilineVars;
+	var tune;
+	window.ABCJS.parse.parseDirective.initialize = function(tokenizer_, warn_, multilineVars_, tune_) {
+		tokenizer = tokenizer_;
+		warn = warn_;
+		multilineVars = multilineVars_;
+		tune = tune_;
+	};
+
+	window.ABCJS.parse.parseDirective.parseFontChangeLine = function(textstr) {
+		var textParts = textstr.split('$');
+		if (textParts.length > 1 && multilineVars.setfont) {
+			var textarr = [ { text: textParts[0] }];
+			for (var i = 1; i < textParts.length; i++) {
+				if (textParts[i].charAt(0) === '0')
+					textarr.push({ text: textParts[i].substring(1) });
+				else if (textParts[i].charAt(0) === '1' && multilineVars.setfont[1])
+					textarr.push({font: multilineVars.setfont[1], text: textParts[i].substring(1) });
+				else if (textParts[i].charAt(0) === '2' && multilineVars.setfont[2])
+					textarr.push({font: multilineVars.setfont[2], text: textParts[i].substring(1) });
+				else if (textParts[i].charAt(0) === '3' && multilineVars.setfont[3])
+					textarr.push({font: multilineVars.setfont[3], text: textParts[i].substring(1) });
+				else if (textParts[i].charAt(0) === '4' && multilineVars.setfont[4])
+					textarr.push({font: multilineVars.setfont[4], text: textParts[i].substring(1) });
+				else
+					textarr[textarr.length-1].text += '$' + textParts[i];
+			}
+			if (textarr.length > 1)
+				return textarr;
+		}
+		return textstr;
+	};
+
+	window.ABCJS.parse.parseDirective.addDirective = function(str) {
+		var getRequiredMeasurement = function(cmd, tokens) {
+			var points = tokenizer.getMeasurement(tokens);
+			if (points.used === 0 || tokens.length !== 0)
+				return { error: "Directive \"" + cmd + "\" requires a measurement as a parameter."};
+			return points.value;
+		};
+		var oneParameterMeasurement = function(cmd, tokens) {
+			var points = tokenizer.getMeasurement(tokens);
+			if (points.used === 0 || tokens.length !== 0)
+				return "Directive \"" + cmd + "\" requires a measurement as a parameter.";
+			tune.formatting[cmd] = points.value;
+			return null;
+		};
+		var getFontParameter = function(tokens) {
+			var font = {};
+			var token = window.ABCJS.parse.last(tokens);
+			if (token.type === 'number') {
+				font.size = parseInt(token.token);
+				tokens.pop();
+			}
+			if (tokens.length > 0) {
+				var scratch = "";
+				window.ABCJS.parse.each(tokens, function(tok) {
+					if (tok.token !== '-') {
+						if (scratch.length > 0) scratch += ' ';
+						scratch += tok.token;
+					}
+				});
+				font.font = scratch;
+			}
+			return font;
+		};
+		var getChangingFont = function(cmd, tokens) {
+			if (tokens.length === 0)
+				return "Directive \"" + cmd + "\" requires a font as a parameter.";
+			multilineVars[cmd] = getFontParameter(tokens);
+			return null;
+		};
+		var getGlobalFont = function(cmd, tokens) {
+			if (tokens.length === 0)
+				return "Directive \"" + cmd + "\" requires a font as a parameter.";
+			tune.formatting[cmd] = getFontParameter(tokens);
+			return null;
+		};
+
+		var addMultilineVar = function(key, cmd, tokens, min, max) {
+			if (tokens.length !== 1 || tokens[0].type !== 'number')
+				return "Directive \"" + cmd + "\" requires a number as a parameter.";
+			var i = tokens[0].intt;
+			if (min !== undefined && i < min)
+				return "Directive \"" + cmd + "\" requires a number greater than or equal to " + min + " as a parameter.";
+			if (max !== undefined && i > max)
+				return "Directive \"" + cmd + "\" requires a number less than or equal to " + max + " as a parameter.";
+			multilineVars[key] = i;
+			return null;
+		};
+
+		var addMultilineVarBool = function(key, cmd, tokens) {
+			var str = addMultilineVar(key, cmd, tokens, 0, 1);
+			if (str !== null) return str;
+			multilineVars[key] = (multilineVars[key] === 1);
+			return null;
+		};
+
+		var tokens = tokenizer.tokenize(str, 0, str.length);	// 3 or more % in a row, or just spaces after %% is just a comment
+		if (tokens.length === 0 || tokens[0].type !== 'alpha') return null;
+		var restOfString = str.substring(str.indexOf(tokens[0].token)+tokens[0].token.length);
+		restOfString = tokenizer.stripComment(restOfString);
+		var cmd = tokens.shift().token.toLowerCase();
+		var num;
+		var scratch = "";
+		switch (cmd)
+		{
+			// The following directives were added to abc_parser_lint, but haven't been implemented here.
+			// Most of them are direct translations from the directives that will be parsed in. See abcm2ps's format.txt for info on each of these.
+			//					alignbars: { type: "number", optional: true },
+			//					aligncomposer: { type: "string", Enum: [ 'left', 'center','right' ], optional: true },
+			//					annotationfont: fontType,
+			//					bstemdown: { type: "boolean", optional: true },
+			//					continueall: { type: "boolean", optional: true },
+			//					dynalign: { type: "boolean", optional: true },
+			//					exprabove: { type: "boolean", optional: true },
+			//					exprbelow: { type: "boolean", optional: true },
+			//					flatbeams: { type: "boolean", optional: true },
+			//					footer: { type: "string", optional: true },
+			//					footerfont: fontType,
+			//					gchordbox: { type: "boolean", optional: true },
+			//					graceslurs: { type: "boolean", optional: true },
+			//					gracespacebefore: { type: "number", optional: true },
+			//					gracespaceinside: { type: "number", optional: true },
+			//					gracespaceafter: { type: "number", optional: true },
+			//					header: { type: "string", optional: true },
+			//					headerfont: fontType,
+			//					historyfont: fontType,
+			//					infofont: fontType,
+			//					infospace: { type: "number", optional: true },
+			//					lineskipfac: { type: "number", optional: true },
+			//					maxshrink: { type: "number", optional: true },
+			//					maxstaffsep: { type: "number", optional: true },
+			//					maxsysstaffsep: { type: "number", optional: true },
+			//					measurebox: { type: "boolean", optional: true },
+			//					measurefont: fontType,
+			//					notespacingfactor: { type: "number", optional: true },
+			//					parskipfac: { type: "number", optional: true },
+			//					partsbox: { type: "boolean", optional: true },
+			//					repeatfont: fontType,
+			//					rightmargin: { type: "number", optional: true },
+			//					slurheight: { type: "number", optional: true },
+			//					splittune: { type: "boolean", optional: true },
+			//					squarebreve: { type: "boolean", optional: true },
+			//					stemheight: { type: "number", optional: true },
+			//					straightflags: { type: "boolean", optional: true },
+			//					stretchstaff: { type: "boolean", optional: true },
+			//					textfont: fontType,
+			//					titleformat: { type: "string", optional: true },
+			//					vocalabove: { type: "boolean", optional: true },
+			//					vocalfont: fontType,
+			//					wordsfont: fontType,
+			case "bagpipes":tune.formatting.bagpipes = true;break;
+			case "landscape":multilineVars.landscape = true;break;
+			case "papersize":multilineVars.papersize = restOfString;break;
+			case "slurgraces":tune.formatting.slurgraces = true;break;
+			case "stretchlast":tune.formatting.stretchlast = true;break;
+			case "titlecaps":multilineVars.titlecaps = true;break;
+			case "titleleft":tune.formatting.titleleft = true;break;
+			case "measurebox":tune.formatting.measurebox = true;break;
+
+			case "botmargin":
+			case "botspace":
+			case "composerspace":
+			case "indent":
+			case "leftmargin":
+			case "linesep":
+			case "musicspace":
+			case "partsspace":
+			case "pageheight":
+			case "pagewidth":
+			case "rightmargin":
+			case "staffsep":
+			case "staffwidth":
+			case "subtitlespace":
+			case "sysstaffsep":
+			case "systemsep":
+			case "textspace":
+			case "titlespace":
+			case "topmargin":
+			case "topspace":
+			case "vocalspace":
+			case "wordsspace":
+				return oneParameterMeasurement(cmd, tokens);
+			case "vskip":
+				var vskip = getRequiredMeasurement(cmd, tokens);
+				if (vskip.error)
+					return vskip.error;
+				tune.addSpacing(vskip);
+				return null;
+			case "scale":
+				scratch = "";
+				window.ABCJS.parse.each(tokens, function(tok) {
+					scratch += tok.token;
+				});
+				num = parseFloat(scratch);
+				if (isNaN(num) || num === 0)
+					return "Directive \"" + cmd + "\" requires a number as a parameter.";
+				tune.formatting.scale = num;
+				break;
+			case "sep":
+				if (tokens.length === 0)
+					tune.addSeparator();
+				else {
+					var points = tokenizer.getMeasurement(tokens);
+					if (points.used === 0)
+						return "Directive \"" + cmd + "\" requires 3 numbers: space above, space below, length of line";
+					var spaceAbove = points.value;
+
+					points = tokenizer.getMeasurement(tokens);
+					if (points.used === 0)
+						return "Directive \"" + cmd + "\" requires 3 numbers: space above, space below, length of line";
+					var spaceBelow = points.value;
+
+					points = tokenizer.getMeasurement(tokens);
+					if (points.used === 0 || tokens.length !== 0)
+						return "Directive \"" + cmd + "\" requires 3 numbers: space above, space below, length of line";
+					var lenLine = points.value;
+					tune.addSeparator(spaceAbove, spaceBelow, lenLine);
+				}
+				break;
+			case "barsperstaff":
+				scratch = addMultilineVar('barsperstaff', cmd, tokens);
+				if (scratch !== null) return scratch;
+				break;
+			case "staffnonote":
+				scratch = addMultilineVarBool('staffnonote', cmd, tokens);
+				if (scratch !== null) return scratch;
+				break;
+			case "printtempo":
+				scratch = addMultilineVarBool('printTempo', cmd, tokens);
+				if (scratch !== null) return scratch;
+				break;
+			case "measurenb":
+			case "barnumbers":
+				scratch = addMultilineVar('barNumbers', cmd, tokens);
+				if (scratch !== null) return scratch;
+				break;
+			case "begintext":
+				multilineVars.inTextBlock = true;
+				break;
+			case "continueall":
+				multilineVars.continueall = true;
+				break;
+			case "beginps":
+				multilineVars.inPsBlock = true;
+				warn("Postscript ignored", str, 0);
+				break;
+			case "deco":
+				if (restOfString.length > 0)
+					multilineVars.ignoredDecorations.push(restOfString.substring(0, restOfString.indexOf(' ')));
+				warn("Decoration redefinition ignored", str, 0);
+				break;
+			case "text":
+				var textstr = tokenizer.translateString(restOfString);
+				tune.addText(window.ABCJS.parse.parseDirective.parseFontChangeLine(textstr));
+				break;
+			case "center":
+				var centerstr = tokenizer.translateString(restOfString);
+				tune.addCentered(window.ABCJS.parse.parseDirective.parseFontChangeLine(centerstr));
+				break;
+			case "font":
+				// don't need to do anything for this; it is a useless directive
+				break;
+			case "setfont":
+				var sfTokens = tokenizer.tokenize(restOfString, 0, restOfString.length);
+				var sfDone = false;
+				if (sfTokens.length >= 4) {
+					if (sfTokens[0].token === '-' && sfTokens[1].type === 'number') {
+						var sfNum = parseInt(sfTokens[1].token);
+						if (sfNum >= 1 && sfNum <= 4) {
+							if (!multilineVars.setfont)
+								multilineVars.setfont = [];
+							var sfSize = sfTokens.pop();
+							if (sfSize.type === 'number') {
+								sfSize = parseInt(sfSize.token);
+								var sfFontName = '';
+								for (var sfi = 2; sfi < sfTokens.length; sfi++)
+									sfFontName += sfTokens[sfi].token;
+								multilineVars.setfont[sfNum] = { font: sfFontName, size: sfSize };
+								sfDone = true;
+							}
+						}
+					}
+				}
+				if (!sfDone)
+					return "Bad parameters: " + cmd;
+				break;
+			case "gchordfont":
+			case "partsfont":
+			case "vocalfont":
+			case "textfont":
+				return getChangingFont(cmd, tokens);
+			case "barlabelfont":
+			case "barnumberfont":
+			case "composerfont":
+			case "subtitlefont":
+			case "tempofont":
+			case "titlefont":
+			case "voicefont":
+				return getGlobalFont(cmd, tokens);
+			case "barnumfont":
+				return getGlobalFont("barnumberfont", tokens);
+			case "staves":
+			case "score":
+				multilineVars.score_is_present = true;
+				var addVoice = function(id, newStaff, bracket, brace, continueBar) {
+					if (newStaff || multilineVars.staves.length === 0) {
+						multilineVars.staves.push({index: multilineVars.staves.length, numVoices: 0});
+					}
+					var staff = window.ABCJS.parse.last(multilineVars.staves);
+					if (bracket !== undefined) staff.bracket = bracket;
+					if (brace !== undefined) staff.brace = brace;
+					if (continueBar) staff.connectBarLines = 'end';
+					if (multilineVars.voices[id] === undefined) {
+						multilineVars.voices[id] = {staffNum: staff.index, index: staff.numVoices};
+						staff.numVoices++;
+					}
+				};
+
+				var openParen = false;
+				var openBracket = false;
+				var openBrace = false;
+				var justOpenParen = false;
+				var justOpenBracket = false;
+				var justOpenBrace = false;
+				var continueBar = false;
+				var lastVoice;
+				var addContinueBar = function() {
+					continueBar = true;
+					if (lastVoice) {
+						var ty = 'start';
+						if (lastVoice.staffNum > 0) {
+							if (multilineVars.staves[lastVoice.staffNum-1].connectBarLines === 'start' ||
+								multilineVars.staves[lastVoice.staffNum-1].connectBarLines === 'continue')
+								ty = 'continue';
+						}
+						multilineVars.staves[lastVoice.staffNum].connectBarLines = ty;
+					}
+				};
+				while (tokens.length) {
+					var t = tokens.shift();
+					switch (t.token) {
+						case '(':
+							if (openParen) warn("Can't nest parenthesis in %%score", str, t.start);
+							else {openParen = true;justOpenParen = true;}
+							break;
+						case ')':
+							if (!openParen || justOpenParen) warn("Unexpected close parenthesis in %%score", str, t.start);
+							else openParen = false;
+							break;
+						case '[':
+							if (openBracket) warn("Can't nest brackets in %%score", str, t.start);
+							else {openBracket = true;justOpenBracket = true;}
+							break;
+						case ']':
+							if (!openBracket || justOpenBracket) warn("Unexpected close bracket in %%score", str, t.start);
+							else {openBracket = false;multilineVars.staves[lastVoice.staffNum].bracket = 'end';}
+							break;
+						case '{':
+							if (openBrace ) warn("Can't nest braces in %%score", str, t.start);
+							else {openBrace = true;justOpenBrace = true;}
+							break;
+						case '}':
+							if (!openBrace || justOpenBrace) warn("Unexpected close brace in %%score", str, t.start);
+							else {openBrace = false;multilineVars.staves[lastVoice.staffNum].brace = 'end';}
+							break;
+						case '|':
+							addContinueBar();
+							break;
+						default:
+							var vc = "";
+							while (t.type === 'alpha' || t.type === 'number') {
+								vc += t.token;
+								if (t.continueId)
+									t = tokens.shift();
+								else
+									break;
+							}
+							var newStaff = !openParen || justOpenParen;
+							var bracket = justOpenBracket ? 'start' : openBracket ? 'continue' : undefined;
+							var brace = justOpenBrace ? 'start' : openBrace ? 'continue' : undefined;
+							addVoice(vc, newStaff, bracket, brace, continueBar);
+							justOpenParen = false;
+							justOpenBracket = false;
+							justOpenBrace = false;
+							continueBar = false;
+							lastVoice = multilineVars.voices[vc];
+							if (cmd === 'staves')
+								addContinueBar();
+							break;
+					}
+				}
+				break;
+
+			case "newpage":
+				var pgNum = tokenizer.getInt(restOfString);
+				tune.addNewPage(pgNum.digits === 0 ? -1 : pgNum.value);
+				break;
+
+			case "abc-copyright":
+			case "abc-creator":
+			case "abc-version":
+			case "abc-charset":
+			case "abc-edited-by":
+				tune.addMetaText(cmd, restOfString);
+				break;
+			case "header":
+			case "footer":
+				var footerStr = tokenizer.getMeat(restOfString, 0, restOfString.length);
+				footerStr = restOfString.substring(footerStr.start, footerStr.end);
+				if (footerStr.charAt(0) === '"' && footerStr.charAt(footerStr.length-1) === '"' )
+					footerStr = footerStr.substring(1, footerStr.length-2);
+				var footerArr = footerStr.split('\t');
+				var footer = {};
+				if (footerArr.length === 1)
+					footer = { left: "", center: footerArr[0], right: "" };
+				else if (footerArr.length === 2)
+					footer = { left: footerArr[0], center: footerArr[1], right: "" };
+				else
+					footer = { left: footerArr[0], center: footerArr[1], right: footerArr[2] };
+				 if (footerArr.length > 3)
+					 warn("Too many tabs in "+cmd+": "+footerArr.length+" found.", restOfString, 0);
+
+				tune.addMetaTextObj(cmd, footer);
+				break;
+
+			case "midi":
+				var midi = tokenizer.tokenize(restOfString, 0, restOfString.length);
+				if (midi.length > 0 && midi[0].token === '=')
+					midi.shift();
+				if (midi.length === 0)
+					warn("Expected midi command", restOfString, 0);
+				else {
+	//				var midiCmd = restOfString.split(' ')[0];
+	//				var midiParam = restOfString.substring(midiCmd.length+1);
+					var getNextMidiParam =  function(midiToks) {
+						if (midiToks.length > 0) {
+							var t = midiToks.shift();
+							var p = t.token;
+							if (t.type === "number")
+								p = t.intt;
+							return p;
+						}
+						else
+							return null;
+					};
+					// TODO-PER: make sure the command is legal
+					if (tune.formatting[cmd] === undefined)
+						tune.formatting[cmd] = {};
+					var midi_cmd = midi.shift().token;
+					var midi_param = true;
+					if (midi_cmd === 'program') {
+						var p1 = getNextMidiParam(midi);
+						if (p1) {
+							var p2 = getNextMidiParam(midi);
+							// NOTE: The program number has an off by one error in ABC, so we add one here.
+							if (p2)
+								midi_param = { channel: p1, program: p2};
+							else
+								midi_param = { program: p1};
+						}
+					} else {
+						// TODO-PER: handle the params for all MIDI commands
+						var p = getNextMidiParam(midi);
+						if (p !== null)
+							midi_param = p;
+					}
+					tune.formatting[cmd][midi_cmd] = midi_param;
+					// TODO-PER: save all the parameters, not just the first.
+				}
+	//%%MIDI barlines: deactivates %%nobarlines.
+	//%%MIDI bassprog n
+	//%%MIDI bassvol n
+	//%%MIDI beat ⟨int1⟩ ⟨int2⟩ ⟨int3⟩ ⟨int4⟩: controls the volumes of the notes in a measure. The first note in a bar has volume ⟨int1⟩; other ‘strong’ notes have volume ⟨int2⟩ and all the rest have volume ⟨int3⟩. These values must be in the range 0–127. The parameter ⟨int4⟩ determines which notes are ‘strong’. If the time signature is x/y, then each note is given a position number k = 0, 1, 2. . . x-1 within each bar. If k is a multiple of ⟨int4⟩, then the note is ‘strong’.
+	//%%MIDI beataccents: reverts to normally emphasised notes. See also %%MIDI nobeat-
+	//%%MIDI beatmod ⟨int⟩: increments the velocities as defined by %%MIDI beat
+	//%%MIDI beatstring ⟨string⟩: similar to %%MIDI beat, but indicated with an fmp string.
+	//%%MIDI c ⟨int⟩: specifies the MIDI pitch which corresponds to	. The default is 60.
+	//%%MIDI channel ⟨int⟩: selects the melody channel ⟨int⟩ (1–16).
+	//%%MIDI chordattack ⟨int⟩: delays the start of chord notes by ⟨int⟩ MIDI units.
+	//%%MIDI chordname ⟨string int1 int2 int3 int4 int5 int6⟩: defines new chords or re-defines existing ones as was seen in Section 12.8.
+	//%%MIDI chordprog 20 % Church organ
+	//%%MIDI chordvol ⟨int⟩: sets the volume (velocity) of the chord notes to ⟨int⟩ (0–127).
+	//%%MIDI control ⟨bass/chord⟩ ⟨int1 int2⟩: generates a MIDI control event. If %%control is followed by ⟨bass⟩ or ⟨chord⟩, the event apply to the bass or chord channel, otherwise it will be applied to the melody channel. ⟨int1⟩ is the MIDI control number (0–127) and ⟨int2⟩ the value (0–127).
+	//%%MIDI deltaloudness⟨int⟩: bydefault,!crescendo!and!dimuendo!modifythebe- at variables ⟨vol1⟩ ⟨vol2⟩ ⟨vol3⟩ 15 volume units. This command allows the user to change this default.
+	//%%MIDI drone ⟨int1 int2 int3 int4 int5⟩: specifies a two-note drone accompaniment. ⟨int1⟩ is the drone MIDI instrument, ⟨int2⟩ the MIDI pitch 1, ⟨int3⟩ the MIDI pitch 2, ⟨int4⟩ the MIDI volume 1, ⟨int5⟩ the MIDI volume 2. Default values are 70 45 33 80 80.
+	//%%MIDI droneoff: turns the drone accompaniment off.
+	//%%MIDI droneon: turns the drone accompaniment on.
+	//%%MIDI drum string [drum programs] [drum velocities]
+	//%%MIDI drumbars ⟨int⟩: specifies the number of bars over which a drum pattern string is spread. Default is 1.
+	//%%MIDI drummap ⟨str⟩ ⟨int⟩: associates the note ⟨str⟩ (in ABC notation) to the a percussion instrument, as listed in Section H.2.
+	//%%MIDI drumoff turns drum accompaniment off.
+	//%%MIDI drumon turns drum accompaniment on.
+	//%%MIDI fermatafixed: expands a !fermata! by one unit length; that is, GC3 becomes
+	//%%MIDI fermataproportional: doubles the length of a note preceded by !fermata!;
+	//%%MIDI gchord string
+	//%%MIDI gchord str
+	//%%MIDI gchordon
+	//%%MIDI gchordoff
+	//%%MIDI grace ⟨float⟩: sets the fraction of the next note that grace notes will take up. ⟨float⟩ must be a fraction such as 1/6.
+	//%%MIDI gracedivider ⟨int⟩: sets the grace note length as 1/⟨int⟩th of the following note.
+	//%%MIDI makechordchannels⟨int⟩: thisisaverycomplexcommandusedinchordscon-
+	//%%MIDI nobarlines
+	//%%MIDI nobeataccents: forces the ⟨int2⟩ volume (see %%MIDI beat) for each note in a bar, regardless of their position.
+	//%%MIDI noportamento: turns off the portamento controller on the current channel.
+	//%%MIDI pitchbend [bass/chord] <high byte> <low byte>
+	//%%MIDI program 2 75
+	//%%MIDI portamento ⟨int⟩: turns on the portamento controller on the current channel and set it to ⟨int⟩. Experts only.
+	//%%MIDI randomchordattack: delays the start of chord notes by a random number of MIDI units.
+	//%%MIDI ratio n m
+	//%%MIDI rtranspose ⟨int1⟩: transposes relatively to a prior %%transpose command by ⟨int1⟩ semitones; the total transposition will be ⟨int1 + int2⟩ semitones.
+	//%%MIDI temperament ⟨int1⟩ ⟨int2⟩: TO BE WRITTEN
+	//%%MIDI temperamentlinear ⟨float1 float2⟩: changes the temperament of the scale. ⟨fl- oat1⟩ specifies the size of an octave in cents of a semitone, or 1/1200 of an octave. ⟨float2⟩ specifies in the size of a fifth (normally 700 cents).
+	//%%MIDI temperamentnormal: restores normal temperament.
+	//%%MIDI transpose n
+	//%%MIDI voice [<ID>] [instrument=<integer> [bank=<integer>]] [mute]
+				break;
+
+			case "playtempo":
+			case "auquality":
+			case "continuous":
+			case "nobarcheck":
+				// TODO-PER: Actually handle the parameters of these
+				tune.formatting[cmd] = restOfString;
+				break;
+			default:
+				return "Unknown directive: " + cmd;
+		}
+		return null;
+	};
+
+})();