GlobalTuningTool Archives - Page 14 of 19

December 16, 2024

Configure Parameter Set Data

Using the below options you can configure the Parameter Set Data

Configure Set group
Create Set File
Load Set File

Configure Set group

To configure parameter set data:

Select any parameter set column, right-click, and select Settings. This displays the settings dialog box.

The “Edit” option is a toggle button that defaults to a disabled state to prevent unintentional edits.
When the “Edit” option is enabled, you can edit all fields except the Tuning tool version and String Value.
The tuning tool version is installed GTT Tool version and gets auto-populated.
By default, the product name will be the name of the device.
You can independently update each of the header metadata, Product name, Sink name, Flowchart version, and Set version.
You can include or exclude header metadata, which can be controlled by the Include Header option.
The Include Header option performs a data merge operation when the option is selected. This means that the header metadata is prepended to User Data and it will be reflected in both the String Values section and in hex format in the Hex Values section.
Any modification done in any header metadata or user data will immediately be reflected in String Value and Hex Values at the appropriate index.
Header metadata can only be included once.
There is no limitation on the number of characters entered in User data or Hex Values.
You can either enter values in the User data section or Hex values. Editing in Hex Values section would clear content of User data and vice versa.
All information is persistent and can be retained and displayed when the settings window is relaunched.
String Values or Hex Values will be stored and loaded in hex format. And, it can be exported or imported from the .Set file and .Setr file.

User settings created using an older version of GTT (W onwards) all the data would be treated as User data including the header part if it was included.
You must clear the header information manually if user data already includes header information. The header part can then be included as required. This is because earlier header metadata was editable which is now controlled due to separate edit sections. This is a one-time process and would not require X release onwards.

Create Set File

To create a set file:

Select any parameter set column, right-click, and select Save Set File. This opens the windows directory.

Store the parameter data in the directory with the file extension *.set.

Load Set File

To load the set file:

Select any parameter set column, right-click, and select Load Set File. This opens the windows directory.

Locate the set file and open the file. Tuning data will be loaded onto the chosen set after selecting the .set file. When you click Undo, the load action is reversed, and the screen displays the previous preset values.

Only matching (CoreId, InstanceId, BlockId, and SublockId) objects tuning data will be loaded.

Following are the notifications you will get during the load:

If there are additional objects in the .set file than the set group, a notification message will be displayed.
If there are additional objects in the set group, then in the .set file a notification message will be displayed.
If there is a mismatch in the size of the AO a notification message will be displayed.
If there are mismatching objects in both the .set file and set group, a notification message will be displayed.

All the mismatched object details will be displayed in the event log.

Tuning data will be loaded only to the set in the parameter set column. Not on to the state variables.

Similarly, you can also load a human-readable set file (.setr file).
Graphical user interface Description automatically generated

Tuning data is loaded onto the chosen set upon selection of the .setr file. When you click Undo, the load action is reversed, and the screen displays the previous preset values.

Only tuning data for objects with matching (CoreId, InstanceId, BlockId, and SublockId) identifiers will be loaded. The following message appears following the loading of the tuning data from Setr.
Graphical user interface, application Description automatically generated

The following notifications are displayed in the cases mentioned below:

If there are additional objects in the .setr file than the set group a notification message will be displayed.
If there are additional objects in the set group, then in .setr file a notification message will be displayed.
If there is a mismatch in the size of the AO a notification message will be displayed.
If there are mismatching objects in both the .setr file and the set group, a notification message will be displayed.

All the mismatched object details will be displayed in the event log.

December 11, 2024

Parameter Set Overview

When you launch a project in GTT, the Device Designer screen appears, which includes the following elements:

Parameter Set Ribbon: The ribbon is composed of six groups, each of which represents a subset of program functionality. In addition to these programs there are also additional contextual programs that automatically appear depending on what is currently selected.
Parameter Sets view: This section displays the list of projects. In addition, you can add and delete a parameter set group.
Venue Explorer: This section displays core objects. Core objects that are part of the Audio Core (virtual core) and operate at a higher level than audio objects.
Tuning Panel: The workspace is used to add audio object/ xAF instance and program the device core.

Parameter Set Ribbon

Set	New: Creates a new preset with default values. For more details, refer Create a Parameter Set . Duplicate: Use the “Duplicate” option to create a copy of the set and set group. To duplicate a set: Select a set column and click Duplicate. A duplicate set column will be added next to existing set. To duplicate a set group: Select a set group and click Duplicate. A duplicate set group will be added in the parameter set view.
Default Values	Use the “Default Values” option to reset all the parameters of the selected set to their default values.
Preset	Retrieve : Retrieve the current set values from the state variables. For more details, refer Retrieve Parameter Sets. Apply Delta : To send only the Preset parameter values which are updated in the selected set (i.e. the values of changed parameters) . The tuning values of the presets are send to the device via XTP messages. For more details, refer Apply Delta in Parameter Sets. Apply : To send the all preset parameters values of the selected set to the device. Verify: To compare the presets loaded on a device with the presets available in the GTT in order to ensure their accuracy. For more details, refer Verify Parameter Sets.
Set File	Save: To set the configured parameter sets. For more details, refer Saving Parameter Sets. Load: To load the tuning data on to the selected set. For more details, refer Load .set file.
Edit	Delete: Deletes the current selection. Undo: Allows you to undo changes (Ctrl+ Z). Redo: Allows you to redo several actions (Ctrl+ Y).
Venue	Sort By Name: Allow user to sort parameter sets explorer data in alphabetic order. It will sort all items by Name. Sort By HiQNetId: Allow user to sort explorer data in HiQNetId order. By default, parameter sets explorer show data in HiQNetId order.
Preset Controller	The Preset Controller is basically a group of parameter sets in a single view, with all of the functionalities such as creating .set files, storing sets, and recalling sets of parameter sets available. A “Slot” is a group of parameters set one level above. You can create multiple such slots and do any actions like create set files, store , recall etc. In addition to GTT functionalities, it is also possible to send Xtp commands to device. There are XTP commands to send slot map and Load the slot on to device. You need to export all .set files and manually flash on to the amp. For more details, refer Preset Controller.
Preset Comparison	Compare Presets: Sequential compare of 2 selected Presets. Next: Navigate to the next mismatch cell value. Previous: Navigate to the previous mismatch cell value. Clear Comparison: Discard and disable all the presets comparison functionality. By default, Presets Comparison ribbon buttons will be disabled. For more details about Presets Comparison, refer to Preset Comparison.

Parameter Sets View

The Parameter Sets section allows you to perform the following actions:

Add a new parameter set group.
Provides options to remove the set group.

Graphical user interface, application Description automatically generated

Venue Explorer

In venue explorer allows you to navigate and explore various parameter set groups and audio objects. Drag and drop the desired objects you wish to have presets configured in onto the workspace.
Graphical user interface Description automatically generated

Tuning Panel

The tuning panel shows the tuning data of the audio objects used in the SFD. You can perform the following actions on the tuning panel.

Modify the tuning data of the audio objects.
Manage or filter the columns and set groups.
Search the audio objects.
Stores the tuning data in set files. These files are in Intel Hex format.

Save the modification or progress of tuning of audio objects.

AO Visualization: To view audio objects added in parameter sets, the “AO Visualization” view can be used.

You can view the compact view of the device, cores, and audio objects by checking “AO Visualization” checkbox in the header. On unchecking this checkbox, the default view of parameter sets will be shown. This compact view is specific to each set group, so you can enable this for one set group and view the default view for another.

Operations such as adding new parameters by drag & drop, deleting parameters, and creating new sets are allowed in the AO Visualization view, but the view will be reset back to default.

AO Visualization view supports the search feature and you can search audio objects by name. The matching cells will be highlighted in yellow color.

Checksum Visualization: Checksum visualization allows you to view more sets data by hiding left side columns.

Parameter Sets Checksum: A checksum is an alphanumeric string that serves as a fingerprint for data. Later this data can be used for comparisons to detect errors in the data. checksum is significant because it helps to validate the data. This feature allows you to view the checksum of each set and export the checksum along with the set files.
You can use this set checksum to verify exported set files to validate whether set files data and parameter sets set data is same or not.

Refresh Checksum: Refresh checksum option get enabled when any changes are made in set data and user data. You can click on refresh icon to calculate latest checksum.

Export Checksum in Set file: GTT allows you to export set checksum in set and setr files.

Checksum will not be saved in .set and .setr files in below cases:
– While saving .set and .setr files in State Variable explorer.
– While exporting .set and .setr files from Export Tuning Data.

December 11, 2024

Working with GTT Project

This section provides step-by-step instructions to perform the following operations.

Use Case

Offline Tuning: Set tuning parameters for audio objects without connecting to the device.

A picture containing text Description automatically generated

Real-Time Tuning of a Target Device: Live tuning connected to the target device.

Graphical user interface Description automatically generated

Real Time Tuning of a IVP/VST: Live tuning connected to the virtual device (IVP/Audio Mulch).

Graphical user interface Description automatically generated with low confidence

Socket: A socket is an interface type, that can send or receive data within a PC (from one application to another) or over a computer network from one PC to another.

In this case, a socket connection is used to send data from GTT to AmpSrv2 and vice versa.

VST: Virtual Studio Technology is a software interface definition for audio plugins into music software by Steinberg company. Usually, these plugins are shipped as Windows Dlls that can be used inside of a VST-Host (e.g. AudioMulch).

In this use case, AudioworX provides the file (xAFVirtualAmp.dll) that simulates the audio behavior of an amplifier or head unit.

December 9, 2024

Other Design

Tick Marker

A tick marker is an unlinked control that can be customized to show user-specified values. It can be used with faders and meters to specify particular measurements with unique positions, orientations, colors, etc.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Property Type	Options
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner.You can also drag the control to a different location. Size: Control size (in pixels).Change width and height values. You can also re-size the control manually. Background Color: The background color of the text areaBrings up the Select Color window.
Ticks	Vertical Justification: Vertical justification of the ticks Display Ticks: Whether to display the tick marks of the control or not True = displayed False = not displayed Major Tick Color: Color of the major ticks. Brings up the Select Color window. Default is black Major Tick Count: How many major ticks are displayed. The major tick count must be the same as or larger than the number of major tick labels in order to display all labels. Major Tick Length: The length (in pixels) of the major ticks Orientation: Displayed Horizontal or Vertical Minor Split: Whether or not to split minor ticks on the centered tick marker. Minor Tick Color: Color of the minor ticks. Brings up the Select Color window. Default is blue Minor Tick Count: How many minor ticks are displayed between major ticks Minor Tick Length: The length (in pixels) of the major tick Tick Thickness: Thickness (in pixels) of the tick marks.
Tick Labels	Display Labels: Whether or not to display labels on the control. Label Font: Click on “…” to select desired font. Choose from Windows fonts Label Color: Color of the control text. Brings up the Select Color window. Default is black Tick Label Offset: Spacing (in pixels) between tick marks and their labels. Major Tick Labels: The labels for the major ticks. The major tick count must be the same as or larger than the number of major tick labels to display all labels.
Margins	High Margin: Spacing (in pixels) between label and top border, limited by size of bounding box. Left Margin: Spacing (in pixels) between label and left border, limited by size of bounding box. Low Margin: Spacing (in pixels) between label and bottom border, limited by size of bounding box. Right Margin: Spacing (in pixels) between label and right border, limited by size of bounding box.

Note

A note adds an icon to a Custom Panel with popup text. A note cannot be linked to a parameter. Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, viewed (but not changed) by the end user.

Property Type	Options
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location. Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Background Color: Background color of the control. Tool Tip Text: Text that appears on control mouse-over.
Note	Note Text: Click to enter desired text for note content. Brings up a Control Text editor. Text Color: Text color of the control. Brings up the Select Color window. Default color is black Popup Background Color: Background color for the popup. Brings up the Select Color window. Popup Width: The width of the popup in pixels Popup Height: The height of the popup in pixels Display Direction: The direction in which the popup will appear when the note is clicked. “Auto” will position the popup depending on where the user clicks. Left Up Down Right Upper left Upper right Lower left Lower right

Panel Link

A panel link is a control on a Custom Panel that links to another Custom Panel. Define the link in the panel link section of the properties tab.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to another Custom Panel to function properly.

Property Type	Options
Appearance	Background Color: The background color of the text area. Brings up the Select Color window. Background Image: Background image of the control. Brings up the Select Color window. Background Image Layout: Background layout of the image. Tile, Centre, Stretch, and Zoom Font: Click on “…” to select desired font. Choose from Windows fonts. Foreground Color: The foreground color for the panel. Brings up the Select Color window.
Design	Panel Name: Enter the name of the panel. Default text is “Panel 1”.
Layout	Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Start Behavior: Behavior of the panel. Manual, CenterScreen, and WindowsDefaultLocation. Start Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location
Window Style	Show Control Box: Whether to display control box or not. Form Border Style: Click to select form border style. FixedSingle Fixed3D FixedDialog FixedToolWindow Sizable SizableToolWindow Hide Cursor: Whether or not to display cursor. Icon: Click on “…” to select desired icon. Show Maximize Box: Whether to display maximize box or not. Show Minimize Box: Whether to display minimize box or not. Show Icon: Whether to display icon or not. Show in Taskbar: Whether to display taskbar or not. Size Grip Style: Click to select size grip style. Auto, Show, and Hide

Panel Preset Bar

The panel preset bar manages panel presets. This control is added to the Custom Panel as an unlinked control because it is not linked to a parameter; it creates values as you change parameter settings.
On an activated Custom Panel, you can store, recall, rename, and delete panel presets. On the Custom Panel designer, you can edit it or change its properties.

A panel preset saves the current values and control parameters on a Custom Panel; when additional parameters are added or values are changed, the panel preset must be saved again to include them.

Store panel preset: On the activated Custom Panel, change parameter settings as desired then click “Store” on panel preset bar.

On Store Panel Preset dialog, type preset name, and click “OK.” The panel preset is added to the preset list.

If one of the values on a panel preset is changed, the button will turn green to alert you that you need to re-save the panel preset to include the changed value. Simply click the ‘Store’ button.

Recall panel preset: Recall panel presets on the activated Custom Panel, either from the title bar or the panel preset bar.
- TITLE BAR: Right click title bar, select “Recall Preset,” then select the desired preset from the list.
- PANEL PRESET BAR: Select “Recall.” Select the panel preset from the list and click “OK.”

The panel preset settings are recalled.

Rename panel preset: On the activated Custom Panel, select “Store” on panel preset bar. Select the item from the list that you wish to rename.

Type the new name next to “Preset Name” and click “OK.”

Delete panel preset: On the activated Custom Panel, select “Delete.” Select the panel preset from the list and click “OK.”

Property Type	Options
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location. Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Background Color: Background color of the control. Text Color: Text color of the control. Font: Click on “…” to select desired font. Selects from Windows fonts. Label Text Color: The color of the Label Text Brings up the Select Color window. Tab Index: Indicates the sequence of an element within the tabbing order of all focusable elements in the document. Tab Stop: Whether the control appears in the tab order. Checked = Appears Unchecked = Won’t appear

December 9, 2024

Images

The second toolset contains image design tools. This toolset includes the following tools.

Image
Straight Line
Curved Line
Rectangle
Ellipse

Image

The Image control is a basic Custom Panel control used for custom images such as a company logo or icon.

Property Type	Options
General	Control Info: Shows control type. Read only Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Image: Brings up the Select Image file window. Image Layout: The image layout used by the control. None, Tile, Center, Stretch, or Zoom Background Color: Background color of the image control. Brings up the Select Color window.

Straight Line

Allows to add a straight line in the custom panel.

Property Type	Options
General	Control Info: Shows control type. Read only Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Fore Color: The color of the line. Brings up the Select Color window.
Line Properties	Anti-alias: When checked, turns on the anti-aliasing filter. Start Point: The location on the panel of the line starting point. End Point: The location on the panel of the line ending point. Thickness: The thickness, in pixels of the line. Line Template: The orientation of the line. Horizontal, Vertical, Diagonal Ascending, and Diagonal Descending
Line Properties	Anti-alias: When checked, turns on the anti-aliasing filter. Start Point: The location on the panel of the line starting point. End Point: The location on the panel of the line ending point. Thickness: The thickness, in pixels of the line. Line Template: The orientation of the line. Horizontal, Vertical, Diagonal Ascending, and Diagonal Descending

Curved Line

Allows to add a curved line in the custom panel.

Property Type	Options
General	Control Info: Shows control type. Read only Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Fore Color: The color of the line. Brings up the Select Color window.
Line Properties	Curve Type: The quadrant that the curved line occupies. Choose from drop down list Anti-alias: When checked, turns on the anti-aliasing filter. Thickness: The thickness, in pixels of the line.

Rectangle

Allows to add a rectangle in the custom panel.

Property Type	Options
General	Control Info: Shows control type. Read only Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Fore Color: The color of the line. Brings up the Select Color window. Gradient Color Start: The starting color of a gradient fill or the color of a solid fill. Brings up the Select Color window. Gradient Color End: The ending color of a gradient fill. Not used for a solid fill. Brings up the Select Color window. Gradient Mode: The direction that a color gradient fill will flow. Horizontal, Vertical, Forward Diagonal or Backward Diagonal Paint Style: The type of background fill. Empty Brush, Solid Brush or Gradient Brush Rounded Corners: When checked the corners of the box will be rounded by the Corner Radius amount. Corner Radius: The radius of the corners.
Line Properties	Anti-alias: When checked, turns on the anti-aliasing filter. Thickness: The thickness, in pixels of the line.

Ellipse

Allows to add ellipse in the custom panel.

Property Type	Options
General	Control Info: Shows control type. Read only Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Fore Color: The color of the line. Brings up the Select Color window. Gradient Color Start: The starting color of a gradient fill or the color of a solid fill. Brings up the Select Color window. Gradient Color End: The ending color of a gradient fill. Not used for a solid fill. Brings up the Select Color window. Gradient Mode: The direction that a color gradient fill will flow. Horizontal, Vertical, Forward Diagonal or Backward Diagonal Paint Style: The type of background fill. Empty Brush, Solid Brush or Gradient Brush
Line Properties	Anti-alias: When checked, turns on the anti-aliasing filter. Thickness: The thickness, in pixels of the line.

December 9, 2024

Meter Design

Meter Fast

A Fast Meter is an output meter that shows the state of a device parameter. Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Meter Gradient

A gradient meter is an output meter that shows the state of a device parameter in specifically designed gradients. Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Meter Segmented

A segmented meter is an output meter that shows the state of a device parameter.Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Meter Segmented Advanced

A segmented advanced meter is an output meter that shows the state of a device parameter.Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Meter Segmented Dial

A segmented dial meter is an output meter that shows the state of a device parameter.Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Common Roter Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer Maximum: Maximum parameter value. The largest parameter value. Minimum: Minimum parameter value. The smallest parameter value. Reset Text: Optional text to display in right click context popup. Value Equation: When specified, this equation combines the attached parameter’s values and returns the value that the control will display. Gain Reduction: Check if this meter is to be a Gain Reduction style. The negative dB gains are reported (shown) as increasing positive gains.
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Border: The margin, in pixels around the outside of the LEDs. Background Image: Brings up the Select Background Image window Background Color: background color used in the gradient behind the meter itself. Brings up the Select Color window. Tool Tip Text: The text that appears on control mouse-over. Tab Index: Determines the position of the control in the tab order Tab Stop: Specifies whether the control appears in the tab order. Checked = Appears Unchecked = Does not appear Anti-Aliasing: When checked, the meter will draw with anti-aliasing. Tool Tip Text: Text that appears on control mouse-over. Optimized for Speed: Enables the meter to draw faster. This decreases the aesthetic properties of the meter.
Meter	Outer Radius: The fractional position of the outermost portion of the segments. Inner Radius: The fractional position of the innermost portion of the segments. Starting Angle: The clockwise angle, in degrees where 0 is straight up Ending Angle: The clockwise angle, in degrees where 0 is straight up. Separation Angle: The angle, in degrees separating each segment Segment Count: The total number of segments in the display. Segment Height: The height of individual LEDs in the meter. Segment Width: The width of individual LEDs in the meter. Segment Spacing: The distance, in pixels between segments. Off Color: The color of the Off segments. Brings up the Select Color window. High Color: The color of the upper section of the meter Brings up the Select Color window. Mid Color: The color of the mid-section of the meter. Brings up the Select Color window. Low Color: The color of the lower section of the meter. Brings up the Select Color window. Peak Color: The color of the peak line. Gradient Fraction: Determines which portion of a meter section is gradient filled. Draw Peak: If checked, the peak line will be displayed. Peak Thickness: The thickness, in pixels of the Peak Line. Peak Decay Rate: Percent of the meter that the Peak Line will drop per second. Border Style: The border style drawn around the meter. Select from drop down list Segment Border Color: The total number of segments in the display. High Threshold: The value at which the upper section ends, and the mid-section begins. Mid Threshold: The value at which the mid-section ends, and the lower section begins. Orientation: The orientation of the meter; Vertical or Horizontal. Select Left to Right, Right to Left, Top to Bottom, or Bottom to Top. Top Border: Distance, in pixels, between the top edge of the control and the top of the meter. Bottom Border: Distance, in pixels, between the bottom edge of the control and the bottom of the meter. Left Border: Distance, in pixels, between the left edge of the control and the left side of the meter. Right Border: Distance, in pixels, between the right edge of the control and the right side of the meter.
Scale	Display Scale: When checked, the scale is enabled. Font: Click on “…” to select desired font. Brings up a Font Select window. Selects from Windows fonts Background Color: The background color of the text area. Brings up the Select Color window. Fore Color: The foreground color for the scale. Brings up the Select Color window. Scale Location: Placement for the scale (the scale must be enabled first). Right or Bottom, Left or Top Custom Ticks: Customized ticks for the control. Parameters must be set first. Scale Count: The number of scale entries to display. Scale Space: Space to allocate for the scale.

December 9, 2024

LED Design

Led Image

An LED is a display-only control that shows the state of a device parameter. The LED control helps the designer to graphically show a certain condition, as defined by the designer, such as a warning. The “LED Image” control allows you to change the entire image of the LED where the “LED Color” control is a simplified control where you only need to change the color of the LED.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter or system function to function properly. You can also easily add a pre-defined label.
For example, the designer wants to show when the pink noise levels on each of the four inputs of a DriveRack 4800 are more than 10dB. First, he adds an LED and links it to the pink noise on Channel 1.

The designer then goes into the Properties field to the Parameters Value and defines the value with the LED Values Editor.

Led Color

An LED is a display-only control that shows the state of a device parameter. The LED control helps the designer to graphically show a certain condition, as defined by the designer, such as a warning.

Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter or system function to function properly. You can also easily add a pre-defined label.
For example, the designer wants to display when pink noise levels on each of the four inputs of a DriveRack 4800 are more than 10dB. First, he adds an LED and links it to the pink noise on Channel 1.
The designer then goes into the Properties field to the Parameters Value and defines the value with the LED Values Editor.

Led Preset Trigger

A preset trigger is a control on a Custom Panel that causes an activation event to execute when a specific condition occurs. The Custom Panel must be activated for the action to be performed. You can, however, set up a venue-wide rule with Logic Rules.

To Set Up a Preset Trigger

Add the preset trigger control to the Custom Panel then do one of the following:

Right click the control and select edit parameter assignment.
or
In the properties section of the graph, select the “…” at the right of parameter addresses.

To Reset a Preset Trigger

If the condition for the activation event is set to manual reset, the user must reset the control. Right-click the control on the activated panel and select “Reset Trigger.”

Led Region

Led System Indicator

The system indicator is an LED-style control that allows you to define and show the state of specified devices. For example, on an activated panel, a system indicator will turn red and beep when a device is offline, then return to green when the connection is restored. A right mouse click on the system indicator on an activated panel also shows what state attached devices are in.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter or system function to function properly. You can also easily add a pre-defined label.

Common LED Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer Image Values: Allows editing of the value range of the control. Brings up the LED Values Editor. Color Values: Allows editing of the value range of the control. Brings up the LED Values Editor. Value Equation: When specified, this equation combines the attached parameter’s values and returns the value that the control will display. Select from a drop-down list.
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location. Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Border Width: The width of the border (in pixels). Background Color: The background color of the text area. Brings up the Select Color window. Transparency: Percent transparent, between 0 (opaque) and 90 (very transparent) Tool Tip Text: Text that appears on control mouse-over. Tab Index: Indicates the sequence of an element within the tabbing order of all focusable elements in the document. Tab Stop: Whether the control appears in the tab order. Checked = Appears Unchecked = Won’t appear Center Text: Centers the tool tip text on the control. Border Color: The color of the Spinner border. Brings up the Select Color window. On Color: The color of the LED in the On state. Brings up the Select Color window. Off Color: The color of the LED in the Off state. Brings up the Select Color window. Show Label: Determines if the label will be drawn with the indicator. Checked = show the label
Trigger	Event: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location.
Indication	Active: Sets the Control Label, label color, background color and background image for the Active state. Brings up the State Indication Setup window. Inactive: Sets the Control Label, label color, background color and background image for the Inactive state. Brings up the State Indication Setup window. Enable: When checked, the trigger is enabled
State Indication	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer Image Values: Allows editing of the value range of the control. Brings up the LED Values Editor. Value Equation: When specified, this equation combines the attached parameter’s values and returns the value that the control will display. Select from a drop-down list.

December 9, 2024

Basic

The first toolset is a group of basic design tools. The tools are grouped into the following toolset.

Text design
Fader design
Rotary design
Button design
Box design
LED design
Meter design
Note design

Text Design

Text Display

A text display is a dynamic text control on a Custom Panel that can be linked to the value of a specific device parameter. It shows the control value as it changes, much like a text box, but cannot be changed by the user.

Use either the Text Label or Note control to add static text to a Custom Panel.

A Text Display control can be managed in the Custom Panel designer and, once the Custom Panel is activated, viewed (but not changed) by the end user.

Unlinked (Static) Text: If a label is not linked to a control, the text does not change on the control but is merely the default text as defined in the text attributes. Once another control is linked, the value is overridden by the parameter value.
Linked (Updating) Text: If a label is linked to a control, on the activated Custom Panel it will reflect the value of the control as it changes, much like a text box. However, the value cannot be changed by the user.

Once a label is linked to a control, you can add a label showing the parameter address of the label.

Text Label

A text label is a static text control on a Custom Panel. It is text only, cannot be linked to a device parameter, and is not interactive for the user.
Text Label controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, viewed (but not changed) by the end user.

Text Box

A text box allows the user to specify the exact value of a device parameter by typing it in rather than running through a long list of values. In tablet mode, a keypad loads when a text box is selected.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Common Text Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Address: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer. Rest Text: Optional text to display in right click context popup
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location. Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Background Image: Background image of the control. Background Color: Background color of the control. Paint Style: Background paint style of the control. Solid Brush: solid background Gradient Brush: gradient fill background Gradient Color Start: Beginning gradient color if gradient is selected in Paint Style. Gradient Color End: Ending gradient color if gradient is selected in Paint Style. Gradient Mode: Type of gradient fill if gradient is selected in Paint Style.Click to select type of gradient. Border Color: Border color of the control. Brings up the Select Color window. Default color is transparent. Border Style: Click to select border style.Default style is flat.
Text Attributes	Text: Enter the text for the Text Display.Default text is “TextDisplay1”. Text Font: Click on “…” to select desired font. Brings up a Font Select window.Selects from Windows fonts. Text Color: Text color of the control.Default color is black. Text Alignment: Alignment of the label text.Default alignment is middle center

Fader Design

Fader Horizontal

A Fader Horizontal is an adjustable horizontally-positioned fader control that manipulates a device parameter.

Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Fader Vertical

A vertical fader is an adjustable vertically-positioned control that manipulates a device parameter.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Fader Multi Parameter

A multiparameter fader manipulates multiple device parameters.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.
On an activated Custom Panel, levels on a multiparameter fader can be adjusted together or individually

Common Fader Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer Maximum: Maximum parameter value. The largest parameter value. Minimum: Minimum parameter value. The smallest parameter value. Reset Text: Optional text to display in right click context popup.
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually Background Image: Brings up the Select Background Image window Background Color: Background color of the control Tool Tip Text: The text that appears on control mouse-over. Tab Index: Determines the position of the control in the tab order Tab Stop: Specifies whether the control appears in the tab order. Checked = Appears Unchecked = Does not appear
Arrow	Maximum Arrows: The maximum number of arrows to display. Arrow Direction: The direction the arrows should point. Point Left or Point Right
Fader Cap	Fader Cap Image: The image displayed for the fader cap. Click Browse to locate custom fader caps Fader Cap Size: How large the fader cap will be Arrow Box Width: The width of the arrow box in pixels Vertical Offset: The vertical offset of the fader cap, in pixels, from the fader channel Horizontal Offset: The horizontal offset of the fader cap, in pixels, from the fader channel Hot Spot: Sets mouse sensitivity to the fader cap or the entire length of the slider Highlight Color: The channel highlight color Arrow Box Separation: The distance between the arrow box and the fader channel in pixels. Label Margin: The amount of space, as a decimal fraction of the width of the control, between the center channel and the tick marks
Channel	Channel Color: Color of the fader channel. Default is Dim Gray Channel Width: Width of the fader channel in pixels Channel Start: Distance, as a percentage of length, from the bottom or left edge to where the fader channel will start. Channel End: Distance, as a percentage of length, from the bottom or left edge to where the fader channel will end. Channel Center: Distance, as a percentage of width, from the bottom or left edge to where the fader channel will be located.
Scale	Display Tick Marks: Option to display the tick marks of the control. Must be set to true for custom ticks to display. Checked = Display Unchecked = Do not display Number of Major Ticks: How many major ticks are displayed. Tick Location: The location of the tick marks relative to the fader channel. Custom Ticks: Whether to use custom tick values by utilizing the scale editor or not. Checked = Display Unchecked = Do not display Display Tick Values: The value of the ticks to be displayed. Value Format: The format of the tick values. Labels Inside: Major Tick Color: The color of the major tick. Major Tick Length: The length of the major tick. Number of Minor Ticks: How many minor ticks are displayed. Minor Tick Color: The color of the minor tick. Minor Tick Length: The length of the minor tick. Tick Location: The location of the tick marks relative to the fader channel. Font: The font for the ticks. Labels Inside: Whether labels are drawn between tick marks and fader channel. Whether labels are drawn between tick marks and fader channel or not. Checked = labels drawn between tick marks and channel. Unchecked = tick marks drawn between labels and channel. Labels Vertical: Whether labels are displayed vertically or horizontally. Checked = labels display vertically Unchecked = labels display horizontally, left to right. Label Margin: The amount of space, as a decimal fraction of the width of the control, between the center channel and the tick marks.
Nudge Button	Nudge Button Location: Location of the nudge buttons. None, Center, Above or Below Nudge Type: Determines, with the increment amount, how much the control will adjust when a nudge button is pressed. Percent – percentage of the total visual display of the control. For non-logarithmic controls, the visual display and the total value of the control will be the same. For logarithmic controls, the visual display will differ from the total value. Bump – small increment Value – specified increment amount. Increment Amount: Determines, with the nudge type, how much the control will adjust when a nudge button is pressed. Nudge Button Separation: Distance, in pixels, from the edge to the nudge button. Up Image: The static image for the “up” nudge button. Click the button to select a new image. Up Pushed Image: The image that displays when the “up” nudge button is pushed. Click the button to select a new image. Down Image: The static image for the “down” nudge button. Click the button to select a new image. Down Pushed Image: The image that displays when the “down” nudge button is pushed. Click the button to select a new image.
Popup Value	Popup Value Position – Fraction: The location of the popup value as a decimal fraction of the width (X) and height (Y) of the control. Display Popup Value: Displays the value of the control in a popup, if set to true Checked = Display Unchecked = Do not display

Rotary Design

Rotary

A rotary is an adjustable control that manipulates a device parameter. Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Rotary Encoder

A rotary encoder is an adjustable rotary control that manipulates a device parameter and displays values of a device parameter.

When a Custom Panel is activated, the rotary control (inner ring) changes the linked parameter values as the end user clicks and slides it around it to the desired value position (like twisting a nob). The rotary encoder is controlled by right-clicking with the mouse and moving to the top or right to increase the value and moving to the bottom or left to decrease the value.

The LED meter (outer ring) reflects the selected parameter values, which are usually the same as those linked to and adjusted by the rotary control.

Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Common Roter Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer Rotary Maximum: Maximum parameter value. The largest parameter value. Rotary Minimum: Minimum parameter value. The smallest parameter value. Meter Maximum: Maximum meter value. The largest meter value Meter Minimum: Minimum meter value. The smallest meter value Reset Text: Optional text to display in right click context popup.
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location. Size: Control size (in pixels). Change width and height values. You can also re-size the control manually.Background Image: Brings up the Select Background Image window. Background Image: Click to select background image. Background Color: Background color of the control. Foreground Color: Foreground color of the control. Font: Font style for the text on the control. Click on “…” to select desired font. Selects from Windows fonts. Mode String: User-definable description of mode. Anti-Aliasing: Whether to draw with anti-aliasing or not. Checked = With anti-aliasing. Unchecked = Without anti-aliasing Tool Tip Text: The text that appears on control mouse-over. Tab Index: If tab stop is set to true, determines the position of the control in the tab order. Tab Stop: Specifies whether the control appears in the tab order. Checked = Appears Unchecked = Does not appear
Knob	Base Image: The image displayed for the inside of the knob Ring Image: The image displayed for the outside of the knob. Shading Image: The image used to simulate lighting/shading effects of the knob. Knob Size: The size of the knob. Set to 0,0 to reset to the actual image size. Start Position: The angular starting point from vertical. End Position: The angular ending point from vertical. Orientation: The movement of the knob from min to max.
Backing Circle	Radius: Radius for the backing circle as fraction of control size. Color: Color of the backing circle. Use “Transparent” to disable. Border Width: Width of the backing circle border. Border Color: Color of the backing circle border.
Rotary	Encoder Multiplier: The amount that the turn of the rotary is multiplied to tune sensitivity. Base Image: The image displayed for the inside of the knob. Brings up the Select Image File window. Ring Image: The image displayed for the outside of the knob. Brings up the Select Image File window. Knob Radius: The radius of the rotary knob as percent of control size. Must be less than meter inner radius but greater than half of the meter inner radius. Nudge Amount: Determines, with the nudge type, how much the control will adjust when up and down arrow keys are pressed. Nudge Type: Determines, with the nudge amount, how much the control will adjust when up and down arrow keys are pressed. Percent: Percentage of the total visual display of the control. For non-logarithmic controls, the visual display and the total value of the control will be the same. For logarithmic controls, the visual display will differ from the total value. Bump: Small increment. Value: Specified nudge amount.
Fader Cap	Fader Cap Image: The image displayed for the fader cap. Click Browse to locate custom fader caps Fader Cap Size: How large the fader cap will be Arrow Box Width: The width of the arrow box in pixels Vertical Offset: The vertical offset of the fader cap, in pixels, from the fader channel Horizontal Offset: The horizontal offset of the fader cap, in pixels, from the fader channel Hot Spot: Sets mouse sensitivity to the fader cap or the entire length of the slider Highlight Color: The channel highlight color Arrow Box Separation: The distance between the arrow box and the fader channel in pixels. Label Margin: The amount of space, as a decimal fraction of the width of the control, between the center channel and the tick marks
Channel	Channel Color: Color of the fader channel. Default is Dim Gray Channel Width: Width of the fader channel in pixels Channel Start: Distance, as a percentage of length, from the bottom or left edge to where the fader channel will start. Channel End: Distance, as a percentage of length, from the bottom or left edge to where the fader channel will end. Channel Center: Distance, as a percentage of width, from the bottom or left edge to where the fader channel will be located.
Scale	Display Tick Marks: Option to display the tick marks of the control. Must be set to true for custom ticks to display. Checked = Display Unchecked = Do not display Number of Major Ticks: How many major ticks are displayed. Tick Location: The location of the tick marks relative to the fader channel. Custom Ticks: Whether to use custom tick values by utilizing the scale editor or not. Checked = Display Unchecked = Do not display Display Tick Values: The value of the ticks to be displayed. Value Format: The format of the tick values. Labels Inside: Major Tick Color: The color of the major tick. Major Tick Length: The length of the major tick. Number of Minor Ticks: How many minor ticks are displayed. Minor Tick Color: The color of the minor tick. Minor Tick Length: The length of the minor tick. Tick Location: The location of the tick marks relative to the fader channel. Font: The font for the ticks. Labels Inside: Whether labels are drawn between tick marks and fader channel. Whether labels are drawn between tick marks and fader channel or not. Checked = labels drawn between tick marks and channel. Unchecked = tick marks drawn between labels and channel. Labels Vertical: Whether labels are displayed vertically or horizontally. Checked = labels display vertically Unchecked = labels display horizontally, left to right. Label Margin: The amount of space, as a decimal fraction of the width of the control, between the center channel and the tick marks.
Nudge Button	Nudge Button Location: Location of the nudge buttons. None, Center, Above or Below Nudge Type: Determines, with the increment amount, how much the control will adjust when a nudge button is pressed. Percent – percentage of the total visual display of the control. For non-logarithmic controls, the visual display and the total value of the control will be the same. For logarithmic controls, the visual display will differ from the total value. Bump – small increment Value – specified increment amount. Increment Amount: Determines, with the nudge type, how much the control will adjust when a nudge button is pressed. Nudge Button Separation: Distance, in pixels, from the edge to the nudge button. Up Image: The static image for the “up” nudge button. Click the button to select a new image. Up Pushed Image: The image that displays when the “up” nudge button is pushed. Click the button to select a new image. Down Image: The static image for the “down” nudge button. Click the button to select a new image. Down Pushed Image: The image that displays when the “down” nudge button is pushed. Click the button to select a new image.
Meter	Encoder Mode: The display mode for the LED elements. Clockwise is the default. Outer Radius: The outside edge of the display meter as a percentage of the entire circle. Must be less than 1 (outer edge of control) and greater than the inner radius. Inner Radius: The inside edge of the display meter as a percentage of the entire circle. Must be less than meter outer radius. Starting Angle: Where the meter display starts. Measured in degrees from where “0” is straight up (-180…180). Ending Angle: Where the meter display ends. Measured in degrees from where “0” is straight up (-180…180). Separation Angle: The angle, in degrees, separating each segment. Segment Count (1..360): The number of segments in the display. Off Color: The “off” color of the control. On Color: The “on” color of the control. Segment Border Color: The color of the segment border.
Popup Value	Popup Value Position – Fraction: The location of the popup value as a decimal fraction of the width (X) and height (Y) of the control. Display Popup Value: Displays the value of the control in a popup, if set to true Checked = Display Unchecked = Do not display

Button design

Button

A standard button sends a single value each time that it is pressed. While a button can be linked to a device parameter, it is more typically linked to a system function.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

On the following example, if “Preset 1” button is pushed, the 1st preset is selected for DriveRack #1. If “Preset 2” button is pushed, the 2nd preset is selected. Each button push overrides the value of the previous button push.

Button On/Off

An on/off button alternately turns on or off a device parameter value when pressed. Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Button Momentary

A momentary button turns on a device parameter value while it is being pressed and turns the value off when released.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Button Latching

A latching button alternately turns on or off a device parameter value when pressed.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Button MultiState

A multi-state button both sets and displays a defined value of a device parameter. While the multi-state button is somewhat complex to set-up, its function can be very powerful. To set up an MS button, first you add (and link) the button, then change its properties. You must also define the button action. You can also change its other properties.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

A multi-state button can be powerful but very complex, save your venue before adding or editing a multi-state button.

Sets Value: Once the multi-state button is linked and defined, the parameter on the Custom Panel changes the parameter(s) on the device control panel(s).
- Multiple Device Parameters – If the multi-state button is linked to more than one device parameter, when the multi-state button on the Custom Panel is pushed, all the attached device parameters will be set to the specified value.
Displays Value: Once the multi-state button is linked and defined, the parameter on the device control changes the parameter on the Custom Panel as defined in the properties section:
- Multiple Device Parameters – If the multi-state button is linked to more than one device parameter, the multi-state button on the Custom Panel will update the device parameters with the new value.
Add Multi-State Button: Add a multi-state button the same way you add other controls and link it to one or more device parameters
- Change button properties – In order for the linked multi-state button to work properly, you must define how the property works. This is accomplished in Properties in the “Value Indication Matrix” window. You must also set the button action.

Button Radio

A radio button allows the user to select the value of a device parameter from a list. Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Button Region

This button sends a single value each time that it is pressed. While a button can be linked to a device parameter, it is more typically linked to a system function.

Button System Functions

A System Functions button sends a single value each time that it is pressed. This button is specifically linked to a system function.
Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Common Button Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer. Press Value: Value sent when button is pressed. On Value: Value sent when button is pressed. Off Value: Value sent when button is released. Value Matrix: Allows changes to the button states, and images associated with each state. Value List: Allows editing of the value range of the control. Brings up the Discrete Values Editor. Color 0 to Color 63: Background color of control. Brings up the Select Color window. Indication same as Button: The value sent when the button is pressed. Reset Text: Optional text to display in right click context popup.
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location. Size: Control size (in pixels). Change width and height values. Change width and height values. You can also re-size the control manually. Font: Font style for the text on the control. Click on “…” to select desired font. Selects from Windows fonts. Center Text: Centers the tool tip text on the control. Background Image: Background graphic of control. Brings up the Select Image File window. Background Color: Background color of the control. Brings up the Select Color window. Tool Tip Text: Text that appears when mouse pointer hovers over control. Tab Index: Indicates the sequence of an element within the tabbing order of all focusable elements in the document. Tab Stop: Whether the control appears in the tab order. Checked = Appears Unchecked = Does not appear Transparency: Percent transparent, between 0 (opaque) and 90 (very transparent). Brings up the Select Image File window. Hover Transparency: Percent transparent when the mouse pointer is over the region. Border Color: The color of the border. Brings up the Select Color window. Border Width: The width of the border (in pixels)
Button	Primary Font: Font style for the text on the control. Click on “…” to select desired font. Selects from Windows fonts. Text: Text appearing on the control. Select and type desired label. Default text is “Button” with the number of the control (order added to the panel) Font: Font style for the text on the control. Click on “…” to select desired font. Selects from Windows fonts. Text Color: Color of the text on the control Fill Color: Changes the Fill Color of the control, will not be visible if you have an image selected. Border Color: The color of the Button border. On Primary Indication: Sets the button label, label color, background color, and background image for the “on” state. Off Primary Indication: Sets the button label, label color, background color, and background image for the “off” state. Brings up the State Indication Setup window. Enable Flashing: Enables button to flash. Flash Frequency: If flashing is enabled, sets the flashing frequency. Flash In Phase: If flashing is enabled, determines if button will flash in or out of phase with other buttons Flash On Indication: Sets the button label, label color, background color, and background image for the “flash on” state. Brings up the State Indication Setup window. Flash Off Indication: Sets the button label, label color, background color, and background image for the “flash off” state. Brings up the State Indication Setup window. Multi-line: When checked, changes the button for multi-line operation. A secondary set of certain properties are added to the button: Secondary Font, Secondary On Indication and Secondary Off Indication. Default state is unchecked. The Secondary Font, On Indication and Off indication options are identical to the Primary Font, On Indication and Off indication options. Bump up: When checked, bumps up the assigned parameter by the Bump % amount. Bump %: Sets the percentage amount for the Bump function. Bump Down: When checked, bumps down the assigned parameter by the Bump % amount. Button Action: When an event occurs when the button is clicked. OnUp, OnDown, or OnBoth. Button Image: The image displayed as the button. Brings up the Select Image File window. Alignment: Alignment of the button nubs. vertical and horizontal. Diameter: Diameter of the radio button nubs Style: The style (color) of the nubs. Select from the pull-down list. Border Style: The style of the control border. Select from the pull-down list Top Margin: Distance of the values, in pixels, from the top border of the control. Bottom Margin: Distance of the values, in pixels, from the bottom border of the control. Left Margin: Distance of the values, in pixels, from the left border of the control. Right Margin: Distance of the values, in pixels, from the right border of the control. On Color: The color of the button in the On state. Brings up the Select Color window. Off Color: The color of the button in the Off state. Brings up the Select Color window. On Text: The text displayed on the button in the On state. Off Text: The text displayed on the button in the Off state. Mixed Text: The text displayed on the button when in a mixed state.
System Indication	On State Logic: Link device state to the On state of the Region Button. Brings up the Indication Configuration editor. On Color: The color of the region when in the On state. Brings up the Select Color window. Partial State Logic: Link device state to the partial state of the region button. Brings up the Indication Configuration editor. Partial Color: The color of the region when in the Partial state. Brings up the Select Color window. Off Color: The color of the region when in the Off state. Brings up the Select Color window.
System Functions	System Functions: Assign specific system operations to be performed when the button is pressed. Brings up the System Function editor.

Box Design

Combo Box

A Combo Box allows the user to select the value of a device parameter from a drop-down list.Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

List Box

A List Box allows the user to select the value of a device parameter from a list. Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Spinner

A Spinner allows the user to change the value of a device parameter by adjusting it up or down; the increment can be specified by the Custom Panel designer. Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Check Box

A Checkbox turns on or off a device parameter value when pressed. Controls can be managed in the Custom Panel designer and, once the Custom Panel is activated, utilized by the end user. This control must be linked to a parameter to function properly.

Common Roter Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer Value List: Allows editing of the value range of the control. Brings up the Discrete Values Editor. Maximum: Maximum parameter value. The largest parameter value. Minimum: Minimum parameter value. The smallest parameter value. Reset Text: Optional text to display in right click context popup. Disable Mixed-sate Editor: When checked, disables the mixed-state context menu and editor
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Border Style: The style of the Spinner border. Choose from drop down menu. Border Color: The color of the Spinner border Brings up the Select Color window. Top Margin: The amount of space, in pixels at the top of the control where a label may be placed. Bottom Margin: The amount of space, in pixels at the bottom of the control where a label may be placed. Left Margin: The amount of space, in pixels to the left of the control where a label may be placed. Right Margin: The amount of space, in pixels to the right of the control where a label may be placed. Background Image: Brings up the Select Background Image window. Background Color: Background color of the control. Tool Tip Text: The text that appears on control mouse-over. Tab Index: Determines the position of the control in the tab order Tab Stop: Specifies whether the control appears in the tab order. Checked = Appears Unchecked = Does not appear
Combo Box	Background Color: The background color of the Combo Box. Brings up the Select Color window Text Color: The color of the Combo Box text Brings up the Select Color window. Font: Font style for the text in the box. Click on “…” to select desired font. Selects from Windows fonts. Style: Sets the appearance and functionality of the Combo Box. Select from Drop Downlist, Simple or Drop-down Selected Item Color: The color of the selected item. Brings up the Select Color window Check Box Text: The text shown in the Checkbox. Checkbox Size: The size of the Checkbox in pixels. Checkbox Style: The Checkbox style. Normal, flat, and various colors. Label Separation: The space, in pixels between the checkbox and the checkbox text.
List Box	Background Color: The background color of the Combo Box Brings up the Select Color window Text Color: The color of the Combo Box text. Brings up the Select Color window Font: Font style for the text in the box. Click on “…” to select desired font. Selects from Windows fonts. Border Style: Sets the style of the List Box border. Choose from syles in a drop down list Selected Item Color: The color of the selected item. Brings up the Select Color window
Text Attributes	Text Font: The font of the Spinner text. Choose from Windows fonts. Text Color: The color of the Spinner text. Brings up the Select Color window Background Color: The background color of the text area. Brings up the Select Color window Value Format: The format used when displaying the value. This is an advanced feature and must follow English conventions. Text Alignment: The horizontal alignment of the text. Left, center or right. Text Border Style: The border style of the text area. Choose from drop down menu.
Nudge Buttons	Nudge Type: Together with the Increment Amount, determines the amount that the control will increment/decrement when a Nudge Button is pressed. Percent, bump or value Increment: Together with the Nudge Type, determines the amount that the control will increment/decrement when a Nudge Button is pressed.
Spinner Attributes	Spinner Position: Specifies where the up/down arrows are to be located. Right or TopBottom Spinner Width: Sets the size of the up/down arrow buttons, in percent of width or height. Spinner Button Color: The color of the up/down arrow buttons. Brings up the Select Color window Spinner Arrow Color: The color of the up/down arrows. Brings up the Select Color window Arrow Width: The width of the base as a percentage of the spinner button width.

LED Design

Led Image

The designer then goes into the Properties field to the Parameters Value and defines the value with the LED Values Editor.

Led Color

An LED is a display-only control that shows the state of a device parameter. The LED control helps the designer to graphically show a certain condition, as defined by the designer, such as a warning.

Led Preset Trigger

To Set Up a Preset Trigger

Add the preset trigger control to the Custom Panel then do one of the following:

Right click the control and select edit parameter assignment.
or
In the properties section of the graph, select the “…” at the right of parameter addresses.

To Reset a Preset Trigger

If the condition for the activation event is set to manual reset, the user must reset the control. Right-click the control on the activated panel and select “Reset Trigger.”

Led Region

Led System Indicator

Common LED Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer Maximum: Maximum parameter value. The largest parameter value. Minimum: Minimum parameter value. The smallest parameter value. Reset Text: Optional text to display in right click context popup.
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually Background Image: Brings up the Select Background Image window Background Color: Background color of the control Tool Tip Text: The text that appears on control mouse-over. Tab Index: Determines the position of the control in the tab order Tab Stop: Specifies whether the control appears in the tab order. Checked = Appears Unchecked = Does not appear
Arrow	Maximum Arrows: The maximum number of arrows to display. Arrow Direction: The direction the arrows should point. Point Left or Point Right
Fader Cap	Fader Cap Image: The image displayed for the fader cap. Click Browse to locate custom fader caps Fader Cap Size: How large the fader cap will be Arrow Box Width: The width of the arrow box in pixels Vertical Offset: The vertical offset of the fader cap, in pixels, from the fader channel Horizontal Offset: The horizontal offset of the fader cap, in pixels, from the fader channel Hot Spot: Sets mouse sensitivity to the fader cap or the entire length of the slider Highlight Color: The channel highlight color Arrow Box Separation: The distance between the arrow box and the fader channel in pixels. Label Margin: The amount of space, as a decimal fraction of the width of the control, between the center channel and the tick marks
Channel	Channel Color: Color of the fader channel. Default is Dim Gray Channel Width: Width of the fader channel in pixels Channel Start: Distance, as a percentage of length, from the bottom or left edge to where the fader channel will start. Channel End: Distance, as a percentage of length, from the bottom or left edge to where the fader channel will end. Channel Center: Distance, as a percentage of width, from the bottom or left edge to where the fader channel will be located.
Scale	Display Tick Marks: Option to display the tick marks of the control. Must be set to true for custom ticks to display. Checked = Display Unchecked = Do not display Number of Major Ticks: How many major ticks are displayed. Tick Location: The location of the tick marks relative to the fader channel. Custom Ticks: Whether to use custom tick values by utilizing the scale editor or not. Checked = Display Unchecked = Do not display Display Tick Values: The value of the ticks to be displayed. Value Format: The format of the tick values. Labels Inside: Major Tick Color: The color of the major tick. Major Tick Length: The length of the major tick. Number of Minor Ticks: How many minor ticks are displayed. Minor Tick Color: The color of the minor tick. Minor Tick Length: The length of the minor tick. Tick Location: The location of the tick marks relative to the fader channel. Font: The font for the ticks. Labels Inside: Whether labels are drawn between tick marks and fader channel. Whether labels are drawn between tick marks and fader channel or not. Checked = labels drawn between tick marks and channel. Unchecked = tick marks drawn between labels and channel. Labels Vertical: Whether labels are displayed vertically or horizontally. Checked = labels display vertically Unchecked = labels display horizontally, left to right. Label Margin: The amount of space, as a decimal fraction of the width of the control, between the center channel and the tick marks.
Nudge Button	Nudge Button Location: Location of the nudge buttons. None, Center, Above or Below Nudge Type: Determines, with the increment amount, how much the control will adjust when a nudge button is pressed. Percent – percentage of the total visual display of the control. For non-logarithmic controls, the visual display and the total value of the control will be the same. For logarithmic controls, the visual display will differ from the total value. Bump – small increment Value – specified increment amount. Increment Amount: Determines, with the nudge type, how much the control will adjust when a nudge button is pressed. Nudge Button Separation: Distance, in pixels, from the edge to the nudge button. Up Image: The static image for the “up” nudge button. Click the button to select a new image. Up Pushed Image: The image that displays when the “up” nudge button is pushed. Click the button to select a new image. Down Image: The static image for the “down” nudge button. Click the button to select a new image. Down Pushed Image: The image that displays when the “down” nudge button is pushed. Click the button to select a new image.
Popup Value	Popup Value Position – Fraction: The location of the popup value as a decimal fraction of the width (X) and height (Y) of the control. Display Popup Value: Displays the value of the control in a popup, if set to true Checked = Display Unchecked = Do not display

Meter Design

Common Roter Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer Maximum: Maximum parameter value. The largest parameter value. Minimum: Minimum parameter value. The smallest parameter value. Reset Text: Optional text to display in right click context popup.
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually Background Image: Brings up the Select Background Image window Background Color: Background color of the control Tool Tip Text: The text that appears on control mouse-over. Tab Index: Determines the position of the control in the tab order Tab Stop: Specifies whether the control appears in the tab order. Checked = Appears Unchecked = Does not appear
Arrow	Maximum Arrows: The maximum number of arrows to display. Arrow Direction: The direction the arrows should point. Point Left or Point Right
Fader Cap	Fader Cap Image: The image displayed for the fader cap. Click Browse to locate custom fader caps Fader Cap Size: How large the fader cap will be Arrow Box Width: The width of the arrow box in pixels Vertical Offset: The vertical offset of the fader cap, in pixels, from the fader channel Horizontal Offset: The horizontal offset of the fader cap, in pixels, from the fader channel Hot Spot: Sets mouse sensitivity to the fader cap or the entire length of the slider Highlight Color: The channel highlight color Arrow Box Separation: The distance between the arrow box and the fader channel in pixels. Label Margin: The amount of space, as a decimal fraction of the width of the control, between the center channel and the tick marks
Channel	Channel Color: Color of the fader channel. Default is Dim Gray Channel Width: Width of the fader channel in pixels Channel Start: Distance, as a percentage of length, from the bottom or left edge to where the fader channel will start. Channel End: Distance, as a percentage of length, from the bottom or left edge to where the fader channel will end. Channel Center: Distance, as a percentage of width, from the bottom or left edge to where the fader channel will be located.
Scale	Display Tick Marks: Option to display the tick marks of the control. Must be set to true for custom ticks to display. Checked = Display Unchecked = Do not display Number of Major Ticks: How many major ticks are displayed. Tick Location: The location of the tick marks relative to the fader channel. Custom Ticks: Whether to use custom tick values by utilizing the scale editor or not. Checked = Display Unchecked = Do not display Display Tick Values: The value of the ticks to be displayed. Value Format: The format of the tick values. Labels Inside: Major Tick Color: The color of the major tick. Major Tick Length: The length of the major tick. Number of Minor Ticks: How many minor ticks are displayed. Minor Tick Color: The color of the minor tick. Minor Tick Length: The length of the minor tick. Tick Location: The location of the tick marks relative to the fader channel. Font: The font for the ticks. Labels Inside: Whether labels are drawn between tick marks and fader channel. Whether labels are drawn between tick marks and fader channel or not. Checked = labels drawn between tick marks and channel. Unchecked = tick marks drawn between labels and channel. Labels Vertical: Whether labels are displayed vertically or horizontally. Checked = labels display vertically Unchecked = labels display horizontally, left to right. Label Margin: The amount of space, as a decimal fraction of the width of the control, between the center channel and the tick marks.
Nudge Button	Nudge Button Location: Location of the nudge buttons. None, Center, Above or Below Nudge Type: Determines, with the increment amount, how much the control will adjust when a nudge button is pressed. Percent – percentage of the total visual display of the control. For non-logarithmic controls, the visual display and the total value of the control will be the same. For logarithmic controls, the visual display will differ from the total value. Bump – small increment Value – specified increment amount. Increment Amount: Determines, with the nudge type, how much the control will adjust when a nudge button is pressed. Nudge Button Separation: Distance, in pixels, from the edge to the nudge button. Up Image: The static image for the “up” nudge button. Click the button to select a new image. Up Pushed Image: The image that displays when the “up” nudge button is pushed. Click the button to select a new image. Down Image: The static image for the “down” nudge button. Click the button to select a new image. Down Pushed Image: The image that displays when the “down” nudge button is pushed. Click the button to select a new image.
Popup Value	Popup Value Position – Fraction: The location of the popup value as a decimal fraction of the width (X) and height (Y) of the control. Display Popup Value: Displays the value of the control in a popup, if set to true Checked = Display Unchecked = Do not display

Note Design

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer Maximum: Maximum parameter value. The largest parameter value. Minimum: Minimum parameter value. The smallest parameter value. Reset Text: Optional text to display in right click context popup.
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually Background Image: Brings up the Select Background Image window Background Color: Background color of the control Tool Tip Text: The text that appears on control mouse-over. Tab Index: Determines the position of the control in the tab order Tab Stop: Specifies whether the control appears in the tab order. Checked = Appears Unchecked = Does not appear
Arrow	Maximum Arrows: The maximum number of arrows to display. Arrow Direction: The direction the arrows should point. Point Left or Point Right
Fader Cap	Fader Cap Image: The image displayed for the fader cap. Click Browse to locate custom fader caps Fader Cap Size: How large the fader cap will be Arrow Box Width: The width of the arrow box in pixels Vertical Offset: The vertical offset of the fader cap, in pixels, from the fader channel Horizontal Offset: The horizontal offset of the fader cap, in pixels, from the fader channel Hot Spot: Sets mouse sensitivity to the fader cap or the entire length of the slider Highlight Color: The channel highlight color Arrow Box Separation: The distance between the arrow box and the fader channel in pixels. Label Margin: The amount of space, as a decimal fraction of the width of the control, between the center channel and the tick marks
Channel	Channel Color: Color of the fader channel. Default is Dim Gray Channel Width: Width of the fader channel in pixels Channel Start: Distance, as a percentage of length, from the bottom or left edge to where the fader channel will start. Channel End: Distance, as a percentage of length, from the bottom or left edge to where the fader channel will end. Channel Center: Distance, as a percentage of width, from the bottom or left edge to where the fader channel will be located.
Scale	Display Tick Marks: Option to display the tick marks of the control. Must be set to true for custom ticks to display. Checked = Display Unchecked = Do not display Number of Major Ticks: How many major ticks are displayed. Tick Location: The location of the tick marks relative to the fader channel. Custom Ticks: Whether to use custom tick values by utilizing the scale editor or not. Checked = Display Unchecked = Do not display Display Tick Values: The value of the ticks to be displayed. Value Format: The format of the tick values. Labels Inside: Major Tick Color: The color of the major tick. Major Tick Length: The length of the major tick. Number of Minor Ticks: How many minor ticks are displayed. Minor Tick Color: The color of the minor tick. Minor Tick Length: The length of the minor tick. Tick Location: The location of the tick marks relative to the fader channel. Font: The font for the ticks. Labels Inside: Whether labels are drawn between tick marks and fader channel. Whether labels are drawn between tick marks and fader channel or not. Checked = labels drawn between tick marks and channel. Unchecked = tick marks drawn between labels and channel. Labels Vertical: Whether labels are displayed vertically or horizontally. Checked = labels display vertically Unchecked = labels display horizontally, left to right. Label Margin: The amount of space, as a decimal fraction of the width of the control, between the center channel and the tick marks.
Nudge Button	Nudge Button Location: Location of the nudge buttons. None, Center, Above or Below Nudge Type: Determines, with the increment amount, how much the control will adjust when a nudge button is pressed. Percent – percentage of the total visual display of the control. For non-logarithmic controls, the visual display and the total value of the control will be the same. For logarithmic controls, the visual display will differ from the total value. Bump – small increment Value – specified increment amount. Increment Amount: Determines, with the nudge type, how much the control will adjust when a nudge button is pressed. Nudge Button Separation: Distance, in pixels, from the edge to the nudge button. Up Image: The static image for the “up” nudge button. Click the button to select a new image. Up Pushed Image: The image that displays when the “up” nudge button is pushed. Click the button to select a new image. Down Image: The static image for the “down” nudge button. Click the button to select a new image. Down Pushed Image: The image that displays when the “down” nudge button is pushed. Click the button to select a new image.
Popup Value	Popup Value Position – Fraction: The location of the popup value as a decimal fraction of the width (X) and height (Y) of the control. Display Popup Value: Displays the value of the control in a popup, if set to true Checked = Display Unchecked = Do not display

December 9, 2024

Box Design

Combo Box

List Box

Spinner

Check Box

Common Roter Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer Value List: Allows editing of the value range of the control. Brings up the Discrete Values Editor. Maximum: Maximum parameter value. The largest parameter value. Minimum: Minimum parameter value. The smallest parameter value. Reset Text: Optional text to display in right click context popup. Disable Mixed-sate Editor: When checked, disables the mixed-state context menu and editor
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location Size: Control size (in pixels). Change width and height values. You can also re-size the control manually. Border Style: The style of the Spinner border. Choose from drop down menu. Border Color: The color of the Spinner border Brings up the Select Color window. Top Margin: The amount of space, in pixels at the top of the control where a label may be placed. Bottom Margin: The amount of space, in pixels at the bottom of the control where a label may be placed. Left Margin: The amount of space, in pixels to the left of the control where a label may be placed. Right Margin: The amount of space, in pixels to the right of the control where a label may be placed. Background Image: Brings up the Select Background Image window. Background Color: Background color of the control. Tool Tip Text: The text that appears on control mouse-over. Tab Index: Determines the position of the control in the tab order Tab Stop: Specifies whether the control appears in the tab order. Checked = Appears Unchecked = Does not appear
Combo Box	Background Color: The background color of the Combo Box. Brings up the Select Color window Text Color: The color of the Combo Box text Brings up the Select Color window. Font: Font style for the text in the box. Click on “…” to select desired font. Selects from Windows fonts. Style: Sets the appearance and functionality of the Combo Box. Select from Drop Downlist, Simple or Drop-down Selected Item Color: The color of the selected item. Brings up the Select Color window Check Box Text: The text shown in the Checkbox. Checkbox Size: The size of the Checkbox in pixels. Checkbox Style: The Checkbox style. Normal, flat, and various colors. Label Separation: The space, in pixels between the checkbox and the checkbox text.
List Box	Background Color: The background color of the Combo Box Brings up the Select Color window Text Color: The color of the Combo Box text. Brings up the Select Color window Font: Font style for the text in the box. Click on “…” to select desired font. Selects from Windows fonts. Border Style: Sets the style of the List Box border. Choose from syles in a drop down list Selected Item Color: The color of the selected item. Brings up the Select Color window
Text Attributes	Text Font: The font of the Spinner text. Choose from Windows fonts. Text Color: The color of the Spinner text. Brings up the Select Color window Background Color: The background color of the text area. Brings up the Select Color window Value Format: The format used when displaying the value. This is an advanced feature and must follow English conventions. Text Alignment: The horizontal alignment of the text. Left, center or right. Text Border Style: The border style of the text area. Choose from drop down menu.
Nudge Buttons	Nudge Type: Together with the Increment Amount, determines the amount that the control will increment/decrement when a Nudge Button is pressed. Percent, bump or value Increment: Together with the Nudge Type, determines the amount that the control will increment/decrement when a Nudge Button is pressed.
Spinner Attributes	Spinner Position: Specifies where the up/down arrows are to be located. Right or TopBottom Spinner Width: Sets the size of the up/down arrow buttons, in percent of width or height. Spinner Button Color: The color of the up/down arrow buttons. Brings up the Select Color window Spinner Arrow Color: The color of the up/down arrows. Brings up the Select Color window Arrow Width: The width of the base as a percentage of the spinner button width.

December 9, 2024

Button Design

Button

Button On/Off

Button Momentary

Button Latching

Button MultiState

A multi-state button can be powerful but very complex, save your venue before adding or editing a multi-state button.

Sets Value: Once the multi-state button is linked and defined, the parameter on the Custom Panel changes the parameter(s) on the device control panel(s).
- Multiple Device Parameters – If the multi-state button is linked to more than one device parameter, when the multi-state button on the Custom Panel is pushed, all the attached device parameters will be set to the specified value.
Displays Value: Once the multi-state button is linked and defined, the parameter on the device control changes the parameter on the Custom Panel as defined in the properties section:
- Multiple Device Parameters – If the multi-state button is linked to more than one device parameter, the multi-state button on the Custom Panel will update the device parameters with the new value.
Add Multi-State Button: Add a multi-state button the same way you add other controls and link it to one or more device parameters
- Change button properties – In order for the linked multi-state button to work properly, you must define how the property works. This is accomplished in Properties in the “Value Indication Matrix” window. You must also set the button action.

Button Radio

Button Region

This button sends a single value each time that it is pressed. While a button can be linked to a device parameter, it is more typically linked to a system function.

Button System Functions

Common Button Design Properties

Properties Type	Description
General	Control Info: Shows control type. This propery is Read only. Locked: Specifies if the control is locked out so that it cannot be moved or re-sized. Checked = Locked Unchecked = Unlocked
Parameters	Addresses: Enables panel designer to edit addressing information with the added benefit that the values can be validated as a group before being applied to the device. This editor also allows the user to assign multiple parameters to the control. Click to select Parameter Address Editor. Properties correspond to the system explorer. Information: Shows information about the Parameter Address. Read only. Properties correspond to the system explorer. Press Value: Value sent when button is pressed. On Value: Value sent when button is pressed. Off Value: Value sent when button is released. Value Matrix: Allows changes to the button states, and images associated with each state. Value List: Allows editing of the value range of the control. Brings up the Discrete Values Editor. Color 0 to Color 63: Background color of control. Brings up the Select Color window. Indication same as Button: The value sent when the button is pressed. Reset Text: Optional text to display in right click context popup.
Appearance	Location: Control location (in pixels) of the control on the Custom Panel. Change X (horizontal) and Y (vertical) values in relation to upper left corner. You can also drag the control to a different location. Size: Control size (in pixels). Change width and height values. Change width and height values. You can also re-size the control manually. Font: Font style for the text on the control. Click on “…” to select desired font. Selects from Windows fonts. Center Text: Centers the tool tip text on the control. Background Image: Background graphic of control. Brings up the Select Image File window. Background Color: Background color of the control. Brings up the Select Color window. Tool Tip Text: Text that appears when mouse pointer hovers over control. Tab Index: Indicates the sequence of an element within the tabbing order of all focusable elements in the document. Tab Stop: Whether the control appears in the tab order. Checked = Appears Unchecked = Does not appear Transparency: Percent transparent, between 0 (opaque) and 90 (very transparent). Brings up the Select Image File window. Hover Transparency: Percent transparent when the mouse pointer is over the region. Border Color: The color of the border. Brings up the Select Color window. Border Width: The width of the border (in pixels)
Button	Primary Font: Font style for the text on the control. Click on “…” to select desired font. Selects from Windows fonts. Text: Text appearing on the control. Select and type desired label. Default text is “Button” with the number of the control (order added to the panel) Font: Font style for the text on the control. Click on “…” to select desired font. Selects from Windows fonts. Text Color: Color of the text on the control Fill Color: Changes the Fill Color of the control, will not be visible if you have an image selected. Border Color: The color of the Button border. On Primary Indication: Sets the button label, label color, background color, and background image for the “on” state. Off Primary Indication: Sets the button label, label color, background color, and background image for the “off” state. Brings up the State Indication Setup window. Enable Flashing: Enables button to flash. Flash Frequency: If flashing is enabled, sets the flashing frequency. Flash In Phase: If flashing is enabled, determines if button will flash in or out of phase with other buttons Flash On Indication: Sets the button label, label color, background color, and background image for the “flash on” state. Brings up the State Indication Setup window. Flash Off Indication: Sets the button label, label color, background color, and background image for the “flash off” state. Brings up the State Indication Setup window. Multi-line: When checked, changes the button for multi-line operation. A secondary set of certain properties are added to the button: Secondary Font, Secondary On Indication and Secondary Off Indication. Default state is unchecked. The Secondary Font, On Indication and Off indication options are identical to the Primary Font, On Indication and Off indication options. Bump up: When checked, bumps up the assigned parameter by the Bump % amount. Bump %: Sets the percentage amount for the Bump function. Bump Down: When checked, bumps down the assigned parameter by the Bump % amount. Button Action: When an event occurs when the button is clicked. OnUp, OnDown, or OnBoth. Button Image: The image displayed as the button. Brings up the Select Image File window. Alignment: Alignment of the button nubs. vertical and horizontal. Diameter: Diameter of the radio button nubs Style: The style (color) of the nubs. Select from the pull-down list. Border Style: The style of the control border. Select from the pull-down list Top Margin: Distance of the values, in pixels, from the top border of the control. Bottom Margin: Distance of the values, in pixels, from the bottom border of the control. Left Margin: Distance of the values, in pixels, from the left border of the control. Right Margin: Distance of the values, in pixels, from the right border of the control. On Color: The color of the button in the On state. Brings up the Select Color window. Off Color: The color of the button in the Off state. Brings up the Select Color window. On Text: The text displayed on the button in the On state. Off Text: The text displayed on the button in the Off state. Mixed Text: The text displayed on the button when in a mixed state.
System Indication	On State Logic: Link device state to the On state of the Region Button. Brings up the Indication Configuration editor. On Color: The color of the region when in the On state. Brings up the Select Color window. Partial State Logic: Link device state to the partial state of the region button. Brings up the Indication Configuration editor. Partial Color: The color of the region when in the Partial state. Brings up the Select Color window. Off Color: The color of the region when in the Off state. Brings up the Select Color window.
System Functions	System Functions: Assign specific system operations to be performed when the button is pressed. Brings up the System Function editor.