Custom Panel Properties View

The Property View displays the properties of each of the components that are used to design the panel and also allows you to customize the panel. The Properties view is displayed on the right side of the screen.

Graphical user interface, application Description automatically generated

The custom panel workspace has the following

properties

  1. Appearance: Allows you to edit the background color and, background image, image layout, font style, and foreground color.
    Graphical user interface, application Description automatically generated

      • Background Color: Opens the Select Color editor, and sets the background color of the Panel.
      • Background Image: Opens a separate window where an image file is located and selected. Note: it is highly recommended that the background image fit the panel size for the best look. See Layout > Size for these dimensions.
      • Background Image Layout: Sets the layout of the Background Image – whether it be None, Tile, Center, Stretch, or Zoom.
      • Font: Select the text font used by the form.
      • Foreground Color: The foreground color of the component, which is used to display text.
  2. Design: Allows you to rename the panel.
    Graphical user interface, text, application, chat or text message Description automatically generated

      • Panel Name: Sets the name of the panel.
  3. Layout: Allows you to edit the panel layout size, behavior, and location.
    Graphical user interface, application Description automatically generated

      • Size: Sets the pixel size of the panel.
      • Start Behavior: Determines the location of the form when it is launched. Selections are Windows Default Location, Center Screen, or Manual.
      • Start Location: The point on the screen, in pixels, that the form will appear when the Start Behavior is set to Manual.
  4. Window Style: Allows you to edit the panel styling properties.
    Graphical user interface, application Description automatically generated

      • Show Control Box: Determines whether or not the Minimize, Maximize, and Close buttons will be shown.
      • Form Border Style: Determines the Border Style for this Custom Panel. Selections are Sizable, None, Fixed Single, Fixed 3D, Fixed Dialog, Fixed Tool Window, and Sizable Tool Window.
      • Hide Cursor: When selected will hide the mouse cursor when it is over the panel. This may be useful when using touchscreen monitors to display Custom Panels.
      • Icon: Select the icon for the form. This icon is displayed in the form’s system menu box and when the form is minimized. When clicked, a widow opens for you to locate and select the icon file (*.ico).
      • Show Maximize Box: Determines whether or not this Custom Panel can be maximized.
      • Show Minimize Box: Determines whether or not this Custom Panel can be minimized.
      • Show Icon: Sets whether or not to show an icon for this Custom Panel.
      • Show in Taskbar: Determines whether or not to show this Custom Panel in the taskbar when active.
      • Size Grip Style: Sets the size grip style for this Custom Panel – selections are Auto, Show or Hide.
  5. Parameters : Allows to configure control with specific audio object state variable. This is helpful in tuning the audio object.
    Different user control has different set to properties which can be configured.
    Below are the examples of different user control.

    Rotary Encoder user control

    On/Off Button user control

    Horizontal Fader user control

Below are some common properties and values which can be set.

    • Address: This establishes a link between a UI control (like a button or slider) and a state variable, allowing the control to modify the variable’s value.
    • Minimum: This UI control allows setting a minimum value for the state variable. The minimum value should be within the state variable predefined minimum range.
    • Maximum: This UI control allows setting a maximum value for the state variable. The maximum value should be within the state variable predefined maximum range.
    • Reset Text: This is to control right-click context menu option (Rest Param) for resetting state variable to its predefined default value. The Rest Param option in the context menu is associated with default value setting in State Variable.

Below example shows default SV value is 1kHZ. Clicking on “Reset Param” option would reset the SV variable to its default value.

You can override the default value and add custom message to the Reset Text. The Text box UI control associated with EQ.
Open the Parameters properties and enter the required test in the “Reset Text” field.
In the below example, for the Frequency state variable the “Reset Text” is set to text “Set to default value”.

The update text for “Reset Param” would appear as per below image.

IMPORTANT
You can disable the “Reset Param” option on the right-click context menu.  Open the Parameters properties and set the “Reset Text” field to .

This will disable the “Reset Param” option from the context menu without impacting  the other options.

Designer Workspace

In the Designer workspace, you can create a custom panel using various tools available on the Tool panel. Below is an example of the custom panel.

Panel Designer Ribbon

The Panel Designer ribbon contains a tool for designing and editing the custom panel.

The Panel Designer ribbon comprises the following group.

Controls

The Control group comprises of designer tools that allow you to design the custom panel. This includes Basic, Image, Advanced, Group, and Ungroup.

Clipboard

The Clipboard group is a set of copy and paste menus. This includes Duplicate, Cut, Copy, Paste, Copy Visual, and Paste Visual.

Duplicate

  • Duplicate: Duplicates the selected control.
  • Duplicate Special: Brings up the following window.
    Graphical user interface, application Description automatically generated

Cut / Copy / Paste

Acts as standard Windows function in that you may Cut/ Copy/ Paste the selected control.

Copy Visual / Paste Visual

This brings up the Select Control Properties window.

Graphical user interface Description automatically generated

The visual properties of a single control are copied and pasted with the appropriate menu entry in the right-click context menu for a selection of controls, and with the appropriate button in the Clipboard control group within the Custom Panel Designer pop-up Ribbon.

Editing

The Editing group is a set of edit menus. This includes Delete, Select All, Undo, and Redo.

    • Delete: You may delete a selected device or multiple selections of devices from the Venue using the Delete button or with the Delete keyboard key.
    • Select All: Use this to select all devices within the current view, or with the standard CTRL-A Windows keyboard shortcut.
    • Undo / Redo: Use these buttons to Undo or Redo all operations or with the standard CTRL-Z (Undo), and CTRY-Y (Redo) Windows keyboard shortcuts.

Panels

  • Launch Current: This option allows you to open the current active Custom Panel.
  • Duplicate: This option allows you to create a copy of the current active Custom Panel.
  • Create Link: This option allows you to create a link on a custom panel.

Layout

The Layout group is a set of tools that allow you to arrange your design items just the way you want them. This includes Align tools, Size tools, Spacing tools, and Order tools.

Align

A drop-down menu to align the current selection(s) within the panel.

Size

Drop-down menu with options for sizing the current selection(s) as Size to Grid, Make the Same Width, Make the Same Height, or make all selected controls the Same Size.

Spacing

Drop-down menu with options for spacing the controls within the Panel.

Order

Bring-to-Front or Send-to-Back options for selected controls.

Parameters

The tools in the Parameter group allow you to Edit, Remove, and Search the parameters.

    • New Link:
    • Add To Link:
    • Edit: Click to select Parameter Address Editor.
    • Remove: Removes the selected parameters.
    • Search: Brings up the Advanced Parameter Search window.
      Graphical user interface Description automatically generated
    • Readdress:

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
  • 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.
  • Text Color: The color of the Combo Box text
  • 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.
  • 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.

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.

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.

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 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
System Functions
  • System Functions: Assign specific system operations to be performed when the button is pressed.
    Brings up the System Function editor.

Discrete Values Editor

The discrete values editor lists the possible values of some controls such as the Radio Button.

Graphical user interface Description automatically generated

  • Value Items: Displays a list of possible values of the parameter.
  • Add: Adds additional values.
  • Remove: Removes selected value.
  • Value: Value of the item in the list.
  • Label: Enter the label for the value of the item in the list; the default value is the same as the value (to edit, uncheck “Label mirrors Value”)
  • Label mirrors Value: Checked – the Value text will be the same as the Label text. Unchecked – the Label text may be different than the Value text.
  • Validate Authenticates values.

Select Color Window

Graphical user interface Description automatically generated

This window allows you to select the color of the current function such as line colors, background colors etc.

Select the desired color then click the OK button to set the color.

State Indication Setup Window

The State Indication Setup window allows you to customize the look of a control such as a button.

Graphical user interface, application Description automatically generated

  • Label: Enter the name of the label for the current state.
  • Label Color: The color of the label. Select the color from the Select Color window.
  • Backing Color: The color of the label background (such as the color of a button). Select the color from the Select Color window.
  • Backing Image: An image for the label. Select the image from the Select Image File window.

System Function Editor

The System Function Editor is a separate window that allows you to assign a certain System Function or functions upon an action such as pressing a button or receiving an external control signal.

Graphical user interface, application, Teams Description automatically generated

Function: Here you can select which function is to be assigned. Depending on which function you choose, other options below this will open offering supporting parameters or functions.

Below is the list of the functions that can be assigned.
Graphical user interface, text, application, chat or text message Description automatically generated

  • None
  • Close Current Panel: Closes the current Panel
  • Close Custom Panel: Closes a selected Custom Panel
  • Close Device Panel: Closes a selected Device Panel
  • Close Master Panel: Closes a selected Master Panel
  • Launch Custom Panel: Launches a selected Custom Panel
  • Launch Device Panel: Launches a selected Device Panel
  • Launch Master Panel: Launches a selected Master Panel
  • Locate: Select a device in the venue and determine whether you want it’s Locate feature on or off
  • Mute Device: Mutes a selected Device
  • Unmute Device: Unmutes a selected Device
  • Mute Channel: Select a device in the venue and select a channel within that device to mute
  • Unmute Channel: Select a device in the venue and select a channel within that device to unmute
  • Solo Channel: Select a device in the venue and select a channel within that device to solo
  • Recall Device Preset: Select a device in the venue and recall a preset within that device
  • Recall Panel Preset: Select a custom Panel and recall a preset within that panel
  • Recall Venue Preset: Brings up the Venue Presets window.
  • Save File: Saves the current project file.
  • Logout: Logout the current user from GTT.
  • Switch User: Brings up a window to login a different GTT user.
  • Close Application: Shuts down GTT.
  • Shutdown Computer: Shuts down the computer GTT is running on.
  • Play Sound File: Brings up a window to select a sound file. Selections include MP3, MIDI, Windows Audio or Windows Media files
  • Launch Scheduler: Activates the Scheduler
  • Launch Event Log: Activates the Event Log