uapmd-binding/dev.atsushieno.uapmd/JvmTimelineFacade

JvmTimelineFacade

class JvmTimelineFacade : TimelineFacade

Properties

addresses

open override val addresses: ProjectAddressBook

Translation between persistent document identities and runtime indexes.

commands

open override val commands: ProjectCommands

The undoable edits this project supports.

hasPendingPluginMutations

open override val hasPendingPluginMutations: Boolean

masterTimelineTrack

open override val masterTimelineTrack: TimelineTrack

trackCount

open override val trackCount: UInt

undoEngine

open override val undoEngine: UndoEngine

Functions

addAudioClip

open override fun addAudioClip(trackIndex: Int, position: TimelinePosition, reader: AudioFileReader, filepath: String): ClipAddResult

addEmptyTrack

open override fun addEmptyTrack(origin: MutationOrigin = MutationOrigin.User, callback: (Int, String?) -> Unit)

addMidiClipFromFile

open override fun addMidiClipFromFile(trackIndex: Int, position: TimelinePosition, filepath: String, nrpnToParameterMapping: Boolean = false): ClipAddResult

attachClipFragment

open override fun attachClipFragment(trackIndex: Int, fragment: ClipFragment, idPolicy: ObjectIdPolicy): ClipAddResult

attachTrackFragment

open override fun attachTrackFragment(fragment: TrackFragment, options: TrackAttachOptions, callback: (Int, String?) -> Unit)

calculateContentBounds

open override fun calculateContentBounds(): ContentBounds

captureClipFragment

open override fun captureClipFragment(trackIndex: Int, clipId: Int): ClipFragment?

Capture is non-destructive; deleting is a separate removeClip. Must NOT be called inside a documentTransaction. The returned fragment is owned by the caller.

captureTrackFragment

open override fun captureTrackFragment(trackIndex: Int, callback: (TrackFragment?, String?) -> Unit)

Both halves are asynchronous because a track owns live plug-in instances. The callback runs exactly once, on the thread completing the last plug-in operation. Capture must NOT be called inside a documentTransaction.

clearClipsFromTrack

open override fun clearClipsFromTrack(trackIndex: Int, origin: MutationOrigin = MutationOrigin.User): Boolean

Removes every clip on the track. True when at least one was removed.

documentTransaction

open override fun <T> documentTransaction(block: () -> T): T

Groups the document events produced by everything inside block into a single batch. Use whenever one user-visible action performs several mutations, or observers can see it half-applied. Calls nest.

getMidiClipNotes

open override fun getMidiClipNotes(trackIndex: Int, clipId: Int): List<MidiNoteData>?

Returns MIDI notes for the given clip, or null if the track/clip is not found or is not a MIDI clip. Empty list means a valid MIDI clip with no notes.

getState

open override fun getState(): TimelineState?

getTrack

open override fun getTrack(index: UInt): TimelineTrack

isClipEnabled

open override fun isClipEnabled(trackIndex: Int, clipId: Int): Boolean

loadPluginPreset

open override fun loadPluginPreset(instanceId: Int, presetIndex: Int, origin: MutationOrigin = MutationOrigin.User, completion: (UndoResult) -> Unit? = null)

loadProject

open override fun loadProject(filePath: String): ProjectResult

recordPluginInstanceAddition

open override fun recordPluginInstanceAddition(instanceId: Int, origin: MutationOrigin = MutationOrigin.User, completion: (UndoResult) -> Unit? = null)

Records a plug-in that has already been instantiated.

recordTrackAddition

open override fun recordTrackAddition(trackIndex: Int, origin: MutationOrigin = MutationOrigin.User, callback: (Int, String?) -> Unit)

Records an already-published, fully constructed track as one addition.

removeClip

open override fun removeClip(trackIndex: Int, clipId: Int): Boolean

open override fun removeClip(trackIndex: Int, clipId: Int, origin: MutationOrigin): Boolean

removePluginInstance

open override fun removePluginInstance(instanceId: Int, origin: MutationOrigin = MutationOrigin.User, completion: (UndoResult) -> Unit? = null)

Captures state, removes the instance, and records the removal as one step.

removeTrack

open override fun removeTrack(trackIndex: Int, origin: MutationOrigin = MutationOrigin.User, callback: (Int, String?) -> Unit)

replaceAudioClipContent

open override fun replaceAudioClipContent(trackIndex: Int, clipId: Int, filepath: String, markers: List<ClipMarkerData>, warps: List<AudioWarpPointData>, masterMarkers: List<ClipMarkerData>, origin: MutationOrigin = MutationOrigin.User): Boolean

Rebuilds an audio clip's source from its file with the given markers and warp points. A non-empty filepath switches the clip to that file and adopts its length; otherwise the clip keeps its length.

replaceMidiClipContent

open override fun replaceMidiClipContent(trackIndex: Int, clipId: Int, umpEvents: UIntArray, tickTimestamps: LongArray, origin: MutationOrigin = MutationOrigin.User): Boolean

Replaces a MIDI clip's authored content, resizing the clip to match.

setLoop

open override fun setLoop(enabled: Boolean, start: TimelinePosition, end: TimelinePosition)

setPluginState

open override fun setPluginState(instanceId: Int, state: ByteArray, origin: MutationOrigin = MutationOrigin.User, completion: (UndoResult) -> Unit? = null)

setTempo

open override fun setTempo(tempo: Double)

setTimelineChangedCallback

open override fun setTimelineChangedCallback(callback: () -> Unit?)

Registers a callback invoked after every clip add/remove and after loadProject(). Pass null to unregister.

setTimeSignature

open override fun setTimeSignature(numerator: Int, denominator: Int)