Skip to content

fix(rendering): draw triplet feel once per bar and capo once per staff - #2992

Merged
Danielku15 merged 1 commit into
developfrom
feature/issue-2973
Oct 29, 2026
Merged

Danielku15 merged 1 commit into
developfrom
feature/issue-2973

Conversation

@Danielku15

@Danielku15 Danielku15 commented Oct 29, 2026 •

Copy link
Copy Markdown
Member

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.

Issues

Fixes #2973

Proposed changes

Effect bands are created per voice, and TripletFeelEffectInfo only checked for the first beat of the bar. Every voice therefore drew its own triplet feel indication, and on multi-staff tracks (e.g. piano) every staff did as well. CapoEffectInfo had the same per-voice duplication.

  • Triplet feel is a master bar property, so it now uses the same guard as tempo, section markers and free time: first beat of voice 0 on staff 0.
  • Capo is a per-staff property, so it only gets the voice 0 guard and is still shown once per staff.

Like tempo and markers, the triplet feel is not shown in a system where staff 0 is hidden (e.g. hideEmptyStaves). This is an existing limitation of all system-level effects and is better solved for all of them together.

A new visual test covers two voices and two staves with a triplet feel change and a different capo per staff. No existing reference changed.

Checklist

  • I consent that this change becomes part of alphaTab under its current or any future open source license
  • This PR is linked to an accepted issue (see above)
  • Changes are implemented
  • New tests were added
  • I have read AGENTS.md if an AI helped draft any part of this PR

AI authorship disclosure

  • No AI agent authored any part of this PR (description, code, tests, or commit messages)
  • An AI agent contributed to this PR. The AI-authored disclosure block
    (alphatab-ai-authored-v1) is present at the top of this body, and I have
    personally reviewed every change and can explain each one

Further details

  • This is a breaking change
  • This change will require update of the documentation/website

The triplet feel indication was created for every voice and every staff of a
bar, the capo text for every voice. Both now follow the guards used by tempo
and marker effects.

Fixes #2973
@Danielku15
Danielku15 merged commit 7165ee6 into develop Oct 29, 2026
6 checks passed
@Danielku15
Danielku15 deleted the feature/issue-2973 branch October 29, 2026 18:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Triplet feel indication is drawn once per voice in multi-voice bars

1 participant