Function

Use the Function tab to define how a selected control behaves in Operation mode. Select a control first; until you do, the Function tab and the Design tab show no details. You can select the control in Panel view or Tabular view.

Open the Function Tab

1. Select one control or select multiple controls in the CPG workspace Panel or Tabular view.
2. Click the Function tab in the Modifier Panel.
3. Configure the settings described below.

Controls

Allow User Editing

Turn this on to allow the user to edit this control. It is on by default.

When it is off, the user cannot change the control in Operation mode, but the control still appears and still shows its current value.

Allow User Editing is unavailable for a single Static Label (a Label with no parameter and no Script/Remote Name), because a Static Label is never editable in Operation mode. To make it available, give the Label a Script/Remote Name or map it to a parameter.

Lock Control Position

Turn this on to prevent accidental movement.

• You cannot move, resize, or delete a locked control on the panel.
• When you use multi-control selection, make sure all selected controls are unlocked first.

Properties

Show On All Panels

Turn this on to show the same control on every panel in the Control Panel Group.

• Edit the control from any panel.
• Apply the same Function and Design settings across all panels.
• Use this for shared controls such as navigation, presets, or admin actions.

Scripting and Remote Access

Use Script/Remote Name and Remote Enable to configure how the selected control is exposed to Lua scripting (the built-in scripting engine) and the Remote Control API. The details vary depending on the Mode you choose at the bottom of the Function tab.

These fields appear only when you select a single control.

When Mode Is Parameter

• Remote Enable: Turn on remote API access for this control.
• Remote Name: Enter the remote API name.
• Remote Name is unavailable until you turn on Remote Enable.
• Lua scripting is not available in Parameter mode.

When Mode Is Not Parameter

• Script/Remote Name: Enter the name used by Lua scripts and by the Remote Control API.
• Remote Enable: Turn on remote API access. If Script/Remote Name is blank, a default name is filled in for you.

Managed Devices

For a control in a Managed Device's Control Panel Group, the Properties section shows a single Script Name field instead. Enter the name the device's script uses for this control. There is no Remote Enable setting for these controls.

Default Names

When you turn on Remote Enable for a control that has no name yet, Cognio gives it a default name, so you do not need to name every control by hand. A name you have already entered is never replaced.

• A control mapped to a module parameter is named after that parameter, for example gain1.
• Any other control is named after its type as it appears in the Toolkit, for example fader1, button2, or radio1.

Default names are lowercase single words so they can be used directly as variables in Lua scripts. Each name uses the lowest number not already taken in the Control Panel Group, so the first fader you enable is fader1 even if the panel holds many faders.

A number freed up by deleting or renaming a control can be reused by the next control you enable. If a script refers to a control by a name that has been reused, it will act on the new control.

Parameter Range

Set how the selected control value behaves. This range applies to the control itself.

The Parameter Range section does not appear for Shapes or Icons, or when the selection includes any of them.

• Units: Choose display/semantic units.

  

  • dB
  • Ratio
  • Hz
  • Seconds
  • Milliseconds
  • Pan
  • Count
  • Percent
  • Custom

• Taper: Choose Log or Linear scaling (how quickly values change across the control travel). Taper is unavailable when Min or Max is 0 or less.

• Min: Set the lowest allowed value.
• Control Threshold: Set the value at which the control switches between off and on. See Control Threshold below.
• Max: Set the highest allowed value.
• Unity: Set the unity reference value (the neutral reference point, often 0 dB).
• Default: Set the value used when you reset the control to default.
• Increment/Decrement Amount: Set the step size used by increment/decrement actions.

For Radio Buttons and Droplists, Min and Max also set the number of options the control shows: one option for each whole number from Min to Max. For example, a Min of 0 and a Max of 4 gives five options. For an unmapped Radio Button or Droplist, you can set the number of options directly with # Options in the Option Text section of the Design tab, which adjusts Max for you.

For a control mapped to a module parameter, Min and Max are limited to that parameter's own range. You can narrow the range, but you cannot set it wider than the parameter allows.

Control Threshold

Control Threshold sets the value at which the control changes state. It starts halfway between Min and Max, and always stays between them: if you move Min or Max past it, the threshold moves with them.

• Buttons and LEDs: A two-state Button or LED shows as on when its value is at or above the threshold.
• Faders and Knobs: A Fader or Knob set to Preset or Navigation mode runs its command each time its value crosses the threshold, in either direction. Moving the control without crossing the threshold does not run the command.

Control Threshold is not available for Radio Buttons, Droplists, or Meters, or when the selection includes any of them.

Mode

Choose the control function mode from these four options:

• None
• Parameter
• Preset
• Navigation

The selected mode adds mode-specific settings below the Mode field.

The Mode section does not appear for Shapes or Icons, or when the selection includes any of them. See Basics and Icons.

None

Use this mode when you want a control for script/remote use only and no parameter, preset, or navigation behavior.

Setting Mode to None removes the control's parameter mapping. The control keeps its Script/Remote Name.

Parameter

Use this mode to map the control to a module parameter. When you select it, a second Parameter list appears, showing each Signal Path (the route through your DSP design) in the Site.

1. Click the Parameter list.
2. Expand a Signal Path to show its modules and Control Panel Groups.
3. Expand a module or Control Panel Group to show its parameters.
4. Select the parameter.

To map several controls to the same parameter, select them all before you choose the parameter.

Preset

Use this mode to assign preset actions. When you select it, a Command list appears with the options below.

Command

Choose one command:

• Recall
• Recall Entire Group - Recalls every preset in the selected preset group in one action, the same as the Recall button on a group row in the Presets Manager.
• Recall Group Presets - Special mode that appears only when the selected control is a Radio Button or a Droplist. See Recall Group Presets below.
• Recall Last Recalled Preset - Recalls the most recently recalled preset again.
• Recall Next in Group
  • If the last recalled preset is in the selected preset group, the system recalls the next preset by order in that group.
  • If the last recalled preset is not in the selected group, the system continues from the last preset that was recalled from that group.
  • If no preset in the group has been recalled yet, the system recalls the first preset in that group.
• Recall Previous in Group
  • If the last recalled preset is in the selected preset group, the system recalls the previous preset by order in that group.
  • If the last recalled preset is not in the selected group, the system continues from the last preset that was recalled from that group.
  • If no preset in the group has been recalled yet, the system recalls the last preset in that group.
• Update (stores current values of previously assigned controls)

Because each group keeps track of its own position, separate Next and Previous controls for different groups do not interfere with each other.

Preset Group

Select the preset group for a group-based command. This list appears for Recall Entire Group, Recall Group Presets, Recall Next in Group, and Recall Previous in Group, and shows all current preset groups.

Presets

Select the preset for Recall or Update. This list shows every current preset by name, including presets inside preset groups.

Last Recalled Preset is also available in Auto Text. This displays the name and number of the most recently recalled preset.

Recall Group Presets

Use Recall Group Presets to turn a Radio Button or Droplist into a preset selector for a whole preset group. Each preset in the group becomes one option on the control, and choosing an option recalls that preset.

1. Select a single Radio Button or Droplist. Recall Group Presets is not offered when several controls are selected, or for other control types.
2. Set Mode to Preset.
3. Set Command to Recall Group Presets.
4. Select the preset group.

The control shows one option per preset in the group, labeled with each preset's name. The number of options always matches the number of presets in the group, so # Options is not available for this control. You can change an option's label in the Option Text section of the Design tab. This relabels the option on this control only; it does not rename the preset.

Navigation

Use this mode to assign navigation behavior. When you select it, the Command list appears below.

Command

Choose one command:

• None
  • The control has no navigation behavior.
• Navigate to Next Control Panel
  • Moves to the next panel in the current Control Panel Group.
• Navigate to Previous Control Panel
  • Moves to the previous panel in the current Control Panel Group.
• Navigate to Specific Control Panel
  • Moves to the panel you choose in the Control Panel list, in any Control Panel Group.
  • If the panel is in a different Control Panel Group, that group opens at the chosen panel.
• Navigate to Control Panel List
  • Use this with a Radio Button or Droplist. The control is filled automatically with one option for each panel in the current Control Panel Group, labeled with the panel's name, and always shows the panel currently displayed. Choosing an option moves to that panel.
  • Works best with Show On All Panels.
  • This command has no effect on other control types.
• Navigate to ALL CPG View
  • Leaves the current Control Panel Group and opens the list of all Control Panel Groups.
  • In Cognio DesignOps, switches to the All Control Panel Groups tab, and reopens the tab if it was closed.
  • In the Web App, opens the Control Panel Groups page.

Control Panel

For Navigate to Specific Control Panel, select the target panel. The list shows each Control Panel Group; expand a group to choose one of its panels.

Loop

Turn this on to loop navigation with Navigate to Next Control Panel and Navigate to Previous Control Panel.

• Moving next from the last panel goes to the first panel.
• Moving previous from the first panel goes to the last panel.

When Loop is off, moving next from the last panel, or previous from the first panel, stays on the current panel.