Project-wide markers, owned by the engine alongside the master track. The setter applies markers directly; use ProjectCommands.setMasterTrackMarkers instead when the change should be undoable.

masterTrackRenderLead

abstract val masterTrackRenderLead: UInt

midiRecorder

abstract val midiRecorder: MidiRecorder?

Live MIDI capture into one clip, or null when the extension is absent. Backed by uapmd::MidiRecorder.

offlineRendering

abstract var offlineRendering: Boolean

playbackPosition

abstract var playbackPosition: Long

pluginHost

abstract val pluginHost: PluginHost

renderPlaybackPosition

abstract val renderPlaybackPosition: Long

sampleRate

abstract var sampleRate: Int

timeline

abstract val timeline: TimelineFacade

trackCount

abstract val trackCount: UInt

Functions

addEmptyTrack

abstract fun addEmptyTrack(): Int

addParameterMetadataChangedListener

fun SequencerEngine.addParameterMetadataChangedListener(instanceId: Int, dispatch: (() -> Unit) -> Unit = { it() }, replayCurrent: Boolean = true, onError: (Throwable) -> Unit = { println("Parameter metadata listener failed: $it") }, listener: (ParameterMetadataSnapshot) -> Unit): AutoCloseable

Snapshot/replay convenience over the existing native graph metadata event. Metadata is copied on the callback thread, before dispatching to the UI. No periodic reads. The dispatcher defaults to the native control thread; UI callers should supply their dispatcher. Close subscriptions before destroying the engine.

addPluginToTrack

abstract fun addPluginToTrack(trackIndex: Int, format: String, pluginId: String, callback: (instanceId: Int, trackIndex: Int, error: String?) -> Unit)

cleanupEmptyTracks

abstract fun cleanupEmptyTracks()

clearTrackDirtyState

abstract fun clearTrackDirtyState()

enqueueUmp

abstract fun enqueueUmp(instanceId: Int, ump: UIntArray, timestamp: Long)

findTrackForInstance

abstract fun findTrackForInstance(instanceId: Int): Int

getInputSpectrum

abstract fun getInputSpectrum(numBars: Int): FloatArray

getInstanceGroup

abstract fun getInstanceGroup(instanceId: Int): UByte

getOutputSpectrum

abstract fun getOutputSpectrum(numBars: Int): FloatArray

getPluginInstance

abstract fun getPluginInstance(instanceId: Int): PluginInstance?

getTrack

abstract fun getTrack(index: UInt): SequencerTrack

getTrackLatency

abstract fun getTrackLatency(trackIndex: Int): UInt

getTrackRenderLead

abstract fun getTrackRenderLead(trackIndex: Int): UInt

isTrackBusy

abstract fun isTrackBusy(trackIndex: Int): Boolean

True while a freeze render is in flight; the legend disables the track's controls.

isTrackDirty

abstract fun isTrackDirty(trackIndex: Int): Boolean

Track render/cache dirtiness: runtime state owned by the engine, separate from project-document history dirtiness.

markTrackDirty

abstract fun markTrackDirty(trackIndex: Int, dirty: Boolean = true)

notifyPluginEditorVisibilityChanged

abstract fun notifyPluginEditorVisibilityChanged(instanceId: Int, visible: Boolean)

SequencerEngine::notifyPluginEditorVisibilityChanged(). A host that shows or hides a plug-in editor itself (not through AppModel's plug-in UI requests, which notify on its behalf) must call this: true before the editor is shown, so an ARA editor view receives the current selection during setup, and false when it is hidden or fails to show.

pausePlayback

abstract fun pausePlayback()

registerAddinExtensionPoints

abstract fun registerAddinExtensionPoints(manager: AddinManager)

Publishes every extension point this engine offers into manager. Call before AddinManager.initialize.

removePluginInstance

abstract fun removePluginInstance(instanceId: Int): Boolean

removeTrack

abstract fun removeTrack(trackIndex: Int): Boolean

renderOffline

abstract fun renderOffline(settings: OfflineRenderSettings, progressCallback: (OfflineRenderProgress) -> Unit? = null, shouldCancel: () -> Boolean? = null): OfflineRenderResult

resumePlayback

abstract fun resumePlayback()

sendChannelPressure

abstract fun sendChannelPressure(instanceId: Int, pressure: Float)

sendNoteOff

abstract fun sendNoteOff(instanceId: Int, note: Int)

sendNoteOn

abstract fun sendNoteOn(instanceId: Int, note: Int)

sendPitchBend

abstract fun sendPitchBend(instanceId: Int, value: Float)

setActive

abstract fun setActive(active: Boolean)

setDefaultChannels

abstract fun setDefaultChannels(inputChannels: UInt, outputChannels: UInt)

setExternalPump

abstract fun setExternalPump(enabled: Boolean)

setInstanceGroup

abstract fun setInstanceGroup(instanceId: Int, group: UByte): Boolean

setParameterValue

abstract fun setParameterValue(instanceId: Int, index: Int, value: Double)

startPlayback

abstract fun startPlayback()

stopPlayback

abstract fun stopPlayback()

trackFreezePolicy

abstract fun trackFreezePolicy(trackIndex: Int): FreezePolicy

FrozenTrackManager::freezePolicyForTrack — what the user asked for.

trackFreezeRenderProgress

abstract fun trackFreezeRenderProgress(trackIndex: Int): OfflineRenderProgress?

Progress of the track's freeze render, or null when it is not rendering. FrozenTrackManager::renderProgressForTrack returns an optional for the same reason: only one track renders at a time, and only while Rendering.

trackFreezeState

abstract fun trackFreezeState(trackIndex: Int): FreezeRuntimeState

FrozenTrackManager::runtimeStateForTrack — what the engine is doing.