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

open override val masterTrackRenderLead: UInt

midiRecorder

open override val midiRecorder: MidiRecorder?

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

offlineRendering

open override var offlineRendering: Boolean

playbackPosition

open override var playbackPosition: Long

pluginHost

open override val pluginHost: PluginHost

renderPlaybackPosition

open override val renderPlaybackPosition: Long

sampleRate

open override var sampleRate: Int

timeline

open override val timeline: TimelineFacade

trackCount

open override val trackCount: UInt

Functions

addEmptyTrack

open override 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

open override fun addPluginToTrack(trackIndex: Int, format: String, pluginId: String, callback: (Int, Int, String?) -> Unit)

cleanupEmptyTracks

open override fun cleanupEmptyTracks()

clearTrackDirtyState

open override fun clearTrackDirtyState()

enqueueUmp

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

findTrackForInstance

open override fun findTrackForInstance(instanceId: Int): Int

getInputSpectrum

open override fun getInputSpectrum(numBars: Int): FloatArray

getInstanceGroup

open override fun getInstanceGroup(instanceId: Int): UByte

getOutputSpectrum

open override fun getOutputSpectrum(numBars: Int): FloatArray

getPluginInstance

open override fun getPluginInstance(instanceId: Int): PluginInstance?

getTrack

open override fun getTrack(index: UInt): SequencerTrack

getTrackLatency

open override fun getTrackLatency(trackIndex: Int): UInt

getTrackRenderLead

open override fun getTrackRenderLead(trackIndex: Int): UInt

isTrackBusy

open override fun isTrackBusy(trackIndex: Int): Boolean

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

isTrackDirty

open override fun isTrackDirty(trackIndex: Int): Boolean

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

markTrackDirty

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

notifyPluginEditorVisibilityChanged

open override 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

open override fun pausePlayback()

registerAddinExtensionPoints

open override fun registerAddinExtensionPoints(manager: AddinManager)

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

removePluginInstance

open override fun removePluginInstance(instanceId: Int): Boolean

removeTrack

open override fun removeTrack(trackIndex: Int): Boolean

renderOffline

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

resumePlayback

open override fun resumePlayback()

sendChannelPressure

open override fun sendChannelPressure(instanceId: Int, pressure: Float)

sendNoteOff

open override fun sendNoteOff(instanceId: Int, note: Int)

sendNoteOn

open override fun sendNoteOn(instanceId: Int, note: Int)

sendPitchBend

open override fun sendPitchBend(instanceId: Int, value: Float)

setActive

open override fun setActive(active: Boolean)

setDefaultChannels

open override fun setDefaultChannels(inputChannels: UInt, outputChannels: UInt)

setExternalPump

open override fun setExternalPump(enabled: Boolean)

setInstanceGroup

open override fun setInstanceGroup(instanceId: Int, group: UByte): Boolean

setParameterValue

open override fun setParameterValue(instanceId: Int, index: Int, value: Double)

startPlayback

open override fun startPlayback()

stopPlayback

open override fun stopPlayback()

trackFreezePolicy

open override fun trackFreezePolicy(trackIndex: Int): FreezePolicy

FrozenTrackManager::freezePolicyForTrack — what the user asked for.

trackFreezeRenderProgress

open override 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

open override fun trackFreezeState(trackIndex: Int): FreezeRuntimeState

FrozenTrackManager::runtimeStateForTrack — what the engine is doing.