Repository navigation
Rendering issue: Unable to switch to Numbered Notation (jianpu) for specific tracks in v1.8.4 #2976
Description
Is there an existing issue for this?
- I have searched the existing issues
I have read the contribution rules
- I have read CONTRIBUTING.md and, if any AI agent helped draft this issue, AGENTS.md.
AI authorship
Written by a human, no AI assistance
Current Behavior
When loading certain Guitar Pro files (e.g., the attached test.gp), switching a specific track to Numbered Notation fails to render. The score area remains blank.
I have confirmed that this bug was not present in alphaTab versions 1.6.0 and earlier. It seems to have been introduced in a later version (I am currently testing on 1.8.4).
Please note: If I manually change the display mode of this problematic track to Standard Notation or Tablature , it renders normally. The issue only occurs specifically when enabling Numbered Notation for this track.
Expected Behavior
When I set staff.showNumbered = true (and disable other modes) and call player.render(), the track should correctly render the Numbered Notation on the canvas, just like it did in version 1.6.0.
Steps To Reproduce
- Download and load the test file (test.gp) provided in the "Anything else?" section below.
- Locate the specific track named "solo" in the score (note: it initially renders fine in standard notation or tablature, and I have randomly tested many other scores with the same issue).
- Try to switch the display mode of this track to Numbered Notation using the standard API (e.g., setting
staff.showNumbered = trueand updating the settings). - Call
api.render(). - Observe that the canvas remains blank (or there is no response/change) and the numbered notation fails to render.
Link to jsFiddle, CodePen, Project
No response
Version and Environment
[AlphaTab][VersionInfo] alphaTab 1.8.4
[AlphaTab][VersionInfo] Browser: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36
[AlphaTab][VersionInfo] Platform: BrowserModule
[AlphaTab][VersionInfo] WebPack: false
[AlphaTab][VersionInfo] Vite: false
[AlphaTab][VersionInfo] Window Size: 1529x1152
[AlphaTab][VersionInfo] Screen Size: 3840x1200Platform
Web
Anything else?
I am attaching the problematic Guitar Pro file (test.gp) for your debugging.
Metadata
Metadata
Assignees
Labels
Type
Fields
Priority
Effort
Area
Platform
Work State
Activity
yezhenbiao commentedon Oct 26, 2026
AlphaTab][Worker] An unexpected error occurred in worker TypeError: Cannot read properties of null (reading 'beat')
at get beatOfHighestNote (alphaTab.min.js:51:820263)
at Sl.calculateBeamingOverflows (alphaTab.min.js:51:936612)
at Sl.calculateOverflows (alphaTab.min.js:51:941523)
at Sl.doLayout (alphaTab.min.js:51:830011)
at Sl.doLayout (alphaTab.min.js:51:925434)
at Mc.addBar (alphaTab.min.js:51:863976)
at Dc.addBars (alphaTab.min.js:51:874041)
at Ic.X_ (alphaTab.min.js:51:901855)
at Ic.I_ (alphaTab.min.js:51:900221)
at Ic.doLayoutAndRender (alphaTab.min.js:51:895917)
AvaTheArchitect commentedon Oct 26, 2026
AvaTheArchitect commentedon Oct 26, 2026