ExtensionMany 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 |
| \noteOnTrig | trigger pad | 127 | - | - | |
| \noteOnVel | trig pad w/ vel. | 1-127 | - | - | |
| \noteOnOff | piano key w/ on vel. | 1-127 | 0 | - | default |
| \noteOnOffBut | button on/off | 127 | 0 | - | |
| \noteOnOffVel | pad/key w/ off vel. | 1-127 | 1-127 | - | rare |
| \noteOnOffTouch | pad/key w/ polytouch | 1-127 | 0 | 0-127 | semi-rare |
| \noteOnOffVelTouch | pad/key w/ off vel and touch | 1-127 | 1-127 | 1-127 | very rare |
These can be made simply by hand, or by using groupType keys \noteOnTrig and \noteOnVel.
The same two examples done with groupType:
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.