applyPlaybackRangeFromHighlight

since 1.8.0

Description

Applies the playback range from the currently highlighted range. This method can be used when building custom selection systems (e.g. having draggable handles).

JavaScript

applyPlaybackRangeFromHighlight(): void

C#

void ApplyPlaybackRangeFromHighlight()

Kotlin

fun applyPlaybackRangeFromHighlight(): Unit

Examples

JavaScript

const api = new alphaTab.AlphaTabApi(document.querySelector('#alphaTab'));
const startBeat = api.score.tracks[0].staves[0].bars[0].voices[0].beats[0];
const endBeat = api.score.tracks[0].staves[0].bars[3].voices[0].beats[0];
api.highlightPlaybackRange(startBeat, endBeat);
api.applyPlaybackRangeFromHighlight();

C#

var api = new AlphaTabApi<MyControl>(...);
api.ChangeTrackVolume(new Track[] { api.Score.Tracks[0], api.Score.Tracks[1] }, 1.5);
api.ChangeTrackVolume(new Track[] { api.Score.Tracks[2] }, 0.5);
var startBeat = api.Score.Tracks[0].Staves[0].Bars[0].Voices[0].Beats[0];
var endBeat = api.Score.Tracks[0].Staves[0].Bars[3].Voices[0].Beats[0];
api.HighlightPlaybackRange(startBeat, endBeat);
api.ApplyPlaybackRangeFromHighlight();

Android

val api = AlphaTabApi<MyControl>(...)
val startBeat = api.score.tracks[0].staves[0].bars[0].voices[0].beats[0]
val endBeat = api.score.tracks[0].staves[0].bars[3].voices[0].beats[0]
api.highlightPlaybackRange(startBeat, endBeat)
api.applyPlaybackRangeFromHighlight()