@coderline/alphatab 1.9.0-alpha.1855 → 1.9.0-alpha.1861

package/dist/alphaTab.core.mjs

@@ -1,5 +1,5 @@
 /*!
-* alphaTab v1.9.0-alpha.1855 (develop, build 1855)
+* alphaTab v1.9.0-alpha.1861 (develop, build 1861)
 *
 * Copyright © 2026, Daniel Kuschny and Contributors, All rights reserved.
 *
@@ -186,9 +186,9 @@ class AlphaTabError extends Error {
 * @internal
 */
 class VersionInfo {
-	static version = "1.9.0-alpha.1855";
-	static date = "2026-07-06T04:23:13.862Z";
-	static commit = "acae7e9eafc26b0209712e3c3d0c2f8564e25148";
+	static version = "1.9.0-alpha.1861";
+	static date = "2026-07-11T03:34:14.452Z";
+	static commit = "18845390986e826fff8ae285ee3630080dbd6653";
 	static print(print) {
 		print(`alphaTab ${VersionInfo.version}`);
 		print(`commit: ${VersionInfo.commit}`);
@@ -18187,18 +18187,24 @@ class Gp3To5Importer extends ScoreImporter {
 	_lyrics = [];
 	_barCount = 0;
 	_trackCount = 0;
-	_playbackInfos = [];
+	/**
+	* For 4 ports, 16 channels of information
+	*/
+	_midiChannelInfo = [];
 	_doubleBars = /* @__PURE__ */ new Set();
 	_clefsPerTrack = /* @__PURE__ */ new Map();
 	_keySignatures = /* @__PURE__ */ new Map();
 	_beatTextChunksByTrack = /* @__PURE__ */ new Map();
 	_directionLookup = /* @__PURE__ */ new Map();
 	_initialTempo;
+	_stringEncoding = "";
 	get name() {
 		return "Guitar Pro 3-5";
 	}
 	readScore() {
 		this._directionLookup.clear();
+		if (this.settings.importer.encoding !== "utf-8") this._stringEncoding = this.settings.importer.encoding;
+		else this._stringEncoding = this.settings.importer.gp3To5encoding;
 		this.readVersion();
 		this._score = new Score();
 		this.readScoreInformation();
@@ -18208,7 +18214,7 @@ class Gp3To5Importer extends ScoreImporter {
 		this._initialTempo = Automation.buildTempoAutomation(false, 0, 0, 0);
 		if (this._versionNumber >= 500) {
 			this.readPageSetup();
-			this._initialTempo.text = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+			this._initialTempo.text = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		}
 		this._initialTempo.value = IOHelper.readInt32LE(this.data);
 		if (this._versionNumber >= 510) GpBinaryHelpers.gpReadBool(this.data);
@@ -18267,7 +18273,7 @@ class Gp3To5Importer extends ScoreImporter {
 		directionsList.push(direction);
 	}
 	readVersion() {
-		let version = GpBinaryHelpers.gpReadStringByteLength(this.data, 30, this.settings.importer.encoding);
+		let version = GpBinaryHelpers.gpReadStringByteLength(this.data, 30, this._stringEncoding);
 		if (!version.startsWith(Gp3To5Importer._versionString)) throw new UnsupportedFormatError("Unsupported format");
 		version = version.substr(Gp3To5Importer._versionString.length + 1);
 		const dot = version.indexOf(String.fromCharCode(46));
@@ -18275,21 +18281,21 @@ class Gp3To5Importer extends ScoreImporter {
 		Logger.debug(this.name, `Guitar Pro version ${version} detected`);
 	}
 	readScoreInformation() {
-		this._score.title = GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
-		this._score.subTitle = GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
-		this._score.artist = GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
-		this._score.album = GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
-		this._score.words = GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
-		this._score.music = this._versionNumber >= 500 ? GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize) : this._score.words;
-		this._score.copyright = GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
-		this._score.tab = GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
-		this._score.instructions = GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		this._score.title = GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
+		this._score.subTitle = GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
+		this._score.artist = GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
+		this._score.album = GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
+		this._score.words = GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
+		this._score.music = this._versionNumber >= 500 ? GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize) : this._score.words;
+		this._score.copyright = GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
+		this._score.tab = GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
+		this._score.instructions = GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		const noticeLines = IOHelper.readInt32LE(this.data);
 		this._ensureLoopBoundary(noticeLines, Gp3To5Importer._maxNoticeLines, "notice line count");
 		let notice = "";
 		for (let i = 0; i < noticeLines; i++) {
 			if (i > 0) notice += "\r\n";
-			notice += GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize)?.toString();
+			notice += GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize)?.toString();
 		}
 		this._score.notices = notice;
 	}
@@ -18307,7 +18313,7 @@ class Gp3To5Importer extends ScoreImporter {
 		for (let i = 0; i < 5; i++) {
 			const lyrics = new Lyrics();
 			lyrics.startBar = IOHelper.readInt32LE(this.data) - 1;
-			lyrics.text = GpBinaryHelpers.gpReadStringInt(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+			lyrics.text = GpBinaryHelpers.gpReadStringInt(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 			this._lyrics.push(lyrics);
 		}
 	}
@@ -18315,37 +18321,43 @@ class Gp3To5Importer extends ScoreImporter {
 		this.data.skip(28);
 		const flags = IOHelper.readInt16LE(this.data);
 		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Title).isVisible = (flags & 1) !== 0;
-		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Title).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Title).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.SubTitle).isVisible = (flags & 2) !== 0;
-		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.SubTitle).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.SubTitle).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Artist).isVisible = (flags & 4) !== 0;
-		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Artist).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Artist).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Album).isVisible = (flags & 8) !== 0;
-		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Album).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Album).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Words).isVisible = (flags & 16) !== 0;
-		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Words).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Words).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Music).isVisible = (flags & 32) !== 0;
-		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Music).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Music).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.WordsAndMusic).isVisible = (flags & 64) !== 0;
-		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.WordsAndMusic).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.WordsAndMusic).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Copyright).isVisible = (flags & 128) !== 0;
-		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Copyright).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.Copyright).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.CopyrightSecondLine).isVisible = (flags & 128) !== 0;
-		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.CopyrightSecondLine).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
-		GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		ModelUtils.getOrCreateHeaderFooterStyle(this._score, ScoreSubElement.CopyrightSecondLine).template = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
+		GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 	}
 	readPlaybackInfos() {
-		this._playbackInfos = [];
-		let channel = 0;
-		for (let i = 0; i < 64; i++) {
-			const info = new PlaybackInformation();
-			info.primaryChannel = channel++;
-			info.secondaryChannel = channel++;
-			info.program = IOHelper.readInt32LE(this.data);
-			info.volume = this.data.readByte();
-			info.balance = this.data.readByte();
-			this.data.skip(6);
-			this._playbackInfos.push(info);
+		this._midiChannelInfo = [];
+		for (let port = 0; port < 4; port++) {
+			const portInfo = [];
+			this._midiChannelInfo.push(portInfo);
+			for (let channel = 0; channel < 16; channel++) {
+				const info = {
+					program: IOHelper.readInt32LE(this.data),
+					volume: this.data.readByte(),
+					balance: this.data.readByte(),
+					chorus: this.data.readByte(),
+					reverb: this.data.readByte(),
+					phase: this.data.readByte(),
+					tremolo: this.data.readByte()
+				};
+				this.data.skip(2);
+				portInfo.push(info);
+			}
 		}
 	}
 	readMasterBars() {
@@ -18382,7 +18394,7 @@ class Gp3To5Importer extends ScoreImporter {
 		}
 		if ((flags & 32) !== 0) {
 			const section = new Section();
-			section.text = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+			section.text = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 			section.marker = "";
 			GpBinaryHelpers.gpReadColor(this.data, false);
 			newMasterBar.section = section;
@@ -18421,7 +18433,7 @@ class Gp3To5Importer extends ScoreImporter {
 		this._score.addTrack(newTrack);
 		const mainStaff = newTrack.staves[0];
 		const flags = this.data.readByte();
-		newTrack.name = GpBinaryHelpers.gpReadStringByteLength(this.data, 40, this.settings.importer.encoding);
+		newTrack.name = GpBinaryHelpers.gpReadStringByteLength(this.data, 40, this._stringEncoding);
 		if ((flags & 1) !== 0) mainStaff.isPercussion = true;
 		if (this._versionNumber >= 500) newTrack.isVisibleOnMultiTrack = (flags & 8) !== 0;
 		if (this._score.stylesheet.perTrackDisplayTuning === null) this._score.stylesheet.perTrackDisplayTuning = /* @__PURE__ */ new Map();
@@ -18433,19 +18445,22 @@ class Gp3To5Importer extends ScoreImporter {
 			if (stringCount > i) tuning.push(stringTuning);
 		}
 		mainStaff.stringTuning.tunings = tuning;
-		const port = IOHelper.readInt32LE(this.data);
-		const index = IOHelper.readInt32LE(this.data) - 1;
+		const port = IOHelper.readInt32LE(this.data) - 1;
+		const channel = IOHelper.readInt32LE(this.data) - 1;
 		const effectChannel = IOHelper.readInt32LE(this.data) - 1;
 		this.data.skip(4);
-		if (index >= 0 && index < this._playbackInfos.length) {
-			const info = this._playbackInfos[index];
-			info.port = port;
-			info.isSolo = (flags & 16) !== 0;
-			info.isMute = (flags & 32) !== 0;
-			info.secondaryChannel = effectChannel;
-			if (GeneralMidi.isGuitar(info.program)) mainStaff.displayTranspositionPitch = -12;
-			newTrack.playbackInfo = info;
-		}
+		const mainMidiChannelInfo = this._midiChannelInfo[port][channel];
+		const trackPlaybackInfo = new PlaybackInformation();
+		trackPlaybackInfo.volume = mainMidiChannelInfo.volume;
+		trackPlaybackInfo.balance = mainMidiChannelInfo.balance;
+		trackPlaybackInfo.port = port;
+		trackPlaybackInfo.program = mainMidiChannelInfo.program;
+		trackPlaybackInfo.primaryChannel = channel;
+		trackPlaybackInfo.secondaryChannel = effectChannel;
+		trackPlaybackInfo.isSolo = (flags & 16) !== 0;
+		trackPlaybackInfo.isMute = (flags & 32) !== 0;
+		if (GeneralMidi.isGuitar(trackPlaybackInfo.program)) mainStaff.displayTranspositionPitch = -12;
+		newTrack.playbackInfo = trackPlaybackInfo;
 		mainStaff.capo = IOHelper.readInt32LE(this.data);
 		newTrack.color = GpBinaryHelpers.gpReadColor(this.data, false);
 		if (this._versionNumber >= 500) {
@@ -18469,8 +18484,8 @@ class Gp3To5Importer extends ScoreImporter {
 			this._readRseBank();
 			if (this._versionNumber >= 510) {
 				this.data.skip(4);
-				GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
-				GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+				GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
+				GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 			}
 		} else if (tuning[tuning.length - 1] < Gp3To5Importer._bassClefTuningThreshold) this._clefsPerTrack.set(newTrack.index, Clef.F4);
 		else this._clefsPerTrack.set(newTrack.index, Clef.G2);
@@ -18573,7 +18588,7 @@ class Gp3To5Importer extends ScoreImporter {
 		if ((flags & 2) !== 0) this.readChord(newBeat);
 		const beatTextAsLyrics = this.settings.importer.beatTextAsLyrics && track.index !== this._lyricsTrack;
 		if ((flags & 4) !== 0) {
-			const text = GpBinaryHelpers.gpReadStringIntUnused(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+			const text = GpBinaryHelpers.gpReadStringIntUnused(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 			if (beatTextAsLyrics) {
 				const lyrics = new Lyrics();
 				lyrics.text = text.trim();
@@ -18620,7 +18635,7 @@ class Gp3To5Importer extends ScoreImporter {
 		const chordId = ModelUtils.newGuid();
 		if (this._versionNumber >= 500) {
 			this.data.skip(17);
-			chord.name = GpBinaryHelpers.gpReadStringByteLength(this.data, 21, this.settings.importer.encoding);
+			chord.name = GpBinaryHelpers.gpReadStringByteLength(this.data, 21, this._stringEncoding);
 			this.data.skip(4);
 			chord.firstFret = IOHelper.readInt32LE(this.data);
 			for (let i = 0; i < 7; i++) {
@@ -18634,7 +18649,7 @@ class Gp3To5Importer extends ScoreImporter {
 			this.data.skip(26);
 		} else if (this.data.readByte() !== 0) if (this._versionNumber >= 400) {
 			this.data.skip(16);
-			chord.name = GpBinaryHelpers.gpReadStringByteLength(this.data, 21, this.settings.importer.encoding);
+			chord.name = GpBinaryHelpers.gpReadStringByteLength(this.data, 21, this._stringEncoding);
 			this.data.skip(4);
 			chord.firstFret = IOHelper.readInt32LE(this.data);
 			for (let i = 0; i < 7; i++) {
@@ -18648,7 +18663,7 @@ class Gp3To5Importer extends ScoreImporter {
 			this.data.skip(26);
 		} else {
 			this.data.skip(25);
-			chord.name = GpBinaryHelpers.gpReadStringByteLength(this.data, 34, this.settings.importer.encoding);
+			chord.name = GpBinaryHelpers.gpReadStringByteLength(this.data, 34, this._stringEncoding);
 			chord.firstFret = IOHelper.readInt32LE(this.data);
 			for (let i = 0; i < 6; i++) {
 				const fret = IOHelper.readInt32LE(this.data);
@@ -18658,7 +18673,7 @@ class Gp3To5Importer extends ScoreImporter {
 		}
 		else {
 			const strings = this._versionNumber >= 406 ? 7 : 6;
-			chord.name = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+			chord.name = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 			chord.firstFret = IOHelper.readInt32LE(this.data);
 			if (chord.firstFret > 0) for (let i = 0; i < strings; i++) {
 				const fret = IOHelper.readInt32LE(this.data);
@@ -18778,7 +18793,7 @@ class Gp3To5Importer extends ScoreImporter {
 		const reverb = IOHelper.readSInt8(this.data);
 		const phaser = IOHelper.readSInt8(this.data);
 		const tremolo = IOHelper.readSInt8(this.data);
-		if (this._versionNumber >= 500) tableChange.tempoName = GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+		if (this._versionNumber >= 500) tableChange.tempoName = GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		tableChange.tempo = IOHelper.readInt32LE(this.data);
 		if (tableChange.volume >= 0) this.data.readByte();
 		if (tableChange.balance >= 0) this.data.readByte();
@@ -18797,8 +18812,8 @@ class Gp3To5Importer extends ScoreImporter {
 			else if (wahType >= 0) beat.wahPedal = WahPedal.Open;
 		}
 		if (this._versionNumber >= 510) {
-			GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
-			GpBinaryHelpers.gpReadStringIntByte(this.data, this.settings.importer.encoding, this.settings.importer.maxDecodingBufferSize);
+			GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
+			GpBinaryHelpers.gpReadStringIntByte(this.data, this._stringEncoding, this.settings.importer.maxDecodingBufferSize);
 		}
 		if (tableChange.volume >= 0) {
 			const volumeAutomation = new Automation();
@@ -22548,6 +22563,10 @@ class InstrumentArticulationWithPlaybackInfo extends InstrumentArticulation {
 	* The balance to use when playing the note (-1 if using the default track balance).
 	*/
 	outputBalance = -1;
+	/**
+	* Whether this instrument was declared as an unpitched/percussion sound via `<midi-unpitched>`.
+	*/
+	isUnpitched = false;
 }
 /**
 * @internal
@@ -22592,6 +22611,9 @@ class TrackInfo {
 		this.track.percussionArticulations.push(newArticulation);
 		return index;
 	}
+	isUnpitchedInstrument(instrumentId) {
+		return this.instruments.has(instrumentId) && this.instruments.get(instrumentId).isUnpitched;
+	}
 }
 /**
 * @internal
@@ -22906,6 +22928,7 @@ class MusicXmlImporter extends ScoreImporter {
 				break;
 			case "midi-unpitched":
 				articulation.outputMidiNumber = Number.parseInt(c.innerText, 10) - 1;
+				articulation.isUnpitched = true;
 				break;
 			case "volume":
 				articulation.outputVolume = MusicXmlImporter._interpolatePercent(Number.parseFloat(c.innerText));
@@ -24324,11 +24347,15 @@ class MusicXmlImporter extends ScoreImporter {
 		note.isVisible = noteIsVisible;
 		if (note.percussionArticulation >= 0) return;
 		const trackInfo = this._indexToTrackInfo.get(track.index);
-		if (instrumentId !== null) note.percussionArticulation = trackInfo.getOrCreateArticulation(instrumentId, note);
-		else if (note.beat.voice.bar.staff.isPercussion && isPitched) {
+		if (!isPitched) {
+			note.percussionArticulation = trackInfo.getOrCreateArticulation(instrumentId ?? "", note);
+			return;
+		}
+		if (instrumentId !== null && trackInfo.isUnpitchedInstrument(instrumentId)) note.percussionArticulation = trackInfo.getOrCreateArticulation(instrumentId, note);
+		else if (note.beat.voice.bar.staff.isPercussion) {
 			const knownArticulation = PercussionMapper.getArticulationById(note.displayValue);
 			if (knownArticulation) note.percussionArticulation = knownArticulation.id;
-		} else if (!isPitched) note.percussionArticulation = trackInfo.getOrCreateArticulation("", note);
+		}
 	}
 	_parsePlay(element, note) {
 		for (const c of element.childElements()) switch (c.localName) {
@@ -28832,11 +28859,21 @@ class ImporterSettings {
 	*
 	* * Guitar Pro 7
 	* * Guitar Pro 6
-	* * Guitar Pro 3-5
 	* * MusicXML
 	*/
 	encoding = "utf-8";
 	/**
+	* The text encoding to use when decoding strings within GuitarPro3-5 files.
+	* @since 1.9.0
+	* @defaultValue `windows-1252`
+	* @category Importer
+	* @remarks
+	* Guitar Pro 3-5 encode strings as system specific ANSI encoding, typically Windows-1252 in western system cultures.
+	* This is different to the other typically used utf-8 encoding.
+	* Via this setting the Guitar Pro 3-5 specific decoding can be used.
+	*/
+	gp3To5encoding = "windows-1252";
+	/**
 	* If part-groups should be merged into a single track (MusicXML).
 	* @since 0.9.6
 	* @defaultValue `false`
@@ -29160,11 +29197,45 @@ class PlayerSettings {
 	* @since 0.9.7
 	* @defaultValue `true`
 	* @category Player
+	* @json_read_only
 	* @remarks
 	* This setting configures whether alphaTab provides the default user interaction features like selection of the playback range and "seek on click".
 	* By default users can select the desired playback range with the mouse and also jump to individual beats by click. This behavior can be contolled with this setting.
+	* @deprecated Use {@link enableSeekToClick} and {@link enablePlaybackRangeSelection} individually
+	*/
+	get enableUserInteraction() {
+		return this.enableSeekToClick || this.enablePlaybackRangeSelection;
+	}
+	/**
+	* @deprecated Use {@link enableSeekToClick} and {@link enablePlaybackRangeSelection} individually
+	*/
+	set enableUserInteraction(value) {
+		this.enableSeekToClick = value;
+		this.enablePlaybackRangeSelection = value;
+		this.resetPlaybackRangeOnClick = value;
+	}
+	/**
+	* Whether the a click on the music sheet triggers a player seek to the note/beat at the
+	* clicked location.
+	* @since 1.9.0
+	* @defaultValue `true`
+	* @category Player
+	*/
+	enableSeekToClick = true;
+	/**
+	* Whether user click and drag results in a selection defining the playback range.
+	* @since 1.9.0
+	* @defaultValue `true`
+	* @category Player
+	*/
+	enablePlaybackRangeSelection = true;
+	/**
+	* Whether a simple click (no range drag) should reset the current playback range.
+	* @since 1.9.0
+	* @defaultValue `true`
+	* @category Player
 	*/
-	enableUserInteraction = true;
+	resetPlaybackRangeOnClick = true;
 	/**
 	* The X-offset to add when scrolling.
 	* @since 0.9.6
@@ -30188,6 +30259,7 @@ class ImporterSettingsSerializer {
 		if (!obj) return null;
 		const o = /* @__PURE__ */ new Map();
 		o.set("encoding", obj.encoding);
+		o.set("gp3to5encoding", obj.gp3To5encoding);
 		o.set("mergepartgroupsinmusicxml", obj.mergePartGroupsInMusicXml);
 		o.set("beattextaslyrics", obj.beatTextAsLyrics);
 		o.set("maxdecodingbuffersize", obj.maxDecodingBufferSize);
@@ -30198,6 +30270,9 @@ class ImporterSettingsSerializer {
 			case "encoding":
 				obj.encoding = v;
 				return true;
+			case "gp3to5encoding":
+				obj.gp3To5encoding = v;
+				return true;
 			case "mergepartgroupsinmusicxml":
 				obj.mergePartGroupsInMusicXml = v;
 				return true;
@@ -30317,7 +30392,9 @@ class PlayerSettingsSerializer {
 		o.set("enablecursor", obj.enableCursor);
 		o.set("enableanimatedbeatcursor", obj.enableAnimatedBeatCursor);
 		o.set("enableelementhighlighting", obj.enableElementHighlighting);
-		o.set("enableuserinteraction", obj.enableUserInteraction);
+		o.set("enableseektoclick", obj.enableSeekToClick);
+		o.set("enableplaybackrangeselection", obj.enablePlaybackRangeSelection);
+		o.set("resetplaybackrangeonclick", obj.resetPlaybackRangeOnClick);
 		o.set("scrolloffsetx", obj.scrollOffsetX);
 		o.set("scrolloffsety", obj.scrollOffsetY);
 		o.set("scrollmode", obj.scrollMode);
@@ -30360,6 +30437,15 @@ class PlayerSettingsSerializer {
 			case "enableuserinteraction":
 				obj.enableUserInteraction = v;
 				return true;
+			case "enableseektoclick":
+				obj.enableSeekToClick = v;
+				return true;
+			case "enableplaybackrangeselection":
+				obj.enablePlaybackRangeSelection = v;
+				return true;
+			case "resetplaybackrangeonclick":
+				obj.resetPlaybackRangeOnClick = v;
+				return true;
 			case "scrolloffsetx":
 				obj.scrollOffsetX = v;
 				return true;
@@ -45358,6 +45444,16 @@ class BeatContainerGlyphBase extends Glyph {
 	scaleToWidth(beatWidth) {
 		this.width = beatWidth;
 	}
+	/**
+	* Repositions this beat so its {@link onTimeX} anchor lands at `target`, used for the
+	* centered full-bar note/rest (see {@link BarLayoutingInfo.isCenteredFullBar}). The default
+	* shifts the whole container, matching the regular (non-centered) positioning formula.
+	* {@link BeatContainerGlyph} overrides this to shift only its ink, keeping `x`/`width`
+	* spanning the full bar so bounds lookups and skyline emission stay correct.
+	*/
+	applyCenterOffset(target) {
+		this.x = target - this.onTimeX;
+	}
 }
 /**
 * @internal
@@ -45461,13 +45557,28 @@ class BeatContainerGlyph extends BeatContainerGlyphBase {
 		this.preNotes.renderer = this.renderer;
 		this.preNotes.container = this;
 		this.preNotes.doLayout();
-		this.onNotes.x = this.preNotes.x + this.preNotes.width;
+		this._layoutOnsetX();
 		this.onNotes.renderer = this.renderer;
 		this.onNotes.container = this;
 		this.onNotes.doLayout();
 		this.createBeatTies();
 		this.updateWidth();
 	}
+	/**
+	* Resets `preNotes.x`/`onNotes.x` to their natural (un-centered) baseline.
+	* Shared by {@link doLayout} and {@link applyCenterOffset} so the latter can be called
+	* repeatedly (once per `_scaleToForce` pass) without compounding a previous offset.
+	*/
+	_layoutOnsetX() {
+		this.preNotes.x = 0;
+		this.onNotes.x = this.preNotes.x + this.preNotes.width;
+	}
+	applyCenterOffset(target) {
+		this._layoutOnsetX();
+		const offset = target - this.onTimeX;
+		this.preNotes.x = offset;
+		this.onNotes.x = this.preNotes.x + this.preNotes.width;
+	}
 	createBeatTies() {
 		let i = this.beat.notes.length - 1;
 		while (i >= 0) this.createTies(this.beat.notes[i--]);
@@ -48557,7 +48668,7 @@ class AlphaTabApiBase {
 	}
 	_onBeatMouseDown(originalEvent, beat) {
 		if (this._isDestroyed) return;
-		if (this._hasCursor && this.settings.player.enableUserInteraction) {
+		if (this._hasCursor && this.settings.player.enablePlaybackRangeSelection) {
 			this._selectionStart = { beat };
 			this._selectionEnd = void 0;
 		}
@@ -48573,10 +48684,12 @@ class AlphaTabApiBase {
 	}
 	_onBeatMouseMove(originalEvent, beat) {
 		if (this._isDestroyed) return;
-		if (this.settings.player.enableUserInteraction) {
+		if (this.settings.player.enablePlaybackRangeSelection) {
 			if (!this._selectionEnd || this._selectionEnd.beat !== beat) {
-				this._selectionEnd = { beat };
-				this._cursorSelectRange(this._selectionStart, this._selectionEnd);
+				if (this._selectionStart?.beat !== beat) {
+					this._selectionEnd = { beat };
+					this._cursorSelectRange(this._selectionStart, this._selectionEnd);
+				}
 			}
 		}
 		this.beatMouseMove.trigger(beat);
@@ -48589,11 +48702,30 @@ class AlphaTabApiBase {
 	}
 	_onBeatMouseUp(originalEvent, beat) {
 		if (this._isDestroyed) return;
-		if (this._hasCursor && this.settings.player.enableUserInteraction) this.applyPlaybackRangeFromHighlight();
+		if (this._hasCursor) {
+			let shouldSeekToBeat = beat && this.settings.player.enableSeekToClick;
+			if (this.settings.player.enablePlaybackRangeSelection) {
+				if (this._internalApplyPlaybackRangeFromHighlight()) shouldSeekToBeat = false;
+			}
+			if (shouldSeekToBeat) this._seekToBeat(beat);
+		}
 		this.beatMouseUp.trigger(beat);
 		this.uiFacade.triggerEvent(this.container, "beatMouseUp", beat, originalEvent);
 		this._isBeatMouseDown = false;
 	}
+	_seekToBeat(beat) {
+		const tickCache = this._tickCache;
+		if (!tickCache) return;
+		this._currentBeat = null;
+		let beatTick = tickCache.getMasterBarStart(beat.voice.bar.masterBar) + (tickCache.getRelativeBeatPlaybackRange(beat)?.startTick ?? beat.playbackStart);
+		const playbackRange = this.playbackRange;
+		if (playbackRange) {
+			if (beatTick < playbackRange.startTick) beatTick = playbackRange.startTick;
+			else if (beatTick > playbackRange.endTick) beatTick = playbackRange.endTick;
+		}
+		if (this._player.state === PlayerState.Paused) this._cursorUpdateTick(beatTick, false, 1);
+		this.tickPosition = beatTick;
+	}
 	_onNoteMouseUp(originalEvent, note) {
 		if (this._isDestroyed) return;
 		this.noteMouseUp.trigger(note);
@@ -48615,7 +48747,7 @@ class AlphaTabApiBase {
 	_setupClickHandling() {
 		this.canvasElement.mouseDown.on((e) => {
 			if (!e.isLeftMouseButton) return;
-			if (this.settings.player.enableUserInteraction) e.preventDefault();
+			if (this.settings.player.enablePlaybackRangeSelection || this.settings.player.enableSeekToClick) e.preventDefault();
 			const relX = e.getX(this.canvasElement);
 			const relY = e.getY(this.canvasElement);
 			const beat = this._renderer.boundsLookup?.getBeatAtPos(relX, relY) ?? null;
@@ -48642,7 +48774,7 @@ class AlphaTabApiBase {
 		});
 		this.canvasElement.mouseUp.on((e) => {
 			if (!this._isBeatMouseDown) return;
-			if (this.settings.player.enableUserInteraction) e.preventDefault();
+			if (this.settings.player.enablePlaybackRangeSelection || this.settings.player.enableSeekToClick) e.preventDefault();
 			const relX = e.getX(this.canvasElement);
 			const relY = e.getY(this.canvasElement);
 			const beat = this._renderer.boundsLookup?.getBeatAtPos(relX, relY) ?? null;
@@ -48653,7 +48785,7 @@ class AlphaTabApiBase {
 			} else this._onNoteMouseUp(e, null);
 		});
 		this._renderer.postRenderFinished.on(() => {
-			if (!this._selectionStart || !this._hasCursor || !this.settings.player.enableUserInteraction) return;
+			if (!this._selectionStart || !this._hasCursor || !this.settings.player.enablePlaybackRangeSelection) return;
 			this._cursorSelectRange(this._selectionStart, this._selectionEnd);
 		});
 	}
@@ -48745,6 +48877,9 @@ class AlphaTabApiBase {
 	* ```
 	*/
 	applyPlaybackRangeFromHighlight() {
+		this._internalApplyPlaybackRangeFromHighlight();
+	}
+	_internalApplyPlaybackRangeFromHighlight() {
 		if (this._selectionEnd) {
 			const startTick = this._tickCache?.getBeatStart(this._selectionStart.beat) ?? this._selectionStart.beat.absolutePlaybackStart;
 			if ((this._tickCache?.getBeatStart(this._selectionEnd.beat) ?? this._selectionEnd.beat.absolutePlaybackStart) < startTick) {
@@ -48752,27 +48887,32 @@ class AlphaTabApiBase {
 				this._selectionStart = this._selectionEnd;
 				this._selectionEnd = t;
 			}
-		}
+		} else if (!this.settings.player.resetPlaybackRangeOnClick) return false;
 		if (this._selectionStart && this._tickCache) {
 			const tickCache = this._tickCache;
 			const realStartMasterBarStart = tickCache.getMasterBarStart(this._selectionStart.beat.voice.bar.masterBar);
 			const startBeatPlaybackStart = tickCache.getRelativeBeatPlaybackRange(this._selectionStart.beat)?.startTick ?? this._selectionStart.beat.playbackStart;
-			this._currentBeat = null;
-			if (this._player.state === PlayerState.Paused) this._cursorUpdateTick(realStartMasterBarStart + startBeatPlaybackStart, false, 1);
-			this.tickPosition = realStartMasterBarStart + startBeatPlaybackStart;
+			let seekToStart = this.settings.player.enableSeekToClick;
 			if (this._selectionEnd && this._selectionStart.beat !== this._selectionEnd.beat) {
+				seekToStart = true;
 				const realEndMasterBarStart = tickCache.getMasterBarStart(this._selectionEnd.beat.voice.bar.masterBar);
 				const endBeatPlaybackEnd = tickCache.getRelativeBeatPlaybackRange(this._selectionEnd.beat)?.endTick ?? this._selectionEnd.beat.playbackStart + this._selectionEnd.beat.playbackDuration;
 				const range = new PlaybackRange();
 				range.startTick = realStartMasterBarStart + startBeatPlaybackStart;
 				range.endTick = realEndMasterBarStart + endBeatPlaybackEnd - 50;
 				this.playbackRange = range;
-			} else {
+			} else if (this.settings.player.resetPlaybackRangeOnClick) {
 				this._selectionStart = void 0;
 				this.playbackRange = null;
 				this._cursorSelectRange(this._selectionStart, this._selectionEnd);
 			}
+			if (seekToStart) {
+				this._currentBeat = null;
+				if (this._player.state === PlayerState.Paused) this._cursorUpdateTick(realStartMasterBarStart + startBeatPlaybackStart, false, 1);
+				this.tickPosition = realStartMasterBarStart + startBeatPlaybackStart;
+			}
 		}
+		return true;
 	}
 	/**
 	* Clears the highlight markers marking the currently selected playback range.
@@ -50058,7 +50198,8 @@ class AlphaTabApi extends AlphaTabApiBase {
 		settings.player.enableCursor = false;
 		settings.player.playerMode = PlayerMode.Disabled;
 		settings.player.enableElementHighlighting = false;
-		settings.player.enableUserInteraction = false;
+		settings.player.enableSeekToClick = false;
+		settings.player.enablePlaybackRangeSelection = false;
 		settings.player.soundFont = null;
 		settings.display.scale = .8;
 		settings.display.stretchForce = .8;
@@ -50868,7 +51009,9 @@ class AlphaSynthWebWorker {
 	}
 	handleMessage(e) {
 		const data = e.data;
-		switch (data.cmd) {
+		const cmd = data.cmd;
+		if (!cmd) return;
+		switch (cmd) {
 			case "alphaSynth.initialize":
 				AlphaSynthWorkerSynthOutput.preferredSampleRate = data.sampleRate;
 				Logger.logLevel = data.logLevel;
@@ -50962,7 +51105,7 @@ class AlphaSynthWebWorker {
 				this._player.applyTranspositionPitches(data.transpositionPitches);
 				break;
 		}
-		if (data.cmd.startsWith("alphaSynth.exporter")) this._handleExporterMessage(e);
+		if (cmd.startsWith("alphaSynth.exporter")) this._handleExporterMessage(e);
 	}
 	_handleExporterMessage(ev) {
 		const data = ev.data;
@@ -54466,9 +54609,35 @@ class MultiVoiceContainerGlyph extends Glyph {
 		const force = this.renderer.layoutingInfo.spaceToForce(width);
 		this._scaleToForce(force, true);
 	}
+	/**
+	* `true` when every voice/track/staff contributes exactly one beat, of uniform duration,
+	* spanning the bar's entire duration - i.e. a single full-bar note/rest. Common engraving
+	* practice centers such notes horizontally within the bar rather than anchoring them right
+	* after the pre-beat content (Behind Bars, p. 41; see #2464).
+	*/
+	_isCenteredFullBar() {
+		const masterBar = this.renderer.bar.masterBar;
+		const layoutingInfo = this.renderer.layoutingInfo;
+		const springs = layoutingInfo.springs;
+		if (springs.size !== 1 || !springs.has(masterBar.start) || layoutingInfo.allGraceRods.size > 0) return false;
+		const spring = springs.get(masterBar.start);
+		return spring.allDurations.size === 1 && spring.longestDuration === masterBar.calculateDuration();
+	}
 	/** `emit=false`: positioning-only path; final skyline emission runs later via {@link scaleToWidth}. */
 	_scaleToForce(force, emit) {
 		this.width = this.renderer.layoutingInfo.calculateVoiceWidth(force);
+		if (this._isCenteredFullBar()) {
+			const barNumberWidth = this.renderer.barNumberWidth;
+			const target = (this.width - barNumberWidth) / 2;
+			for (const beatGlyphs of this.beatGlyphs.values()) {
+				const soleBeatGlyph = beatGlyphs[0];
+				soleBeatGlyph.x = 0;
+				soleBeatGlyph.applyCenterOffset(target);
+				soleBeatGlyph.scaleToWidth(this.width);
+				if (emit) this._emitBeatContainerSkyline(soleBeatGlyph);
+			}
+			return;
+		}
 		const positions = this.renderer.layoutingInfo.buildOnTimePositions(force);
 		for (const beatGlyphs of this.beatGlyphs.values()) for (let i = 0, j = beatGlyphs.length; i < j; i++) {
 			const currentBeatGlyph = beatGlyphs[i];
@@ -60790,14 +60959,22 @@ class LineBarRenderer extends BarRendererBase {
 	calculateBeamY(h, x) {
 		return this.calculateBeamYWithDirection(h, x, this.getBeamDirection(h));
 	}
+	barNumberGlyph;
+	get barNumberWidth() {
+		return this.barNumberGlyph?.width ?? 0;
+	}
 	createPreBeatGlyphs() {
 		super.createPreBeatGlyphs();
+		this.barNumberGlyph = void 0;
 		this.addPreBeatGlyph(new BarLineGlyph(false, this.bar.staff.track.score.stylesheet.extendBarLines));
 		this.createLinePreBeatGlyphs();
 		let hasSpaceAfterStartGlyphs = false;
 		if (this.index === 0) hasSpaceAfterStartGlyphs = this.createStartSpacing();
-		if (this.shouldCreateBarNumber()) this.addPreBeatGlyph(new BarNumberGlyph(0, this.getLineHeight(-.5), this.bar.index + 1));
-		else if (!hasSpaceAfterStartGlyphs) this.addPreBeatGlyph(new SpacingGlyph(0, 0, this.smuflMetrics.oneStaffSpace));
+		if (this.shouldCreateBarNumber()) {
+			const barNumberGlyph = new BarNumberGlyph(0, this.getLineHeight(-.5), this.bar.index + 1);
+			this.barNumberGlyph = barNumberGlyph;
+			this.addPreBeatGlyph(barNumberGlyph);
+		} else if (!hasSpaceAfterStartGlyphs) this.addPreBeatGlyph(new SpacingGlyph(0, 0, this.smuflMetrics.oneStaffSpace));
 	}
 	resolveClefDisplay() {
 		return { isVisible: false };
@@ -64389,8 +64566,11 @@ class NumberedBarRenderer extends LineBarRenderer {
 		if (this.index === 0 || this.bar.masterBar.isRepeatStart && this.staff.isCascadePrimary) this.addPreBeatGlyph(new BarLineGlyph(false, this.bar.staff.track.score.stylesheet.extendBarLines));
 		this.createLinePreBeatGlyphs();
 		const hasSpaceAfterStartGlyphs = this.createStartSpacing();
-		if (this.shouldCreateBarNumber()) this.addPreBeatGlyph(new BarNumberGlyph(0, this.getLineHeight(-.5), this.bar.index + 1));
-		else if (!hasSpaceAfterStartGlyphs) this.addPreBeatGlyph(new SpacingGlyph(0, 0, this.smuflMetrics.oneStaffSpace));
+		if (this.shouldCreateBarNumber()) {
+			const barNumberGlyph = new BarNumberGlyph(0, this.getLineHeight(-.5), this.bar.index + 1);
+			this.barNumberGlyph = barNumberGlyph;
+			this.addPreBeatGlyph(barNumberGlyph);
+		} else if (!hasSpaceAfterStartGlyphs) this.addPreBeatGlyph(new SpacingGlyph(0, 0, this.smuflMetrics.oneStaffSpace));
 	}
 	createLinePreBeatGlyphs() {
 		const timeSignatureDisplay = this.resolveTimeSignatureDisplay();
@@ -70035,8 +70215,8 @@ class GpifWriter {
 		scoreNode.addElement("FirstPageFooter").setCData("");
 		scoreNode.addElement("PageHeader").setCData("");
 		scoreNode.addElement("PageFooter").setCData("");
-		scoreNode.addElement("ScoreSystemsDefaultLayout").setCData(score.defaultSystemsLayout.toString());
-		scoreNode.addElement("ScoreSystemsLayout").setCData(score.systemsLayout.join(" "));
+		scoreNode.addElement("ScoreSystemsDefaultLayout").innerText = score.defaultSystemsLayout.toString();
+		scoreNode.addElement("ScoreSystemsLayout").innerText = score.systemsLayout.join(" ");
 		scoreNode.addElement("ScoreZoomPolicy").innerText = "Value";
 		scoreNode.addElement("ScoreZoom").innerText = "1";
 		scoreNode.addElement("MultiVoice").innerText = "1>";