Show staccato on tab-only staves

[efenderbosch]

Note

AI-authored disclosure (alphatab-ai-authored-v1)

Portions of this content were authored by an AI agent. The agent has read
AGENTS.md and the human submitter accepts responsibility for
compliance with the rules in that document.

What I see

Staccato notes show their dot on the standard-notation staff. When a track is shown as tab only, the staccato marking is lost. Nothing on the tab staff says the notes are staccato.

To reproduce, render this alphaTex with standard notation and tab:

\staff{score tabs}
:4 3.3{st} 5.2{st} 3.3 5.2

The first two notes have staccato dots on the standard staff. Now render it as tab only:

\staff{tabs}
:4 3.3{st} 5.2{st} 3.3 5.2

None of the notes show anything that tells the staccato ones apart.

What I'd expect

On a tab-only staff, a staccato dot above the tab for each staccato beat, in the row where other tab effects like P.M. and let ring go. A row above the tab stays readable in bars with many notes, where a dot squeezed in beside each fret number wouldn't.

When standard notation is also shown, its dots are enough, so tab wouldn't need to repeat them. That's the same rule alphaTab already uses for golpe.

I'm happy to implement it if you agree on the direction.

Environment

Rendered in the repo's playground (alphaTex editor demo), on develop at 20942cf. Output of alphaTab.Environment.printEnvironmentInfo():

[AlphaTab][VersionInfo] alphaTab 1.9.0
[AlphaTab][VersionInfo] commit: 20942cf2ebb49eb2db93cfba270a8fd85852685b
[AlphaTab][VersionInfo] build date: 2026-10-05T12:50:26.664Z
[AlphaTab][VersionInfo] High DPI: 2
[AlphaTab][VersionInfo] Platform: BrowserModule
[AlphaTab][VersionInfo] WebPack: false
[AlphaTab][VersionInfo] Vite: false
[AlphaTab][VersionInfo] Browser: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:157.0) Gecko/20100101 Firefox/157.0
[AlphaTab][VersionInfo] Window Size: 1728x1079
[AlphaTab][VersionInfo] Screen Size: 1728x1117

[Danielku15]

Valid point, it goes beyond just staccato but also other accentuation. Here a screenshot from Guitar Pro showing that other accentuation should move into the tab staff.

I'd need to check in code what existing mechanism fits best here to place those annotations. the most precise approach would be to have a separate EffectInfo+related band for note.accentuated and one for isStaccato (which should become an enum in future for staccatissimo support).

But I think we might have also some "beat effect" mechanism in TabNoteChordGlyph already which could place such elements.

[efenderbosch]

The branch I have on my fork adds this entry to TabBarRendererFactory:

            {
                effect: new StaccatoEffectInfo(),
                mode: EffectBandMode.OwnedTop,
                shouldCreate: staff => !staff.showStandardNotation
            },

And the new class:

export class StaccatoEffectInfo extends NoteEffectInfoBase {
    public get notationElement(): NotationElement {
        return NotationElement.EffectStaccato;
    }

    protected shouldCreateGlyphForNote(note: Note): boolean {
        return note.isStaccato;
    }

    public get sizingMode(): EffectBarGlyphSizing {
        return EffectBarGlyphSizing.SingleOnBeat;
    }

    public createNewGlyph(_renderer: BarRendererBase, _beat: Beat): EffectGlyph {
        return new ArticStaccatoAboveGlyph(0, 0);
    }

    public override canExpand(_from: Beat, _to: Beat): boolean {
        return false;
    }
}

Also adds a EffectStaccato entry to the NotationElement enum.

It renders correctly in my local playground. I can add the other accentuation to the PR if you want. Or let me know about TabNoteChordGlyph and I can adjust.