Synth Engine (MidiSynth)

Core sample-based SoundFont synthesizer shared by all Maestro MPTK prefabs. More...

Topics
	Core Synth Concepts
	Core behavior, lifecycle, and shared architecture of MidiSynth.
	Runtime Control and Performance
	Runtime tuning, threading, buffering, and audio-side controls.
	Pro Runtime Extensions
	Maestro Pro real-time callbacks and advanced synth routing features.
	Spatial Audio and Attenuation
	Orientation- and distance-based spatial controls on MidiSynth.

Detailed Description

Core sample-based SoundFont synthesizer shared by all Maestro MPTK prefabs.

MidiSynth is the shared sample-based SoundFont synthesizer (C# port/adaptation of FluidSynth) used by all playback prefabs. It loads a SoundFont, receives MIDI events, allocates voices, applies SoundFont or Unity effects, and renders audio frames.

The adaptation includes:

• integration with Unity audio processing and AudioSource-based playback,
• runtime synchronization with Unity lifecycle and threading constraints,
• real-time MPTK extensions for synth behavior, event preprocessing, and live control.

Runtime players such as MidiFilePlayer, MidiStreamPlayer, MidiInReader, MidiListPlayer, and MidiExternalPlayer all inherit from MidiSynth, so they share the same audio engine and configuration surface.

Key topics:

• MPTK Synth Overview (concept and lifecycle)
• Add 3D Orientation and Attenuation (orientation and attenuation workflow)
• Maestro Pro Features (Maestro Pro features, including MidiSynth extensions)
• SoundFont management: SoundFont Management