Breaking changes on settings between 0.9.5 and 0.9.6
In 0.9.6 there was a bigger settings rework introduced that very likely broke every setup beside the default one. Please find all changes that were introduced below.
API changes​
| Before | After | Description |
|---|---|---|
AlphaTab.Settings.Defaults.netalphaTab.Settings.get_defaults()JavaScript | new AlphaTab.Settings().netnew alphaTab.Settings()JavaScript | The default values for all settings were moved to the constructor. Simply create a new object and all default settings will be configured. |
AlphaTabApi.updateLayout(settings,json,dataAttributes)JavaScript | This API was removed. Simply change the settings and call |
Settings changes​
Many settings have now a new place within the settings object, hence many settings might need adjustment in your code. The new
mechanism of specifying settings is way more tolerant than the old one: settings are now case insensitive (useWorkers is equal to uSeWoRkerS) and dashes on html attributes are also
ignored (data-use-workers is equal to data-useworkers).
.netis how the property is named on .net object levelJavaScriptis how the property is named on the JavaScript object level (alphaTab.Settings instance)JSONis how the property is named when specifying the property as input to alphaTab (usually short hand names)HTMLis how the property is named on HTML data attributes
| Before | After | Notes |
|---|---|---|
UseWorkers.netuseWorkerJavaScriptuseWorkerJSONdata-use-workerHTML | Core.UseWorkers.netcore.useWorkersJavaScriptcore.useWorkersJSONuseWorkersJSONdata-core-use-workersHTMLdata-use-workersHTML | |
LogLevel.netlogLevelJavaScriptloggingJSONdata-loggingHTML | Core.LogLevel.netcore.logLevelJavaScriptcore.logLevelJSONlogLevelJSONdata-core-loglevelHTMLdata-loglevelHTML | |
DisplayMode.netdisplayModeJavaScriptdisplayModeJSONdata-display-modeHTML | Notation.NotationMode.netnotation.notationModeJavaScriptnotation.notationModeJSONdata-notation-notationmodeHTML | |
Scale.netscaleJavaScriptscaleJSONdata-scaleHTML | Display.Scale.netdisplay.scaleJavaScriptdisplay.scaleJSONscaleJSONdata-display-scaleHTMLdata-scaleHTML | |
SlurHeight.netslurHeightJavaScriptslurHeightJSONdata-slur-heightHTML | Notation.SlurHeight.netnotation.slurHeightJavaScriptnotation.slurHeightJSONdata-notation-slur-heightHTML | |
Engine.netengineJavaScriptengineJSONdata-engineHTML | Core.Engine.netcore.engineJavaScriptcore.engineJSONengineJSONdata-core-engineHTMLdata-engineHTML | |
StretchForce.netstretchForceJavaScriptstretchForceJSONdata-stretch-forceHTML | Display.StretchForce.netdisplay.stretchForceJavaScriptdisplay.stretchForceJSONstretchForceJSONdata-display-stretchforceHTMLdata-stretchforceHTML | |
ForcePianoFingering.netforcePianoFingeringJavaScriptforcePianoFingeringJSONdata-force-piano-fingeringHTML | Notation.FingeringMode.netforcePianoFingeringJavaScriptforcePianoFingeringJSONdata-force-piano-fingeringHTML | Set it to |
EnableLazyLoading.netenableLazyLoadingJavaScriptlazyJSONdata-lazyHTML | Core.EnableLazyLoading.netCore.enableLazyLoadingJavaScriptcore.enableLazyLoadingJSONenableLazyLoadingJSONdata-core-enablelazyloadingHTMLdata-enablelazyloadingHTML | |
TranspositionPitches.nettranspositionPitchesJavaScripttranspositionPitchesJSONdata-transposition-pitchesHTML | Notation.TranspositionPitches.netNotation.transpositionPitchesJavaScriptNotation.transpositionPitchesJSONdata-notation-transpositionpitchesHTML | |
DisplayTranspositionPitches.netdisplayTranspositionPitchesJavaScriptdisplayTranspositionPitchesJSONdata-display-transposition-pitchesHTML | Notation.DisplayTranspositionPitches.netnotation.displayTranspositionPitchesJavaScriptnotation.displayTranspositionPitchesJSONdata-notation-displaytranspositionpitchesHTML | |
ScriptFile.netscriptFileJavaScriptscriptFileJSONdata-script-fileHTML | Core.ScriptFile.netcore.scriptFileJavaScriptcore.scriptFileJSONscriptFileJSONdata-core-script-fileHTMLdata-script-fileHTML | |
FontDirectory.netfontDirectoryJavaScriptfontDirectoryJSONdata-font-directoryHTML | Core.FontDirectory.netcore.fontDirectoryJavaScriptcore.fontDirectoryJSONfontDirectoryJSONdata-core-font-directoryHTMLdata-font-directoryHTML | |
SmallGraceTabNotes.netsmallGraceTabNotesJavaScriptsmallGraceTabNotesJSONdata-small-grace-tab-notesHTML | Notation.SmallGraceTabNotes.netnotation.smallGraceTabNotesJavaScriptnotation.smallGraceTabNotesJSONdata-notation-smallgracetabnotesHTML | |
FingeringMode.netfingeringModeJavaScriptfingeringModeJSONdata-fingering-modeHTML | Notation.FingeringMode.netnotation.fingeringModeJavaScriptnotation.fingeringModeJSONdata-notation-fingering-modeHTML | |
ExtendBendArrowsOnTiedNotes.netextendBendArrowsOnTiedNotesJavaScriptextendBendArrowsOnTiedNotesJSONdata-extend-bend-arrows-on-tied-notesHTML | Notation.ExtendBendArrowsOnTiedNotes.netnotation.extendBendArrowsOnTiedNotesJavaScriptnotation.extendBendArrowsOnTiedNotesJSONdata-notation-extendbendarrowsontiednotesHTML | |
ShowParenthesisForTiedBends.netshowParenthesisForTiedBendsJavaScriptshowParenthesisForTiedBendsJSONdata-show-parenthesis-for-tied-bendsHTML | Notation.ShowParenthesisForTiedBends.netnotation.showParenthesisForTiedBendsJavaScriptnotation.showParenthesisForTiedBendsJSONdata-notation-showparenthesisfortiedbendsHTML | |
ShowTabNoteOnTiedBend.netshowTabNoteOnTiedBendJavaScriptshowTabNoteOnTiedBendJSONdata-show-tab-note-on-tied-bendHTML | Notation.ShowTabNoteOnTiedBend.netnotation.showTabNoteOnTiedBendJavaScriptnotation.showTabNoteOnTiedBendJSONdata-notation-showtabnoteontiedbendHTML | |
ShowZeroOnDiveWhammy.netshowZeroOnDiveWhammyJavaScriptshowZeroOnDiveWhammyJSONdata-show-zero-on-dive-whammyHTML | Notation.ShowZeroOnDiveWhammy.netnotation.showZeroOnDiveWhammyJavaScriptnotation.showZeroOnDiveWhammyJSONdata-notation-showzeroondivewhammyHTML | |
ExtendLineEffectsToBeatEnd.netextendLineEffectsToBeatEndJavaScriptextendLineEffectsToBeatEndJSONdata-extend-line-effects-to-beat-endHTML | Notation.ExtendLineEffectsToBeatEnd.netnotation.extendLineEffectsToBeatEndJavaScriptnotation.extendLineEffectsToBeatEndJSONdata-notation-extendlineeffectstobeatendHTML | |
SongBookBendDuration.netsongBookBendDurationJavaScriptsongBookBendDurationJSONdata-song-book-bend-durationHTML | Player.SongBookBendDuration.netplayer.songBookBendDurationJavaScriptplayer.songBookBendDurationJSONdata-player-songbookbenddurationHTML | |
SongBookDipDuration.netsongBookDipDurationJavaScriptsongBookDipDurationJSONdata-song-book-dip-durationHTML | Player.SongBookDipDuration.netplayer.songBookDipDurationJavaScriptplayer.songBookDipDurationJSONdata-player-songbookdipdurationHTML | |
Layout.Mode.netlayout.modeJavaScriptlayout.modeJSONlayoutJSONdata-layoutHTML | Display.LayoutMode.netdisplay.layoutModeJavaScriptdisplay.layoutModeJSONlayoutModeJSONdata-display-layout-modeHTMLdata-layout-modeHTML | The display mode is now a strong typed enumeration. |
Layout.AdditionalSettings["barsPerRow"].netlayout.additionalSettings.barsPerRowJavaScriptlayout.additionalSettings.barsPerRowJSONdata-layout-bars-per-rowHTML | Display.BarsPerRow.netdisplay.barsPerRowJavaScriptdisplay.barsPerRowJSONbarsPerRowJSONdata-display-barsperrowHTMLdata-barsperrowHTML | |
Layout.AdditionalSettings["start"].netlayout.additionalSettings.startJavaScriptlayout.additionalSettings.startJSONdata-layout-startHTML | Display.StartBar.netdisplay.startBarJavaScriptdisplay.startBarJSONstartBarJSONdata-display-startbarHTMLdata-startbarHTML | |
Layout.AdditionalSettings["count"].netlayout.additionalSettings.countJavaScriptlayout.additionalSettings.countJSONdata-layout-countHTML | Display.BarCount.netdisplay.barCountJavaScriptdisplay.barCountJSONbarCountJSONdata-display-barcountHTMLdata-barcountHTML | |
Layout.AdditionalSettings["hideInfo"].netlayout.additionalSettings.hideInfoJavaScriptlayout.additionalSettings.hideInfoJSONdata-layout-hide-infoHTML | Display.HideInfo.netdisplay.hideInfoJavaScriptdisplay.hideInfoJSONhideInfoJSONdata-display-hideinfoHTMLdata-hideinfoHTML | |
Layout.AdditionalSettings["hideTuning"].netlayout.additionalSettings.hideTuningJavaScriptlayout.additionalSettings.hideTuningJSONdata-layout-hide-tuningHTML | Display.HideTuning.netdisplay.hideTuningJavaScriptdisplay.hideTuningJSONhideTuningJSONdata-display-hidetuningHTMLdata-hidetuningHTML | |
Layout.AdditionalSettings["hideChordDiagram"].netlayout.additionalSettings.hideChordDiagramJavaScriptlayout.additionalSettings.hideChordDiagramJSONdata-layout-hide-chord-diagramHTML | Display.HideChordDiagrams.netdisplay.hideChordDiagramsJavaScriptdisplay.hideChordDiagramsJSONhideChordDiagramsJSONdata-display-hidechorddiagramsHTMLdata-hidechorddiagramsHTML | |
Layout.AdditionalSettings["hideTrackNames"].netlayout.additionalSettings.hideTrackNamesJavaScriptlayout.additionalSettings.hideTrackNamesJSONdata-layout-hide-track-namesHTML | Display.HideTrackNames.netdisplay.hideTrackNamesJavaScriptdisplay.hideTrackNamesJSONhideTrackNamesJSONdata-display-hidetracknamesHTMLdata-hidetracknamesHTML | |
IncludeNoteBounds.netincludeNoteBoundsJavaScriptincludeNoteBoundsJSONdata-include-note-boundsHTML | Core.IncludeNoteBounds.netcore.includeNoteBoundsJavaScriptcore.includeNoteBoundsJSONincludeNoteBoundsJSONdata-core-includenoteboundsHTMLdata-includenoteboundsHTML | |
PlayTripletFeel.netplayTripletFeelJavaScriptplayTripletFeelJSONdata-play-triplet-feelHTML | player.PlayTripletFeel.netplayer.playTripletFeelJavaScriptplayer.playTripletFeelJSONdata-player-playtripletfeelHTML | |
Vibrato.NoteSlightAmplitude.netvibrato.noteSlightAmplitudeJavaScriptvibrato.noteSlightAmplitudeJSONdata-vibrato-note-slight-amplitudeHTML | Player.Vibrato.NoteSlightAmplitude.netplayer.vibrato.noteSlightAmplitudeJavaScriptplayer.vibrato.noteSlightAmplitudeJSONdata-player-vibrato-noteslightamplitudeHTML | |
Vibrato.NoteWideAmplitude.netvibrato.noteWideAmplitudeJavaScriptvibrato.noteWideAmplitudeJSONdata-vibrato-note-wide-amplitudeHTML | Player.Vibrato.NoteWideAmplitude.netplayer.vibrato.noteWideAmplitudeJavaScriptplayer.vibrato.noteWideAmplitudeJSONdata-player-vibrato-notewideamplitudeHTML | |
Vibrato.NoteSlightLength.netvibrato.noteSlightLengthJavaScriptvibrato.noteSlightLengthJSONdata-vibrato-note-slight-lengthHTML | Player.Vibrato.NoteSlightLength.netplayer.vibrato.noteSlightLengthJavaScriptplayer.vibrato.noteSlightLengthJSONdata-player-vibrato-noteslightlengthHTML | |
Vibrato.NoteWideLength.netvibrato.noteWideLengthJavaScriptvibrato.noteWideLengthJSONdata-vibrato-note-wide-lengthHTML | Player.Vibrato.NoteWideLength.netplayer.vibrato.noteWideLengthJavaScriptplayer.vibrato.noteWideLengthJSONdata-player-vibrato-notewidelengthHTML | |
Vibrato.BeatSlightAmplitude.netvibrato.beatSlightAmplitudeJavaScriptvibrato.beatSlightAmplitudeJSONdata-vibrato-beat-slight-amplitudeHTML | Player.Vibrato.BeatSlightAmplitude.netplayer.vibrato.beatSlightAmplitudeJavaScriptplayer.vibrato.beatSlightAmplitudeJSONdata-player-vibrato-beatslightamplitudeHTML | |
Vibrato.BeatWideAmplitude.netvibrato.beatWideAmplitudeJavaScriptvibrato.beatWideAmplitudeJSONdata-vibrato-beat-wide-amplitudeHTML | Player.Vibrato.BeatWideAmplitude.netplayer.vibrato.beatWideAmplitudeJavaScriptplayer.vibrato.beatWideAmplitudeJSONdata-player-vibrato-beatwideamplitudeHTML | |
Vibrato.BeatSlightLength.netvibrato.beatSlightLengthJavaScriptvibrato.beatSlightLengthJSONdata-vibrato-beat-slight-lengthHTML | Player.Vibrato.BeatSlightLength.netplayer.vibrato.beatSlightLengthJavaScriptplayer.vibrato.beatSlightLengthJSONdata-player-vibrato-beatslightlengthHTML | |
Vibrato.BeatWideLength.netvibrato.beatWideLengthJavaScriptvibrato.beatWideLengthJSONdata-vibrato-beat-wide-lengthHTML | Player.Vibrato.BeatWideLength.netplayer.vibrato.beatWideLengthJavaScriptplayer.vibrato.beatWideLengthJSONdata-player-vibrato-beatwidelengthHTML | |
Staves.Id.netstaves.idJavaScriptstaves.idJSONstavesJSONdata-stavesHTML | Display.StaveProfile.netdisplay.staveProfileJavaScriptdisplay.staveProfileJSONstaveProfileJSONdata-display-staveprofileHTMLdata-staveprofileHTML | |
Staves.AdditionalSettings["rhythm"].netstaves.additionalSettings.rhythmJavaScriptstaves.additionalSettings.rhythmJSONdata-staves-rhythmHTML | Notation.RhythmMode.netnotation.rhythmModeJavaScriptnotation.rhythmModeJSONdata-notation-rhythmmodeHTML | |
Staves.AdditionalSettings["rhythmBeams"].netstaves.additionalSettings.rhythmBeamsJavaScriptstaves.additionalSettings.rhythmBeamsJSONdata-staves-rhythm-beamsHTML | Notation.RhythmMode.netnotation.rhythmModeJavaScriptnotation.rhythmModeJSONdata-notation-rhythmmodeHTML | |
Staves.AdditionalSettings["rhythmHeight"].netstaves.additionalSettings.rhythmHeightJavaScriptstaves.additionalSettings.rhythmHeightJSONdata-staves-rhythm-heightHTML | Notation.RhythmHeight.netnotation.rhythmHeightJavaScriptnotation.rhythmHeightJSONdata-notation-rhythmheightHTML | |
EnablePlayer.netenablePlayerJavaScriptenablePlayerJSONdata-playerHTML | Player.EnablePlayer.netplayer.enablePlayerJavaScriptplayer.enablePlayerJSONdata-player-enableplayerHTML | On JavaScript earlier the setting controlled both enabling the player and which soundfont should be loaded.
Now it really only controls whether the player should be enabled. The soundfont is specified via |
SoundFontFile.netsoundFontFileJavaScriptsoundFontFileJSONdata-playerHTML | Player.SoundFont.netplayer.soundFontJavaScriptplayer.soundFontJSONdata-player-soundfontHTML | |
EnableCursor.netenableCursorJavaScriptcursorJSONdata-cursorHTML | Player.EnableCursor.netplayer.enableCursorJavaScriptplayer.enableCursorJSONdata-player-enablecursorHTML | |
ImporterSettings["encoding"].netimporter.encodingJavaScriptimporter.encodingJSONdata-importer-encodingHTML | Importer.Encoding.netimporter.encodingJavaScriptimporter.encodingJSONdata-importer-encodingHTML | |
Staves.ImporterSettings["musicXMLMergePartGroups"].netstaves.importer.musicXMLMergePartGroupsJavaScriptstaves.importer.musicXMLMergePartGroupsJSONdata-importer-musicxml-merge-part-groupsHTML | Importer.MergePartGroupsInMusicXml.netimporter.mergePartGroupsInMusicXmlJavaScriptimporter.mergePartGroupsInMusicXmlJSONdata-importer-mergepartgroupsinmusicxmlHTML | |
RenderingResources.CopyrightFont.netresources.copyrightFontJavaScriptresources.copyrightFontJSONdata-resources-copyright-fontHTML | Display.Resources.CopyrightFont.netdisplay.resources.copyrightFontJavaScriptdisplay.resources.copyrightFontJSONresources.copyrightFontJSONdata-display-resources-copyrightfontHTMLdata-resources-copyrightfontHTML | |
RenderingResources.TitleFont.netresources.titleFontJavaScriptresources.titleFontJSONdata-resources-title-fontHTML | Display.Resources.TitleFont.netdisplay.resources.titleFontJavaScriptdisplay.resources.titleFontJSONresources.titleFontJSONdata-display-resources-titlefontHTMLdata-resources-titlefontHTML | |
RenderingResources.SubTitleFont.netresources.subTitleFontJavaScriptresources.subTitleFontJSONdata-resources-subtitle-fontHTML | Display.Resources.SubTitleFont.netdisplay.resources.subTitleFontJavaScriptdisplay.resources.subTitleFontJSONresources.subTitleFontJSONdata-display-resources-subtitlefontHTMLdata-resources-subtitlefontHTML | |
RenderingResources.WordsFont.netresources.wordsFontJavaScriptresources.wordsFontJSONdata-resources-words-fontHTML | Display.Resources.WordsFont.netdisplay.resources.wordsFontJavaScriptdisplay.resources.wordsFontJSONresources.wordsFontJSONdata-display-resources-wordsfontHTMLdata-resources-wordsfontHTML | |
RenderingResources.EffectFont.netresources.effectFontJavaScriptresources.effectFontJSONdata-resources-effect-fontHTML | Display.Resources.EffectFont.netdisplay.resources.effectFontJavaScriptdisplay.resources.effectFontJSONresources.effectFontJSONdata-display-resources-effectfontHTMLdata-resources-effectfontHTML | |
RenderingResources.FretboardNumberFont.netresources.fretboardNumberFontJavaScriptresources.fretboardNumberFontJSONdata-resources-fretboard-number-fontHTML | Display.Resources.FretboardNumberFont.netdisplay.resources.fretboardNumberFontJavaScriptdisplay.resources.fretboardNumberFontJSONresources.fretboardNumberFontJSONdata-display-resources-fretboardnumberfontHTMLdata-resources-fretboardnumberfontHTML | |
RenderingResources.TablatureFont.netresources.tablatureFontJavaScriptresources.tablatureFontJSONdata-resources-tablature-fontHTML | Display.Resources.TablatureFont.netdisplay.resources.tablatureFontJavaScriptdisplay.resources.tablatureFontJSONresources.tablatureFontJSONdata-display-resources-tablaturefontHTMLdata-resources-tablaturefontHTML | |
RenderingResources.GraceFont.netresources.graceFontJavaScriptresources.graceFontJSONdata-resources-grace-fontHTML | Display.Resources.GraceFont.netdisplay.resources.graceFontJavaScriptdisplay.resources.graceFontJSONresources.graceFontJSONdata-display-resources-gracefontHTMLdata-resources-gracefontHTML | |
RenderingResources.BarNumberFont.netresources.barNumberFontJavaScriptresources.barNumberFontJSONdata-resources-bar-number-fontHTML | Display.Resources.BarNumberFont.netdisplay.resources.barNumberFontJavaScriptdisplay.resources.barNumberFontJSONresources.barNumberFontJSONdata-display-resources-barnumberfontHTMLdata-resources-barnumberfontHTML | |
RenderingResources.FingeringFont.netresources.fingeringFontJavaScriptresources.fingeringFontJSONdata-resources-fingering-fontHTML | Display.Resources.FingeringFont.netdisplay.resources.fingeringFontJavaScriptdisplay.resources.fingeringFontJSONresources.fingeringFontJSONdata-display-resources-fingeringfontHTMLdata-resources-fingeringfontHTML | |
RenderingResources.MarkerFont.netresources.markerFontJavaScriptresources.markerFontJSONdata-resources-marker-fontHTML | Display.Resources.MarkerFont.netdisplay.resources.markerFontJavaScriptdisplay.resources.markerFontJSONresources.markerFontJSONdata-display-resources-markerfontHTMLdata-resources-markerfontHTML | |
RenderingResources.StaffLineColor.netresources.staffLineColorJavaScriptresources.staffLineColorJSONdata-resources-staff-line-colorHTML | Display.Resources.StaffLineColor.netdisplay.resources.staffLineColorJavaScriptdisplay.resources.staffLineColorJSONresources.staffLineColorJSONdata-display-resources-stafflinecolorHTMLdata-resources-stafflinecolorHTML | |
RenderingResources.BarNumberColor.netresources.barNumberColorJavaScriptresources.barNumberColorJSONdata-resources-bar-number-colorHTML | Display.Resources.BarNumberColor.netdisplay.resources.barNumberColorJavaScriptdisplay.resources.barNumberColorJSONresources.barNumberColorJSONdata-display-resources-barnumbercolorHTMLdata-resources-barnumbercolorHTML | |
RenderingResources.BarSeparatorColor.netresources.barSeparatorColorJavaScriptresources.barSeparatorColorJSONdata-resources-bar-separator-colorHTML | Display.Resources.BarSeparatorColor.netdisplay.resources.barSeparatorColorJavaScriptdisplay.resources.barSeparatorColorJSONresources.barSeparatorColorJSONdata-display-resources-barseparatorcolorHTMLdata-resources-barseparatorcolorHTML | |
RenderingResources.MainGlyphColor.netresources.mainGlyphColorJavaScriptresources.mainGlyphColorJSONdata-resources-main-glyph-colorHTML | Display.Resources.MainGlyphColor.netdisplay.resources.mainGlyphColorJavaScriptdisplay.resources.mainGlyphColorJSONresources.mainGlyphColorJSONdata-display-resources-mainglyphcolorHTMLdata-resources-mainglyphcolorHTML | |
RenderingResources.SecondaryGlyphColor.netresources.secondaryGlyphColorJavaScriptresources.secondaryGlyphColorJSONdata-resources-secondary-glyph-colorHTML | Display.Resources.SecondaryGlyphColor.netdisplay.resources.secondaryGlyphColorJavaScriptdisplay.resources.secondaryGlyphColorJSONresources.secondaryGlyphColorJSONdata-display-resources-secondaryglyphcolorHTMLdata-resources-secondaryglyphcolorHTML | |
RenderingResources.ScoreInfoColor.netresources.scoreInfoColorJavaScriptresources.scoreInfoColorJSONdata-resources-score-info-colorHTML | Display.Resources.ScoreInfoColor.netdisplay.resources.scoreInfoColorJavaScriptdisplay.resources.scoreInfoColorJSONresources.scoreInfoColorJSONdata-display-resources-scoreinfocolorHTMLdata-resources-scoreinfocolorHTML | |
ScrollOffsetX.netscrollOffsetXJavaScriptplayerOffsetJSONplayerOffset[0]JSONdata-player-offsetHTML | player.ScrollOffsetX.netplayer.scrollOffsetXJavaScriptplayer.scrollOffsetXJSONdata-player-scrolloffsetxHTML | |
ScrollOffsetY.netscrollOffsetYJavaScriptplayerOffsetJSONplayerOffset[1]JSONdata-player-offsetHTML | player.ScrollOffsetY.netplayer.scrollOffsetYJavaScriptplayer.scrollOffsetYJSONdata-player-scrolloffsetyHTML | |
ScrollMode.netscrollModeJavaScriptautoScrollJSONdata-auto-scrollHTML | player.ScrollMode.netplayer.scrollModeJavaScriptplayer.scrollModeJSONdata-player-scrollmodeHTML | |
ScrollSpeed.netscrollSpeedJavaScriptscrollSpeedJSON | player.ScrollSpeed.netplayer.scrollSpeedJavaScriptplayer.scrollSpeedJSONdata-player-scrollspeedHTML | |
ScrollElement.netscrollElementJavaScriptscrollElementJSONdata-scroll-elementHTML | Player.ScrollElement.netplayer.scrollElementJavaScriptplayer.scrollElementJSONdata-player-scroll-elementHTML | |
BeatCursorWidth.netbeatCursorWidthJavaScriptbeatCursorWidthJSONdata-beat-cursor-widthHTML | Setting was removed4 use CSS like for the other stylings to set the width of the beat cursor. |
Side-by-side Comparison​
Right below you can find a side-by-side comparison between a settings object before and after the rework.
| Before | After |
|---|---|
{
scriptFile: null,
fontDirectory: null,
enableLazyLoading: true,
soundFontFile: null,
scrollElement: "html,body",
scale: 1,
engine: "default",
layout: {
mode: "page",
additionalSettings: {}
},
importerSettings: {},
stretchForce: 1,
forcePianoFingering: false,
staves: {
id: "default",
additionalSettings: {}
},
transpositionPitches: [],
displayTranspositionPitches: [],
logLevel: "info"
smallGraceTabNotes: true,
extendBendArrowsOnTiedNotes: true,
showParenthesisForTiedBends: true,
showTabNoteOnTiedBend: true,
displayMode: 0,
fingeringMode: 0,
showZeroOnDiveWhammy: false,
extendLineEffectsToBeatEnd: false,
vibrato: {
noteWideLength: 480,
noteWideAmplitude: 2,
noteSlightLength: 480,
noteSlightAmplitude: 2,
beatWideLength: 240,
beatWideAmplitude: 3,
beatSlightLength: 240,
beatSlightAmplitude: 3
}
playTripletFeel: true,
slurHeight: 7,
songBookBendDuration: 75,
songBookDipDuration: 150,
includeNoteBounds: false,
useWorkers: true,
enablePlayer: false,
enableCursor: false,
beatCursorWidth: 3,
scrollOffsetX: 0,
scrollOffsetY: 0,
scrollMode: "continuous",
scrollSpeed: 300,
renderingResources: {
copyrightFont: "bold 12px 'Arial'",
titleFont: "32px 'Georgia'",
subTitleFont: "20px 'Georgia'",
wordsFont: "15px 'Georgia'",
effectFont: "italic 12px 'Georgia'",
fretboardNumberFont: "11px 'Arial'",
tablatureFont: "13px 'Arial'",
graceFont: "11px 'Arial'",
staffLineColor: "#A5A5A5",
barSeparatorColor:"#222211",
barNumberFont: "11px 'Arial'",
barNumberColor: "#C80000"},
fingeringFont: "14px 'Georgia'",
markerFont: "bold 14px 'Georgia'",
mainGlyphColor: "#000000",
secondaryGlyphColor: "rgba(0,0,0,0.40)",
scoreInfoColor: "#000000"
}
} |
{
core: {
includeNoteBounds: false,
useWorkers: true,
logLevel: "info",
engine: "default",
enableLazyLoading: true,
scriptFile: "https://docs.alphatab.net/develop/js/alphaTab/alphaTab.js",
fontDirectory: "https://docs.alphatab.net/develop/js/alphaTab/Font/"
},
display: {
barCountPerPartial: 10
barCount: -1
startBar: 1
barsPerRow: -1
staveProfile: 'default'
layoutMode: 'page',
stretchForce: 1
scale: 1
padding: null,
resources: {
copyrightFont: "bold 12px 'Arial'",
titleFont: "32px 'Georgia'",
subTitleFont: "20px 'Georgia'",
wordsFont: "15px 'Georgia'",
effectFont: "italic 12px 'Georgia'",
fretboardNumberFont: "11px 'Arial'",
tablatureFont: "13px 'Arial'",
graceFont: "11px 'Arial'",
staffLineColor: "#A5A5A5",
barSeparatorColor:"#222211",
barNumberFont: "11px 'Arial'",
barNumberColor: "#C80000",
fingeringFont: "14px 'Georgia'",
markerFont: "bold 14px 'Georgia'",
mainGlyphColor: "#000000",
secondaryGlyphColor: "rgba(0,0,0,0.40)",
scoreInfoColor: "#000000"
}
},
importer: {
mergePartGroupsInMusicXml: false,
encoding: "utf-8"
},
notation: {
slurHeight: 7,
extendLineEffectsToBeatEnd: false,
showZeroOnDiveWhammy: false,
showTabNoteOnTiedBend: true,
showParenthesisForTiedBends: true,
extendBendArrowsOnTiedNotes: true,
smallGraceTabNotes: true,
displayTranspositionPitches: []
transpositionPitches: [],
rhythmHeight: 15,
rhythmMode: "hidden",
hideChordDiagrams: false,
hideTrackNames: false,
hideTuning: false,
hideInfo: false,
fingeringMode: "ScoreDefault",
notationMode: "GuitarPro"
}
player: {
playTripletFeel: true,
vibrato: {
beatSlightAmplitude: 3,
beatSlightLength: 240,
beatWideAmplitude: 3,
beatWideLength: 240,
noteSlightAmplitude: 2,
noteSlightLength: 480,
noteWideAmplitude: 2,
noteWideLength: 480,
}
songBookDipDuration: 150,
songBookBendDuration: 75,
scrollSpeed: 300,
scrollMode: "Continuous",
scrollOffsetY: 0,
scrollOffsetX: 0,
enableCursor: true,
enablePlayer: false,
scrollElement: "html,body",
soundFont: null
}
}
|