Skip to main content

v1.10

1.10.0โ€‹

Music Notationโ€‹

render: transposed tabs on playable stringsโ€‹

Guitar tabs of a track transposed with notation.transpositionPitches (or the alphaTex \transpose metadata tag) no longer show negative frets or frets beyond the neck. A note keeps its string while the shifted fret is playable there; otherwise it moves to another string, together with the notes it is tied, slid, or hammered to. Natural harmonics move to the node of the transposed pitch. Notes that fit on no string keep their string and show the fret in the new display.resources.tabUnplayableFretColor.

The loaded score is not changed: the new positions exist only on the rendered tab. Details: Transposed tablature.

render: chords and multiple voices on numbered stavesโ€‹

https://github.com/CoderLine/alphaTab/issues/2437

Numbered staves write every note instead of a single digit per beat. A chord is a stack of digits with the lowest note at the bottom, each with its own octave dots, accidental and augmentation dot; the duration lines stay with the lowest digit. Every voice is written on its own row, the first voice on top, with beats lined up in time.

The previous display with a single digit of the first voice, as in Guitar Pro, is available as the new NumberedNoteMode.SingleNote; it now shows the highest note of a chord. Details: Chords and multiple voices.

render: lyrics above or below the staff, or hiddenโ€‹

https://github.com/CoderLine/alphaTab/issues/2776

The new score.stylesheet.lyricsPlacement places lyrics LyricsPlacement.Below (default) or LyricsPlacement.Above the standard notation staff, or hides them with LyricsPlacement.Hidden, like the lyrics setting of the Guitar Pro stylesheet. Without standard notation, the lyrics move to the next shown staff (tablature, slash, numbered). alphaTex sets it with \lyricsPlacement, the Guitar Pro importer and exporter read and write it, and the MusicXML importer sets Above when all lyrics are placed above the staff. Details: Lyrics placement.

render: sharp and flat tuningsโ€‹

https://github.com/CoderLine/alphaTab/issues/2802

Tunings keep the sharp or flat spelling of the source file per string, and the score tuning and the staff tuning show the accidentals as โ™ฏ and โ™ญ. alphaTex keeps the spelling written in \tuning and writes it back on export, the Guitar Pro importer and exporter read and write the sharp or flat choice of the tuning, and the MusicXML importer reads the spelling from tuning-step and tuning-alter. The new Tuning.pitches holds the written pitch of every string as a SpelledPitch; Tuning.tunings gives the MIDI values of the same strings. Details: Sharp and flat tunings.

Kotlinโ€‹

kotlin: platform-independent alphaTab-core libraryโ€‹

https://github.com/CoderLine/alphaTab/issues/2458

alphaTab for Kotlin is published as two packages, like the .NET version. The new net.alphatab:alphaTab-core runs on any JVM 17 or newer: load files, render to PNG or SVG through alphaSkia, generate MIDI and synthesize audio on servers, in command-line tools or in desktop applications. net.alphatab:alphaTab stays the Android library with the AlphaTabView and is built on top of the core. Details: Platforms and packages and Render on the JVM.

Upgrade Notesโ€‹

Visual changesโ€‹

  • Low octave dots on numbered staves sit below the duration lines instead of between digit and lines, as in printed jiวŽnpว”.
  • Numbered staves show all notes of chords and all voices. Set notes of the numbered staff configuration to NumberedNoteMode.SingleNote (alphaTex: \defaultStaffDisplay numbered { notes singleNote }) for one digit per beat; see Single note mode.
  • Tuning names show the accidental as โ™ญ and โ™ฏ (Eโ™ญ) instead of the letter b (Eb).
  • Guitar Pro tunings with accidentals are written with sharps unless the file marks them as flat, like in Guitar Pro. Guitar Pro 6 files have no such mark and show sharps.
  • Lyrics of tab-only tracks are shown below the tab staff instead of above it. With standard notation and tabs, they sit directly below the standard notation staff. Set score.stylesheet.lyricsPlacement to LyricsPlacement.Above (alphaTex: \lyricsPlacement above) to show them above the staff.

Tuning pitchesโ€‹

  • Tuning.pitches is the stored tuning, Tuning.tunings is derived from it. Assign a new array to change a tuning: changing the array returned by tunings in place does not change the tuning anymore.
  • The score JSON stores the tuning as pitches with the written names like "D#4". JSON with the tunings values of earlier versions is still read.

Deprecated APIsโ€‹

  • Tuning.noteNames, Tuning.getTextForTuning and Tuning.getTextPartsForTuning are deprecated and keep their behavior. Use Tuning.pitches and SpelledPitch for the written name of a string.

Kotlin packagesโ€‹

  • Android apps need no change: net.alphatab:alphaTab brings in net.alphatab:alphaTab-core in the same version. Builds that do not resolve transitive dependencies must add alphaTab-core themselves.
  • The Android installation page moved to Installation (Kotlin); the old address redirects there.