MPTKEvent Object

Runtime MIDI event object and per-event extensions. More...

Classes
class	MidiPlayerTK.MPTKEvent
	Represents a MIDI event used throughout MPTK. This class is central to script-based MIDI workflows in components such as MidiStreamPlayer, MidiFilePlayer, MidiFileLoader, and MPTKWriter. More...

Real-Time Generator Modifiers
Real-time SoundFont generator overrides at event level. These members and methods let you override generator values per event, both before note start and while voices are already playing. This enables expressive per-note timbre control in Maestro Pro. Per-generator modifiers associated with this event. Null when no modifier is defined. Version Maestro Pro
void	MidiPlayerTK.MPTKEvent.ClearSynthParameter ()
	Clears generator modifiers for this event and restores default SoundFont behavior.

Generator Query Utilities
Read-only helpers for modifiable generator metadata and values. Provides access to default/current normalized generator values, generator labels, and the list of generators that support runtime changes.
float	MidiPlayerTK.MPTKEvent.GetSynthParameterCurrentValue (fluid_gen_type genType)
	Gets the current value for a generator on this event. Each generator has a specific value range, see the generator list here. The returned value is normalized (between 0 and 1).
static List< MPTKListItem >	MidiPlayerTK.MPTKEvent.GetSynthParameterListGenerator ()
	Gets the list of modifiable generators. Returns a list of MPTKListItem where:

Detailed Description

Runtime MIDI event object and per-event extensions.

Function Documentation

ClearSynthParameter()

void MidiPlayerTK.MPTKEvent.ClearSynthParameter

(

)

Clears generator modifiers for this event and restores default SoundFont behavior.

Version

Maestro Pro

GetSynthParameterCurrentValue()

float MidiPlayerTK.MPTKEvent.GetSynthParameterCurrentValue

(

fluid_gen_type

genType

)

Gets the current value for a generator on this event.
Each generator has a specific value range, see the generator list here.
The returned value is normalized (between 0 and 1).

Version

Maestro Pro

Parameters

genType

Generator type. See ModifySynthParameter.

Returns

Normalized current value, or -1 when no modifier is defined for this generator.

GetSynthParameterListGenerator()

List< MPTKListItem > MidiPlayerTK.MPTKEvent.GetSynthParameterListGenerator ( )

static

Gets the list of modifiable generators.
Returns a list of MPTKListItem where:

• MPTKListItem.Index: generator ID
• MPTKListItem.Label: display text for the generator
• MPTKListItem.Position: position in the list, starting at 0

  Version

  Maestro Pro

  Returns

  List of modifiable generators (do not modify this list).