The plugin can respond to three possible usages of the dial: rotate, press and rotate while pressed. Separate actions can be assigned for each type of use, and the editor is divided into three sections to visualize this. In addition, the plugin can respond to display tap as an alternative to pressing the dial and as a separate action for screen tap.

In each section, you define what Mackie Control command will be sent when activated (if any) and how the value should be visualized on the display when the midi command is sent or received.

Please note that if the plugin is in a stack, the "dial press" action is reserved for switching to the following plugin in the stack, and the plugin is never notified that the dial is pressed. Due to this, the following restriction is in place when the plugin is in a stack:

• The "Dial press action" will never be activated by a dial press. You can, however, configure a state icon on the display and trigger the action by tapping the display. This will work even when the plugin is in a stack.

• With all sections configured, the editor view is relatively large, but you can minimize/maximize individual sections by clicking the section header.

Let me give you a quick example to give you a sense of what you can do with a single dial.

1. Configure the "Dial rotate" action to control channel 1 volume fader, optionally with a suiting dB value display and display of a volume (VU) graph.

2. Configure the "Dial rotate while pressed" action to control channel 1 V-Pot (the panning of the channel) and to display a horizontal bar indicating the pan position, optionally with a +/- percentage.

3. Configure the "Dial press" action to control the mute of channel 1 and display a state icon that shows the current mute state.

With these settings in place, you can adjust the volume by rotating the dial, adjust the pan by rotating the dial while it is pressed, and mute/unmute the channel by pressing the dial (or the state icon on the display). The default value display shows the value for the "rotate" action. The value for the "rotate while pressed" action is shown while that action is performed, and the value will linger for 1.5 seconds after you have stopped turning the dial, after which time the "rotate" action value is restored on the display.

Worth mentioning here is that the "Dial press" action is only triggered on dial release, provided that you have not turned the dial since it was pressed. If you press the dial, rotate it and then release it, the "Dial press" action will not be triggered.

Mackie Control commands for faders, v-pots and scrub wheel are available for the rotate action.

For faders, commands with increasing or decreasing values are sent when you rotate the dial. Select the min and max values (0-127) to be sent when the dial is rotated and the step size with which the value should be incremented/decremented for each physical step of the dial. Set step size = 0 for a variable step size where you make minor adjustments if you turn the dial slowly and accelerated adjustments if you turn the dial fast.

V-Pots and scrub wheel send commands indicating if the dial is rotated clockwise or counterclockwise, so they don't have any min or max values.

• The default operation is to send increasing values when you turn the dial clockwise and decreasing values when the dial is turned counterclockwise. If you need a dial that works in reverse (sending decreasing values when you turn clockwise), please enter a negative step size.

You can choose from a built-in set of fader designs or add your own design. Please check the page for dial fader image files for more details on custom faders.

You can enter a title that will be displayed superimposed over the fader, and you can set the text and background colors to make the title visible against the fader background. The title can reference the LCD strip information for the channel by using the tags #LCDU# and #LCDL# for the upper and lower LCD strip rows. The Mackie channel number can be referenced using the tag #CHNR#. This is the sequential number counting from the first channel on the first Mackie Control device to the last channel on the last Mackie Control device.

A value can be displayed above the fader, and you can show the raw Midi value, a percentage (0 to 100% or -50- to 50%), a preconfigured pan value, a value from a translation file or a dB value. Some built-in dB files are available, and you can add your own dB configuration as described on the Fader DB Files page. You can set the text color for the value but no background color.

If the selected fader design can display a VU meter, you can select whether or not you want this displayed.

Since the fader and the title occupy the same space, you can select what will happen when the fader handle and the title "collide".

• If you select to move the title, it will be located on the left side of the fader when the handle is on the right half, and vice-versa.

• If you select to hide the title, it will be located on the left side of the fader when the handle is on the right half and hidden when the handle is on the left half.

• If you select to do nothing, it will be stationary on the left side of the fader, even when the handle occupies the same space.

You can choose from a built-in set of fader designs or add your own design. Please check the page for dial fader image files for more details on custom faders.

Displaying mute state
The mute state for the channel can be displayed using the fader graphics. At a minimum, you can colorize the fader handle with a color of your choice when the channel is muted. If the selected fader design includes a specific handle or background images to be used when the channel is muted, you can also select those.

You can choose from a built-in set of V-pot designs or add your own design. Please check the page for V-pot image files V2 for more details on custom faders.

The value display options are the same as described for the fader above, and you can set the text color. The value is displayed outside the V-pot. You can enter a title that will be displayed superimposed over the center of the V-pot and set the text color to make the title visible against the V-Pot. The title can reference the LCD strip information for the channel by using the tags #LCDU# and #LCDL# for the upper and lower LCD strip rows. The Mackie channel number can be referenced using the tag #CHNR#. This is the sequential number counting from the first channel on the first Mackie Control device to the last channel on the last Mackie Control device.

You can choose to display the V-pot in half or full size.

The V-pot state can be displayed with a ring around the centerpiece. A portion of the ring will be displayed according to the selected option:

• If the active span indication is From min to max (volume), the ring will be visible from the leftmost position (= midi value 0) to the current midi value.

• If the active span indication is From midpoint (pan), the ring will be visible from the center position (= midi value 64) to the current midi value (left or right).

• If the active span indication is From midpoint (spread), the ring will be visible from the center position (= midi value 0) to both sides with a total span at midi value 127.

• If the active span indication is At current value, the ring will be visible only at the current midi value.

• If the active span indication is None, the ring will not be visible.

You can select to send the same commands as when rotated, send different commands when you rotate the dial while pressed or have no action.

In addition to the commands for the rotate action, several "button commands" are available. Buttons send these commands on an actual Mackie Control device but control things that can be seen as "rotate functions" (e.g., move the cursor by rotating the dial). The functions available are linked to the selected Mackie Control layout, so it is essential to select the correct layout. Even for functions that exist for all layouts (e.g., "select previous/next channel"), different daws use different commands, increasing the importance of selecting the correct layout.

Please note that if you select a fader or v-pot for the "Rotate while pressed" action, you select which function to control, not how it will be displayed. Whether or not to display anything is determined by the "Display" dropdown field.

If you select "Same as above", the only available property is the step size. This configuration is targeted at giving the rotation action coarse control with larger steps and the rotation while pressed fine control with smaller steps.

For fader control, select the min and max values (0-127) to be sent when the dial is rotated and the step size with which the value should be incremented/decremented for each physical step of the dial.

The default operation is to send increasing values when you turn the dial clockwise and decreasing values when the dial is turned counterclockwise. If you need a dial that works in reverse (sending decreasing values when you turn clockwise), please enter a negative step size.

You can select not to have any graphical display for this action or choose between two bar types. In the picture, the upper one is the "pan" bar, where a triangle marks the current value (pan position). The lower bar is the "volume" bar filled from the left to indicate the current value.

For text display, you can show the raw Midi value, a percentage (0 to 100% or -50- to 50%), a preconfigured pan value, a value from a translation file or a dB value. Some built-in dB files are available, and you can add your own dB configuration as described on the Fader DB Files page.

The Rotate while pressed action has a second function where you can quickly select which channel the dial should control. With this feature enabled, you will get a menu on the dial screen when you press the dial and can select a channel by rotating the dial. The channel you select will immediately be set for all parts of the dial (Rotate, Rotate while pressed, Press and Tap) that reference channels.

You can select if the menu should show generic channel numbers or track names fetched from the upper or lower part of the LCD strip. The generic channel numbers will be shown if you select to show the LCD strip and the strip is blank (i.e., the plugin has no track information).

The timer is a delay before the channel selection menu is shown, and it works like this:

• If you press the dial and rotate it before this time has elapsed, you will activate the ordinary "Rotate while pressed" action.

• If you press the dial, wait until this time has elapsed and then rotate the dial, you will activate the channel selection function.

• Setting the timer to zero or a very low value will disable the ordinary "Rotate while pressed" action.

Please note that the channel selection feature will change the configuration for the dial. Assume that you have set the Rotate action to control channel 1 and then use the channel selection menu to select channel 2. Once that is done, the configuration for the dial will be to control channel 2.

When you select a channel, the plugin will set it for all parts referencing channels, so it is impossible to have different parts referencing different channels if you use this feature. Parts that do not reference channels are unaffected by the channel selection feature.

All "button commands" (sent by buttons on an actual Mackie Control device) are available for the press action. The command is sent when the dial is pressed or when the left half of the screen is tapped. Faders, v-pots and the scrub wheel are unavailable for the press action. Additional options depend on which command type you select.

If the action is placed in a stack, the action will never be triggered by a dial press, but you can define a state icon to be displayed on the display, and the action can be triggered by tapping the left half of the screen.

In the top left corner of the dial's display, you can enable a state icon showing the selected command's current state. Select the icons/images displayed for the On and Off states. Images can be of any size; they will be resized to fit in the space (40x40px).

Clicking on one of the Select buttons will open a file browse dialog where you navigate and select the image you want. If you want to use icons from the icon library, you need to navigate to where the image files for the icon library are located.

• Windows: "%appdata%\Elgato\StreamDeck\IconPacks"

• macOS: "~/Library/Application Support/com.elgato.StreamDeck/IconPacks"

The right screen tap action works precisely as the dial press action; you can send any "button command" when the right half of the screen is tapped. Additional options depend on which command type you select.

In the top right corner of the dial's display, you can enable a state icon showing the selected command's current state. Select the icons/images displayed for the On and Off states. Images can be of any size; they will be resized to fit in the space (40x40px or 90x90 if large icons are selected). The selected icon is displayed on the button.

Clicking on one of the Select buttons will open a file browse dialog where you navigate and select the image you want. If you want to use icons from the icon library, you need to navigate to where the image files for the icon library are located.

• Windows: "%appdata%\Elgato\StreamDeck\IconPacks"

• macOS: "~/Library/Application Support/com.elgato.StreamDeck/IconPacks"

If you have selected to show large icons in the dial press configuration, the icons will fill the entire screen space (for the dial), and the fader/V-pot/bar display for rotate actions is only visible while the dial is rotated.