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

package/dist/alphaTab.js

@@ -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.
 *
@@ -190,9 +190,9 @@
 	* @internal
 	*/
 	var VersionInfo = 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}`);
@@ -18191,18 +18191,24 @@
 		_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();
@@ -18212,7 +18218,7 @@
 			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);
@@ -18271,7 +18277,7 @@
 			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));
@@ -18279,21 +18285,21 @@
 			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;
 		}
@@ -18311,7 +18317,7 @@
 			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);
 			}
 		}
@@ -18319,37 +18325,43 @@
 			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() {
@@ -18386,7 +18398,7 @@
 			}
 			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;
@@ -18425,7 +18437,7 @@
 			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();
@@ -18437,19 +18449,22 @@
 				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) {
@@ -18473,8 +18488,8 @@
 				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);
@@ -18577,7 +18592,7 @@
 			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();
@@ -18624,7 +18639,7 @@
 			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++) {
@@ -18638,7 +18653,7 @@
 				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++) {
@@ -18652,7 +18667,7 @@
 				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);
@@ -18662,7 +18677,7 @@
 			}
 			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);
@@ -18782,7 +18797,7 @@
 			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();
@@ -18801,8 +18816,8 @@
 				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();
@@ -22552,6 +22567,10 @@
 		* 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
@@ -22596,6 +22615,9 @@
 			this.track.percussionArticulations.push(newArticulation);
 			return index;
 		}
+		isUnpitchedInstrument(instrumentId) {
+			return this.instruments.has(instrumentId) && this.instruments.get(instrumentId).isUnpitched;
+		}
 	};
 	/**
 	* @internal
@@ -22910,6 +22932,7 @@
 					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));
@@ -24328,11 +24351,15 @@
 			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) {
@@ -28836,11 +28863,21 @@
 		*
 		* * 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`
@@ -29164,11 +29201,45 @@
 		* @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
@@ -30192,6 +30263,7 @@
 			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);
@@ -30202,6 +30274,9 @@
 				case "encoding":
 					obj.encoding = v;
 					return true;
+				case "gp3to5encoding":
+					obj.gp3To5encoding = v;
+					return true;
 				case "mergepartgroupsinmusicxml":
 					obj.mergePartGroupsInMusicXml = v;
 					return true;
@@ -30321,7 +30396,9 @@
 			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);
@@ -30364,6 +30441,15 @@
 				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;
@@ -45362,6 +45448,16 @@
 		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
@@ -45465,13 +45561,28 @@
 			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--]);
@@ -48561,7 +48672,7 @@
 		}
 		_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;
 			}
@@ -48577,10 +48688,12 @@
 		}
 		_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);
@@ -48593,11 +48706,30 @@
 		}
 		_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);
@@ -48619,7 +48751,7 @@
 		_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;
@@ -48646,7 +48778,7 @@
 			});
 			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;
@@ -48657,7 +48789,7 @@
 				} 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);
 			});
 		}
@@ -48749,6 +48881,9 @@
 		* ```
 		*/
 		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) {
@@ -48756,27 +48891,32 @@
 					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.
@@ -50062,7 +50202,8 @@
 			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;
@@ -50872,7 +51013,9 @@
 		}
 		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;
@@ -50966,7 +51109,7 @@
 					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;
@@ -54470,9 +54613,35 @@
 			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];
@@ -60794,14 +60963,22 @@
 		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 };
@@ -64393,8 +64570,11 @@
 			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();
@@ -70039,8 +70219,8 @@
 			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>";