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
notesof the numbered staff configuration toNumberedNoteMode.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 letterb(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.lyricsPlacementtoLyricsPlacement.Above(alphaTex:\lyricsPlacement above) to show them above the staff.
Tuning pitchesโ
Tuning.pitchesis the stored tuning,Tuning.tuningsis derived from it. Assign a new array to change a tuning: changing the array returned bytuningsin place does not change the tuning anymore.- The score JSON stores the tuning as
pitcheswith the written names like"D#4". JSON with thetuningsvalues of earlier versions is still read.
Deprecated APIsโ
Tuning.noteNames,Tuning.getTextForTuningandTuning.getTextPartsForTuningare deprecated and keep their behavior. UseTuning.pitchesandSpelledPitchfor the written name of a string.
Kotlin packagesโ
- Android apps need no change:
net.alphatab:alphaTabbrings innet.alphatab:alphaTab-corein the same version. Builds that do not resolve transitive dependencies must addalphaTab-corethemselves. - The Android installation page moved to Installation (Kotlin); the old address redirects there.