Tutorials/Using groupType in MKtlDescs:
Filter:
Tutorials (extension) | Libraries > Modality | External Control > MIDI

Tutorials/Using groupType in MKtlDescs
ExtensionExtension

Creating combined noteOn noteOff touch groups in MKtlDescs with groupType

Many MIDI devices create noteOn, noteOff and sometimes touch messages from the same physical element, a pianoKey, a drumpad, or button.

The \groupType key allows defining the following common and rare combinations of noteOn, noteOff and touch by a single name, and building them correctly:

Tutorials/Using_groupType_in_MKtlDescs

tag:description:noteOn:noteOff:touch:comment
\noteOnTrigtrigger pad127--
\noteOnVeltrig pad w/ vel.1-127--
\noteOnOffpiano key w/ on vel.1-1270-default
\noteOnOffButbutton on/off1270-
\noteOnOffVelpad/key w/ off vel.1-1271-127-rare
\noteOnOffTouchpad/key w/ polytouch1-12700-127semi-rare
\noteOnOffVelTouchpad/key w/ off vel and touch1-1271-1271-127very rare

Devices with only noteOn messages

These can be made simply by hand, or by using groupType keys \noteOnTrig and \noteOnVel.

The same two examples done with groupType:

Combined noteOn + noteOff variants

The \groupType keys \noteOnOff, \noteOnOffBut, \noteOnOffVel provide the most common combinations here.

If your controller element is very unusual, making its combination by hand is still the most flexible option. This works, and creates separate views for \on and \off, and gui layout will need to be done by hand.

For completeness - MKtlDesc.notePair is present in some desc files. It works and can be used to make noteOn + vel, noteOff + vel, but is not recommended anymore: groupType is simpler, shorter and more flexible.

Here are the three groupTypes supported:

Finally, the two types which include touch messages. These can be drum pads or piano keys with velocity that transmit polytouch pressure from a pad while it is held and pressed, and noteOff when letting go.