Hiding dynamics

Hide every dynamics marking — ppp through fff and the crescendo / decrescendo hairpins — with a single stylesheet flag. Reach for it when you are generating a chord chart for a rhythm section where the dynamics are noise, a beginner-friendly view of a lesson score, or a print handout that leaves interpretation to the teacher.

Hide dynamics

What the flag does

score.stylesheet.hideDynamics is a score-wide boolean. When true, the renderer skips every dynamics glyph and hairpin during layout. Notes, rests, and articulations stay put; only the volume script disappears. The change is visual — playback still honors the underlying velocity data.

The flag lives on the stylesheet, so it belongs to the loaded Score, not to Settings. Set it after the score is parsed, then call api.render() to redraw.

Show it in code

import * as alphaTab from '@coderline/alphatab';

const container = getAlphaTabContainer();
const api = new alphaTab.AlphaTabApi(container, {
  core: { file: '/scores/song.gp' },
});

api.scoreLoaded.on((score) => {
  score.stylesheet.hideDynamics = true;
  api.render();
});

getAlphaTabContainer() is a placeholder for the platform-specific step of obtaining the render target — a <div> on Web, an AlphaTab control on .NET, or an AlphaTabView on Android. Every other line runs unchanged on all three runtimes.

Where to look next

• Dynamics, hairpins, and accents — the notation coverage page for the elements this flag hides.
• Toggling notation elements off — finer-grained control over individual notation categories via notation.elements.
• hideDynamics on the RenderStylesheet reference.
• notation.elements — the map that hides individual effect bands such as EffectDynamics and EffectCrescendo.
• scoreLoaded and render — the API surface used above.