Using MIDI Polyphonic Expression (MPE)

Dreamsynth supports MPE, short for "MIDI Polyphonic Expression." It's a specialized MIDI protocol enabling multidimensional controllers for controlling multiple parameters of individual notes. MPE specifies the MIDI messages used for three dimensions of control, regardless of how a particular controller physically expresses them. MIDI channel 1 is used as a master channel for global pitch bend, aftertouch, etc.; MPE utilizes MIDI channels 2-15 for the remaining controller data.

To enable MPE mode, MPE needs to be be enabled in the Settings menu. Click the Settings gear icon in the top purple toolbar, then the Interface tab, then check the Enable MPE mode box. Exit out of the Settings window and click the MPE icon in the top tool bar.

Dreamsynth displays this fanciful graphic in the Synth Voice Assign section when MPE is enabled:

Do not enable MPE mode if you're not using an appropriate MPE controller. Dreamsynth will not play correctly with a standard USB MIDI controller.

MPE Control Tab

Pitch Bend check box and Range controls- At the top of the tab is a checkbox which enables pitch bend; to its right is the pitch bend range control. Its default setting is 48 semitones (four octaves). For best results you will need to match this number with your MPE controller's pitch bend setting (most MPE controllers default to 48 semitones).

IMPORTANT: If MPE mode is enabled, you must use a MPE controller set to ”Lower Mode” to achieve full MIDI control. If you're using a non-MPE MIDI Controller, or the QWERTY Musical Typing keyboard, only one mono voice will trigger.

Show/Hide Button - Clicking the Show button in the MPE panel highlights all of the available MPE mappable control sliders for the Dreamsynth with blue overlays atop panel controls. Click the Hide button to hide them.

To map a control slider, right-click or [OPTION]+click (Windows) / [CONT]+click (Mac) the slider you wish to map. This reveals the controller mapping menu. Select MPE Assign.

Options are: 
X (Pitch)
Y (Timbre)
Z (Pressure)

Note: Some MPE controllers such as the Roli Seaboard may have as many as five dimensions of expression. Dreamsynth utilizes the three standard dimensions: Pitch, Channel Pressure, and Timbre. Also, not all MPE controllers are equipped with a master/global pitch bender.

Once mapped, the Name and Parameter will be visible in the MPE tab. A yellow square indicator (X,Y,Z) also appears atop each of the mapped controls.

MPE Tab Columns

Right-clicking any of the column headers opens a popup menu allowing each header to be shown or hidden.

Name- Displays the name of the parameter being controlled.

Parameter- Displays and allows selection of the three controller types: X (Pitch), Y (Timbre), and Z (Pressure).

Absolute- Sets the Amt/Range of the controller to absolute or relative control.

Bipolar- Enables bipolar controller, i.e. the ability to add and subtract the parameter amount, as opposed to positive only.

Amount/Range- Sets the intensity of control range. If set to Absolute mode, two knobs appear for min/max settings.

Curve- These allow the customization of how controller data affect the movement of Dreamsynth's onscreen controls, ranging from exponential to linear to logarithmic curves. Click and drag on the red line and pull up or down to adjust the curve.

MPE Tab Parameters Right-Click

Right-clicking on an assigned parameter opens the menu above.

Remove- Deletes the selected MPE controller parameter.

Remove All- Deletes all MPE controller assignments for the patch. Dreamsynth displays a warning dialog prior to deletion in order to thwart potential disasters.

MPE Mappable Parameters

Below are all mappable Dreamsynth MPE parameters. Only polyphonic parameters (i.e. parameters that independently affect individual notes) can be mapped with MPE.

SECTION

PARAMETER

OSC 1

TUNE

OSC 1

A/B WAVE MIX

OSC 1

PULSE WIDTH

OSC 1

PULSE WIDTH MOD DEPTH

OSC 1

PAN

OSC 1

PAN MOD DEPTH

OSC 1

LEVEL

OSC 1

LEVEL MOD DEPTH

OSC 1

PITCH LFO MOD DEPTH

OSC 1

PITCH MOD 1 DEPTH

OSC 1

PITCH MOD 2 DEPTH

OSC 1

A/B WAVE MOD DEPTH

OSC 2

PITCH LFO MOD DEPTH

OSC 2

TUNE

OSC 2

PITCH MOD 1 DEPTH

OSC 2

PITCH MOD 2 DEPTH

OSC 2

A/B WAVE MIX

OSC 2

A/B WAVE MOD DEPTH

OSC 2

PULSE WIDTH

OSC 2

PULSE WIDTH MOD DEPTH

OSC 2

PAN

OSC 2

PAN MOD DEPTH

OSC 2

LEVEL

OSC 2

LEVEL MOD DEPTH

OSC 3

PITCH LFO MOD DEPTH

OSC 3

TUNE

OSC 3

PITCH MOD 1 DEPTH

OSC 3

PITCH MOD 2 DEPTH

OSC 3

A/B WAVE MIX

OSC 3

A/B WAVE MOD DEPTH

OSC 3

PULSE WIDTH

OSC 3

PULSE WIDTH MOD DEPTH

OSC 3

PAN

OSC 3

PAN MOD DEPTH

OSC 3

LEVEL

OSC 3

LEVEL MOD DEPTH

FILTER

CUTOFF FREQUENCY

FILTER

CUTOFF FREQUENCY MOD 1 DEPTH

FILTER

CUTOFF FREQUENCY MOD 2 DEPTH

FILTER

RESONANCE

FILTER

RESONANCE MOD DEPTH

FILTER

NOTCH

FILTER

NOTCH MOD DEPTH

FILTER

ENVELOPE MOD

FILTER

ENVELOPE MOD MOD DEPTH

FILTER

KEYBOARD TRACK

FILTER

KEYBOARD TRACK MOD DEPTH

VCF ENVELOPE

ATTACK

VCF ENVELOPE

DECAY

VCF ENVELOPE

SUSTAIN

VCF ENVELOPE

RELEASE

VCF ENVELOPE

VELOCITY AMOUNT

VCA ENVELOPE

ATTACK

VCA ENVELOPE

DECAY

VCA ENVELOPE

SUSTAIN

VCA ENVELOPE

RELEASE

VCA ENVELOPE

VELOCITY AMOUNT

STRINGS

TUNE

STRINGS

TUNE MOD DEPTH

STRINGS

VELOCITY AMOUNT

STRINGS

ATTACK

STRINGS

RELEASE

STRINGS

PAN

STRINGS

PAN MOD DEPTH

STRINGS

LEVEL

STRINGS

LEVEL MOD DEPTH

Popular MPE Controller Devices

Following is a list of popular MPE controllers as of 2022. We're sure your Sweetwater rep is just dying to sell you one (and follow up that sale with 47 phone calls: "Hi, this is Chad! How are those RCA to 1/4" adaptors workin' out for ya?")

Roli - Seaboard
Sensel - Morph
Expressive E - Osmose
Keith McMillen Instruments - K-Board Pro 4, QuNexus Red
Haken Audio - Continuum Fingerboard
Roger Linn Designs - Linnstrument
Artiphon - Instrument 1