abcjs 6.2.3 → 6.3.0

package/index.js

@@ -57,6 +57,7 @@ var supportsAudio = require('./src/synth/supports-audio');
 var playEvent = require('./src/synth/play-event');
 var SynthController = require('./src/synth/synth-controller');
 var getMidiFile = require('./src/synth/get-midi-file');
+var midiRenderer = require('./src/synth/abc_midi_renderer');
 
 abcjs.synth = {
 	CreateSynth: CreateSynth,
@@ -71,6 +72,7 @@ abcjs.synth = {
 	playEvent: playEvent,
 	getMidiFile: getMidiFile,
 	sequence: sequence,
+	midiRenderer: midiRenderer,
 };
 
 abcjs['Editor'] = require('./src/edit/abc_editor');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "abcjs",
-  "version": "6.2.3",
+  "version": "6.3.0",
   "description": "Renderer for abc music notation",
   "main": "index.js",
   "types": "types/index.d.ts",

package/plugin.js

@@ -248,7 +248,7 @@ if (autostart &&
 }
 
 var abcjs = {
-	plugin: Plugin
+	plugin: plugin
 };
 
 module.exports = abcjs;

package/src/api/abc_tablatures.js

@@ -5,17 +5,17 @@
  * where plugin represents a plugin instance 
  * 
  */
-var ViolinTablature = require('../tablatures/instruments/violin/tab-violin');
-var GuitarTablature = require('../tablatures/instruments/guitar/tab-guitar');
+var StringTablature = require('../tablatures/instruments/tab-string');
 
 /* extend the table below when adding a new instrument plugin */
 
 // Existing tab classes 
 var pluginTab = {
-  'violin': 'ViolinTab',
-  'fiddle': 'ViolinTab',
-  'mandolin': 'ViolinTab',
-  'guitar': 'GuitarTab'
+  'violin': { name: 'StringTab', defaultTuning: ['G,', 'D', 'A', 'e'], isTabBig: false, tabSymbolOffset: 0},
+  'fiddle': { name: 'StringTab', defaultTuning: ['G,', 'D', 'A', 'e'], isTabBig: false, tabSymbolOffset: 0},
+  'mandolin': { name: 'StringTab', defaultTuning: ['G,', 'D', 'A', 'e'], isTabBig: false, tabSymbolOffset: 0},
+  'guitar': { name: 'StringTab', defaultTuning: ['E,', 'A,', 'D', 'G' , 'B' , 'e'], isTabBig: true, tabSymbolOffset: 0},
+  'fiveString': { name: 'StringTab', defaultTuning: ['C,', 'G,', 'D', 'A', 'e'], isTabBig: false, tabSymbolOffset: -.95},
 };
 
 var abcTablatures = {
@@ -66,7 +66,7 @@ var abcTablatures = {
         var tabName = pluginTab[instrument];
         var plugin = null;
         if (tabName) {
-          plugin = this.plugins[tabName];
+          plugin = this.plugins[tabName.name];
         }
         if (plugin) {
           if (params.visualTranspose != 0) {
@@ -79,6 +79,7 @@ var abcTablatures = {
             tuneNumber: tuneNumber,
             params: args,
             instance: null,
+            tabType: tabName,
           };
           // proceed with tab plugin  init 
           // plugin.init(tune, tuneNumber, args, ii);
@@ -103,16 +104,50 @@ var abcTablatures = {
    * @param {*} renderer 
    * @param {*} abcTune 
    */
-  layoutTablatures: function (renderer, abcTune) {
+  layoutTablatures: function layoutTablatures(renderer, abcTune) {
     var tabs = abcTune.tablatures;
+
     // chack tabs request for each staffs
+    var staffLineCount = 0;
+    
+    // Clear the suppression flag
+    if (tabs && (tabs.length > 0)){
+      var nTabs = tabs.length;
+      for (var kk=0;kk<nTabs;++kk){
+        if (tabs[kk] && tabs[kk].params.firstStaffOnly){
+          tabs[kk].params.suppress = false;
+        }
+      }
+    }
+
     for (var ii = 0; ii < abcTune.lines.length; ii++) {
       var line = abcTune.lines[ii];
+
+      if (line.staff){
+        staffLineCount++;
+      }
+      
+      // MAE 27Nov2023
+      // If tab param "firstStaffOnly", remove the tab label after the first staff
+      if (staffLineCount > 1){
+        if (tabs && (tabs.length > 0)){
+          var nTabs = tabs.length;
+          for (var kk=0;kk<nTabs;++kk){
+            if (tabs[kk].params.firstStaffOnly){
+              // Set the staff draw suppression flag
+              tabs[kk].params.suppress = true;
+            }
+          }
+        }
+      }
+
       var curStaff = line.staff;
       if (curStaff) {
+        var maxStaves = curStaff.length
         for (var jj = 0; jj < curStaff.length; jj++) {
-          if (tabs[jj]) {
-            // tablature requested for staff
+
+          if (tabs[jj] && jj < maxStaves) {
+             // tablature requested for staff
             var tabPlugin = tabs[jj];
             if (tabPlugin.instance == null) {
               tabPlugin.instance = new tabPlugin.classz();
@@ -121,7 +156,8 @@ var abcTablatures = {
               tabPlugin.instance.init(abcTune,
                 tabPlugin.tuneNumber,
                 tabPlugin.params,
-                jj
+                jj,
+                tabPlugin.tabType
               );
             }
             // render next
@@ -138,8 +174,7 @@ var abcTablatures = {
   init: function () {
     // just register plugin hosted by abcjs 
     if (!this.inited) {
-      this.register(new ViolinTablature());
-      this.register(new GuitarTablature());
+      this.register(new StringTablature());
       this.inited = true;
     }
   }

package/src/parse/abc_parse_directive.js

@@ -684,27 +684,27 @@ var parseDirective = {};
 	};
 
 	parseDirective.parseFontChangeLine = function(textstr) {
+		// We don't want to match two dollar signs, so change those temporarily
+		textstr = textstr.replace(/\$\$/g,"\x03")
 		var textParts = textstr.split('$');
 		if (textParts.length > 1 && multilineVars.setfont) {
-			var textarr = [ { text: textParts[0] }];
+			var textarr = [ ];
+			if (textParts[0] !== '') // did the original string start with `$`?
+				textarr.push({ text: textParts[0] })
 			for (var i = 1; i < textParts.length; i++) {
 				if (textParts[i][0] === '0')
-					textarr.push({ text: textParts[i].substring(1) });
-				else if (textParts[i][0] === '1' && multilineVars.setfont[1])
-					textarr.push({font: multilineVars.setfont[1], text: textParts[i].substring(1) });
-				else if (textParts[i][0] === '2' && multilineVars.setfont[2])
-					textarr.push({font: multilineVars.setfont[2], text: textParts[i].substring(1) });
-				else if (textParts[i][0] === '3' && multilineVars.setfont[3])
-					textarr.push({font: multilineVars.setfont[3], text: textParts[i].substring(1) });
-				else if (textParts[i][0] === '4' && multilineVars.setfont[4])
-					textarr.push({font: multilineVars.setfont[4], text: textParts[i].substring(1) });
-				else
-					textarr[textarr.length-1].text += '$' + textParts[i];
+					textarr.push({ text: textParts[i].substring(1).replace(/\x03/g,"$$") });
+				else {
+					var whichFont = parseInt(textParts[i][0],10)
+					if (multilineVars.setfont[whichFont])
+						textarr.push({font: multilineVars.setfont[whichFont], text: textParts[i].substring(1).replace(/\x03/g,"$$") });
+					else
+						textarr[textarr.length-1].text += '$' + textParts[i].replace(/\x03/g,"$$");
+				}				
 			}
-			if (textarr.length > 1)
-				return textarr;
+			return textarr;
 		}
-		return textstr;
+		return textstr.replace(/\x03/g,"$$");
 	};
 
 	var positionChoices = [ 'auto', 'above', 'below', 'hidden' ];
@@ -748,6 +748,7 @@ var parseDirective = {};
 			case "bagpipes":tune.formatting.bagpipes = true;break;
 			case "flatbeams":tune.formatting.flatbeams = true;break;
 			case "jazzchords":tune.formatting.jazzchords = true;break;
+			case "accentAbove":tune.formatting.accentAbove = true;break;
 			case "germanAlphabet":tune.formatting.germanAlphabet = true;break;
 			case "landscape":multilineVars.landscape = true;break;
 			case "papersize":multilineVars.papersize = restOfString;break;
@@ -939,7 +940,7 @@ var parseDirective = {};
 				if (sfTokens.length >= 4) {
 					if (sfTokens[0].token === '-' && sfTokens[1].type === 'number') {
 						var sfNum = parseInt(sfTokens[1].token);
-						if (sfNum >= 1 && sfNum <= 4) {
+						if (sfNum >= 1 && sfNum <= 9) {
 							if (!multilineVars.setfont)
 								multilineVars.setfont = [];
 							sfTokens.shift();

package/src/parse/abc_parse_header.js

@@ -11,15 +11,12 @@ var ParseHeader = function(tokenizer, warn, multilineVars, tune, tuneBuilder) {
 	};
 	this.reset(tokenizer, warn, multilineVars, tune);
 
-	this.setTitle = function(title) {
+	this.setTitle = function(title, origSize) {
 		if (multilineVars.hasMainTitle)
-			tuneBuilder.addSubtitle(tokenizer.translateString(tokenizer.stripComment(title)), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+title.length+2});	// display secondary title
+			tuneBuilder.addSubtitle(title, { startChar: multilineVars.iChar, endChar: multilineVars.iChar+origSize+2});	// display secondary title
 		else
 		{
-			var titleStr = tokenizer.translateString(tokenizer.theReverser(tokenizer.stripComment(title)));
-			if (multilineVars.titlecaps)
-				titleStr = titleStr.toUpperCase();
-			tuneBuilder.addMetaText("title", titleStr, { startChar: multilineVars.iChar, endChar: multilineVars.iChar+title.length+2});
+			tuneBuilder.addMetaText("title", title, { startChar: multilineVars.iChar, endChar: multilineVars.iChar+origSize+2});
 			multilineVars.hasMainTitle = true;
 		}
 	};
@@ -371,10 +368,11 @@ var ParseHeader = function(tokenizer, warn, multilineVars, tune, tuneBuilder) {
 						tuneBuilder.appendStartingElement('key', startChar, endChar, parseKeyVoice.fixKey(multilineVars.clef, multilineVars.key));
 					return [ e-i+1+ws ];
 				case "[P:":
+					var part = parseDirective.parseFontChangeLine(line.substring(i+3, e))
 					if (startLine || tune.lines.length <= tune.lineNum)
-						multilineVars.partForNextLine = { title: line.substring(i+3, e), startChar: startChar, endChar: endChar };
+						multilineVars.partForNextLine = { title: part, startChar: startChar, endChar: endChar };
 					else
-						tuneBuilder.appendElement('part', startChar, endChar, {title: line.substring(i+3, e)});
+						tuneBuilder.appendElement('part', startChar, endChar, {title: part});
 					return [ e-i+1+ws ];
 				case "[L:":
 					this.setDefaultLength(line, i+3, e);
@@ -477,23 +475,26 @@ var ParseHeader = function(tokenizer, warn, multilineVars, tune, tuneBuilder) {
 
 	this.parseHeader = function(line) {
 		var field = metaTextHeaders[line[0]];
-		if (field !== undefined) {
-			if (field === 'unalignedWords')
-				tuneBuilder.addMetaTextArray(field, parseDirective.parseFontChangeLine(tokenizer.translateString(tokenizer.stripComment(line.substring(2)))), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+line.length});
-			else
-				tuneBuilder.addMetaText(field, tokenizer.translateString(tokenizer.stripComment(line.substring(2))), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+line.length});
-			return {};
+		var origSize = line.length-2
+		var restOfLine = tokenizer.translateString(tokenizer.stripComment(line.substring(2)))
+		if (field === 'unalignedWords' || field === 'notes') {
+			// These fields can be multi-line
+			tuneBuilder.addMetaTextArray(field, parseDirective.parseFontChangeLine(restOfLine), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+line.length});
+		} else if (field !== undefined) {
+			// these fields are single line
+			tuneBuilder.addMetaText(field, parseDirective.parseFontChangeLine(restOfLine), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+line.length});
 		} else {
 			var startChar = multilineVars.iChar;
 			var endChar = startChar + line.length;
 			switch(line[0])
 			{
 				case  'H':
-					tuneBuilder.addMetaText("history", tokenizer.translateString(tokenizer.stripComment(line.substring(2))), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+line.length});
+					// History is a little different because once it starts it continues until another header field is encountered
+					tuneBuilder.addMetaTextArray("history", parseDirective.parseFontChangeLine(restOfLine), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+line.length});
 					line = tokenizer.peekLine()
 					while (line && line[1] !== ':') {
 						tokenizer.nextLine()
-						tuneBuilder.addMetaText("history", tokenizer.translateString(tokenizer.stripComment(line)), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+line.length});
+						tuneBuilder.addMetaTextArray("history", parseDirective.parseFontChangeLine(tokenizer.translateString(tokenizer.stripComment(line))), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+line.length});
 						line = tokenizer.peekLine()
 					}
 					break;
@@ -518,9 +519,9 @@ var ParseHeader = function(tokenizer, warn, multilineVars, tune, tuneBuilder) {
 				case  'P':
 					// TODO-PER: There is more to do with parts, but the writer doesn't care.
 					if (multilineVars.is_in_header)
-						tuneBuilder.addMetaText("partOrder", tokenizer.translateString(tokenizer.stripComment(line.substring(2))), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+line.length});
+						tuneBuilder.addMetaText("partOrder", parseDirective.parseFontChangeLine(restOfLine), { startChar: multilineVars.iChar, endChar: multilineVars.iChar+line.length});
 					else
-						multilineVars.partForNextLine = { title: tokenizer.translateString(tokenizer.stripComment(line.substring(2))), startChar: startChar, endChar: endChar};
+						multilineVars.partForNextLine = { title: restOfLine, startChar: startChar, endChar: endChar};
 					break;
 				case  'Q':
 					var tempo = this.setTempo(line, 2, line.length, multilineVars.iChar);
@@ -533,7 +534,9 @@ var ParseHeader = function(tokenizer, warn, multilineVars, tune, tuneBuilder) {
 					}
 					break;
 				case  'T':
-					this.setTitle(line.substring(2));
+					if (multilineVars.titlecaps)
+						restOfLine = restOfLine.toUpperCase();		
+					this.setTitle(parseDirective.parseFontChangeLine(tokenizer.theReverser(restOfLine)), origSize);
 					break;
 				case 'U':
 					this.addUserDefinition(line, 2, line.length);

package/src/parse/abc_tokenizer.js

@@ -639,13 +639,78 @@ var Tokenizer = function(lines, multilineVars) {
 		return {value: num/den, index: index};
 	};
 
-	this.theReverser = function(str) {
-		if (parseCommon.endsWith(str, ", The"))
-			return "The " + str.substring(0, str.length-5);
-		if (parseCommon.endsWith(str, ", A"))
-			return "A " + str.substring(0, str.length-3);
-		return str;
-	};
+//
+// MAE 10 Jan 2023 - For better handling of tunes that have tune numbers in front of them.
+//
+// Previous version would take:
+// 21. Woman of the House, The
+// and return:
+// The 21. Woman of the House
+// 
+// This fix results in:
+// 21. The Woman of the House
+//
+// Also added additional checks and handlers for lower case ", the" and ", a" since I found several tune collections with those tune name constructs
+//
+// Find an optional title number at the start of a tune title
+function getTitleNumber(str){
+
+  const regex = /^(\d+)\./;
+
+  // Use the exec method to search for the pattern in the string
+  const match = regex.exec(str);
+
+  // Check if a match is found
+  if (match) {
+
+	// The matched number is captured in the first group (index 1)
+	const foundNumber = match[1];
+	return foundNumber;
+
+  } else {
+
+	// Return null if no match is found
+	return null;
+	
+  }
+
+}
+
+var thePatterns = [
+	{ match: /,\s*[Tt]he$/, replace: "The " },
+	{ match: /,\s*[Aa]$/, replace: "A " },
+	{ match: /,\s*[Aa]n$/, replace: "An " },
+]
+
+this.theReverser = function (str) {
+
+    for (var i = 0; i < thePatterns.length; i++) {
+		var thisPattern = thePatterns[i]
+		var match = str.match(thisPattern.match)
+		if (match) {
+			var theTitleNumber = getTitleNumber(str);
+			if (theTitleNumber){
+		
+			  //console.log("theReverser The titlenumber:"+theTitleNumber); 
+		
+			  str = str.replace(theTitleNumber+".","");
+			  str = str.trim();
+			}
+			var len = match[0].length
+			var result = thisPattern.replace + str.substring(0, str.length - len);
+		
+			if (theTitleNumber){
+			  result = theTitleNumber+". "+result;
+			}
+			
+			return result;
+
+		}
+	}
+
+    return str;
+
+  };
 
 	this.stripComment = function(str) {
 		var i = str.indexOf('%');

package/src/parse/tune-builder.js

@@ -1,5 +1,6 @@
 var parseKeyVoice = require('../parse/abc_parse_key_voice');
 var parseCommon = require('../parse/abc_common');
+var parseDirective = require('./abc_parse_directive');
 
 var TuneBuilder = function(tune) {
 	var self = this;
@@ -147,6 +148,9 @@ var TuneBuilder = function(tune) {
 		this.closeLine();	// Close the last line.
 		delete tune.runningFonts;
 
+		simplifyMetaText(tune)
+		//addRichTextToAnnotationsAndLyrics(tune)
+
 		// If the tempo was created with a string like "Allegro", then the duration of a beat needs to be set at the last moment, when it is most likely known.
 		if (tune.metaText.tempo && tune.metaText.tempo.bpm && !tune.metaText.tempo.duration)
 			tune.metaText.tempo.duration = [ tune.getBeatLength() ];
@@ -878,7 +882,15 @@ var TuneBuilder = function(tune) {
 			tune.metaText[key] = value;
 			tune.metaTextInfo[key] = info;
 		} else {
-			tune.metaText[key] += "\n" + value;
+			if (typeof tune.metaText[key] === 'string' && typeof value === 'string')
+				tune.metaText[key] += "\n" + value;
+			else {
+				if (tune.metaText[key] === 'string')
+					tune.metaText[key] = [{text: tune.metaText[key]}]
+				if (typeof value === 'string')
+					value = [{text: value}]
+				tune.metaText[key] =tune.metaText[key].concat(value)
+			}
 			tune.metaTextInfo[key].endChar = info.endChar;
 		}
 	};
@@ -898,4 +910,51 @@ var TuneBuilder = function(tune) {
 	};
 };
 
+function isArrayOfStrings(arr) {
+	if (!arr) return false
+	if (typeof arr === "string") return false
+	var str = ''
+	for (var i = 0; i < arr.length; i++) {
+		if (typeof arr[i] !== 'string')
+			return false
+	}
+	return true
+}
+
+function simplifyMetaText(tune) {
+	if (isArrayOfStrings(tune.metaText.notes))
+		tune.metaText.notes = tune.metaText.notes.join("\n")
+	if (isArrayOfStrings(tune.metaText.history))
+		tune.metaText.history = tune.metaText.history.join("\n")
+}
+
+function addRichTextToAnnotationsAndLyrics(tune) {
+	var lines = tune.lines
+	for (var i = 0; i < lines.length; i++) {
+		if (lines[i].staff !== undefined) {
+			for (var s = 0; s < lines[i].staff.length; s++) {
+				for (var v = 0; v < lines[i].staff[s].voices.length; v++) {
+					var voice = lines[i].staff[s].voices[v];
+					for (var n = 0; n < voice.length; n++) {
+						var element = voice[n]
+						if (element.chord) {
+							for (var c = 0; c < element.chord.length; c++) {
+								element.chord[c].name = parseDirective.parseFontChangeLine(element.chord[c].name)
+								console.log(element.chord[c].name)
+							}
+						}
+						if (element.lyric) {
+							for (var l = 0; l < element.lyric.length; l++) {
+								element.lyric[l].syllable = parseDirective.parseFontChangeLine(element.lyric[l].syllable)
+								console.log(element.lyric[l].syllable)
+							}
+						}
+					}
+				}
+			}
+		}
+	}
+
+}
+
 module.exports = TuneBuilder;

package/src/synth/synth-controller.js

@@ -21,6 +21,10 @@ function SynthController() {
 	self.load = function (selector, cursorControl, visualOptions) {
 		if (!visualOptions)
 			visualOptions = {};
+		if (visualOptions.displayPlay === undefined)
+			visualOptions.displayPlay = true
+		if (visualOptions.displayProgress === undefined)
+			visualOptions.displayProgress = true
 		self.control = new CreateSynthControl(selector, {
 			loopHandler: visualOptions.displayLoop ? self.toggleLoop : undefined,
 			restartHandler: visualOptions.displayRestart ? self.restart : undefined,
@@ -41,7 +45,7 @@ function SynthController() {
 	self.setTune = function(visualObj, userAction, audioParams) {
 		self.visualObj = visualObj;
 		self.disable(false);
-		self.options = audioParams;
+		self.options = audioParams ? audioParams : {};
 
 		if (self.control) {
 			self.pause();
@@ -195,7 +199,7 @@ function SynthController() {
 
 	self._randomAccess = function (ev) {
 		var background = (ev.target.classList.contains('abcjs-midi-progress-indicator')) ? ev.target.parentNode : ev.target;
-		var percent = (ev.x - background.offsetLeft) / background.offsetWidth;
+		var percent = (ev.x - background.getBoundingClientRect().left) / background.offsetWidth;
 		if (percent < 0)
 			percent = 0;
 		if (percent > 1)

package/src/tablatures/instruments/string-patterns.js

@@ -265,6 +265,17 @@ StringPatterns.prototype.tabInfos = function (plugin) {
   return '';
 };
 
+// MAE 27 Nov 2023
+StringPatterns.prototype.suppress = function (plugin) {
+  var _super = plugin._super;
+  var suppress = _super.params.suppress;
+  if (suppress){
+    return true;
+  }
+  return false;
+};
+// MAE 27 Nov 2023 End
+
 /**
  * Common patterns for all string instruments
  * @param {} plugin

package/src/tablatures/instruments/{guitar/guitar-patterns.js → tab-string-patterns.js}

@@ -1,23 +1,23 @@
-var StringPatterns = require('../string-patterns');
+var StringPatterns = require('./string-patterns');
 
-function GuitarPatterns(plugin) {
+function TabStringPatterns(plugin, defaultTuning) {
   this.tuning = plugin._super.params.tuning;
   if (!this.tuning) {
-    this.tuning = ['E,', 'A,', 'D', 'G' , 'B' , 'e'];
+    this.tuning = defaultTuning;
   }
   plugin.tuning = this.tuning;
   this.strings = new StringPatterns(plugin);
 }
 
-GuitarPatterns.prototype.notesToNumber = function (notes, graces) {
+TabStringPatterns.prototype.notesToNumber = function (notes, graces) {
   var converter = this.strings;
   return converter.notesToNumber(notes, graces);
 };
 
-GuitarPatterns.prototype.stringToPitch = function (stringNumber) {
+TabStringPatterns.prototype.stringToPitch = function (stringNumber) {
   var converter = this.strings;
   return converter.stringToPitch(stringNumber);
 };
 
 
-module.exports = GuitarPatterns;
+module.exports = TabStringPatterns;

package/src/tablatures/instruments/{violin/tab-violin.js → tab-string.js}

@@ -1,8 +1,8 @@
 
-var StringTablature = require('../string-tablature');
-var TabCommon = require('../../tab-common');
-var TabRenderer = require('../../tab-renderer');
-var ViolinPatterns = require('./violin-patterns');
+var StringTablature = require('./string-tablature');
+var TabCommon = require('../tab-common');
+var TabRenderer = require('../tab-renderer');
+var TabStringPatterns = require('./tab-string-patterns');
 
 
 /**
@@ -11,18 +11,20 @@ var ViolinPatterns = require('./violin-patterns');
 *  @param {*} tuneNumber  the parsed tune AST tree
  * @param {*} params  complementary args provided to Tablature Plugin
  */
-Plugin.prototype.init = function (abcTune, tuneNumber, params) {
+Plugin.prototype.init = function (abcTune, tuneNumber, params, staffNumber, tabSettings) {
   var _super = new TabCommon(abcTune, tuneNumber, params);
   this.abcTune = abcTune;
   this._super = _super;
   this.linePitch = 3;
-  this.nbLines = 4;
-  this.isTabBig = false;
+  this.nbLines = tabSettings.defaultTuning.length;
+  this.isTabBig = tabSettings.isTabBig;
+  this.tabSymbolOffset = tabSettings.tabSymbolOffset;
   this.capo = params.capo;
   this.transpose = params.visualTranspose;
+  this.hideTabSymbol = params.hideTabSymbol;
   this.tablature = new StringTablature(this.nbLines,
     this.linePitch);
-  var semantics = new ViolinPatterns(this);
+  var semantics = new TabStringPatterns(this, tabSettings.defaultTuning);
   this.semantics = semantics;
 };
 
@@ -38,8 +40,8 @@ function Plugin() {}
 //
 // Tablature plugin definition
 //
-var AbcViolinTab = function () {
-  return { name: 'ViolinTab', tablature: Plugin };
+var AbcStringTab = function () {
+  return { name: 'StringTab', tablature: Plugin };
 };
 
-module.exports = AbcViolinTab;
+module.exports = AbcStringTab;

package/src/tablatures/tab-absolute-elements.js

@@ -60,13 +60,22 @@ function buildTabAbsolute(plugin, absX, relX) {
     icon: tabIcon,
     Ypos: tabYPos
   };
-  var tabAbsolute = new AbsoluteElement(element, 0, 0, "symbol", 0);
-  tabAbsolute.x = absX;
-  var tabRelative = new RelativeElement(tabIcon, 0, 0, 7.5, "tab");
-  tabRelative.x = relX;
-  tabAbsolute.children.push(tabRelative);
-  if (tabAbsolute.abcelem.el_type == 'tab') {
-    tabRelative.pitch = tabYPos;
+
+  // Offset the TAB symbol position if specified in the tab description
+  tabYPos += plugin.tabSymbolOffset;
+
+  // For tablature like whistle tab where you want the TAB symbol hidden
+  if (!plugin.hideTabSymbol){
+
+    var tabAbsolute = new AbsoluteElement(element, 0, 0, "symbol", 0);
+    tabAbsolute.x = absX;
+    var tabRelative = new RelativeElement(tabIcon, 0, 0, 7.5, "tab");
+    tabRelative.x = relX;
+    tabAbsolute.children.push(tabRelative);
+    if (tabAbsolute.abcelem.el_type == 'tab') {
+      tabRelative.pitch = tabYPos;
+    }
+    
   }
   return tabAbsolute;
 }