Customize your controller with Actions and Events

You can configure each controller item to send one or more MIDI messages, depending on several types of actions applied to the item itself. For example, when moving a slider, you can send a MIDI control change, when pressing a button you can send a note, etc.

Each controller item can have an arbitrary number of actions, each action, when triggered, can send one or more MIDI messages.

Actions

On value changed

Available for the items where a modification of the value is involved, like moving a slider, rotating a knob and playing on the XY pad. Each movement will trigger will change the control’s value and, consequently, the MIDI messages defined for the action will be sent.

When applied to a XY Pad you can specify if the action is referred to the horizontal (x) or vertical (y) axis of the pad.

Touch began

This action is triggered when a finger is placed on an item. Buttons, pads and key switches use this action to determine when to send the corresponding MIDI messages. This action is typically associated with note on MIDI messages.

Touch ended

Action triggered when a finger is release from a controller item. This action is consequent to the Touch began action, so can be useful to complete a sequence of MIDI events. If you sent a MIDI note on for the Touch began event, here you will send the counterpart MIDI note off.

Note that this is not necessarily the case. You can’t send both Note on and Note off messages during the Touch began event. It’s up to you.

On tap

This is a convenience action that unifies the behavior of Touch began and Touch ended in a single event.

On appear

This action is triggered when the controller item is loaded and displayed on screen. Can be useful to send initialization messages to the controlled plugin or MIDI unit, such as default values or system messages (Sysex).

On disappear

Triggered when a controller item is unloaded, i.e. when closing the controller. Useful to send tear down messages to the controlled plugin or unit.

Events

Control by ONE Instrument is able to send the vast majority of MIDI messages.

Note On

Send a specific note on message. You can specify:

– the note name and octave, like C#2, or the note number where 0 is C-1

– the velocity of the note. If omitted, the default value of 64 will be used

– the channel where the note will be sent. If omitted, the channel of controller will be used. If not defined, channel 10 will be used.

Note: remember to send the Midi off message in a subsequent action, otherwise you’ll have the note playing indefinitely!

Note off

Send the note off message. You can specify:

– the note name and octave, like C#2, or the note number where 0 is C-1

– the channel where the note will be sent. If omitted, the channel of controller will be used. If not defined, channel 10 will be used.

MIDI Control change

Sends a specific MIDI Control change message. You can specify:

– The control number, from 0 to 127

– The value sent for the control. If omitted, will be used the value of the containing controller item, such as the slider or the knob where action of the message is defined. For buttons and pads, the default value is 127 for touch began and 0 for touch ended actions respectively

– The channel where the control change will be sent. If omitted, the channel of controller will be used. If not defined, channel 10 will be used.