Author: Debanka

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.

The custom panel workspace has the following properties:

• Appearance: Allows you to edit the background color and, background image, image layout, font style, and foreground color.
  
  • 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.
• Design: Allows you to rename the panel.
  
  • Panel Name: Sets the name of the panel.
• Layout: Allows you to edit the panel layout size, behavior, and location.
  
  • 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.
• Window Style: Allows you to edit the panel styling properties.
  
  
  • 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.
• 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.

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.

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.

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

The Panel Designer ribbon comprises the following groups.

• Controls
• Clipboard
• Editing
• Panels
• Layout
• Parameters

Groups	Descriptions
Controls	The Control group comprises of designer tools that allow you to design the custom panel. This includes Basic, Image, Advanced, Group, and Ungroup. Basic Design Components. Text Design Fader Design Rotary Design Button Design Box Design LED Design Meter Design Other Design Image Design Components Advanced Design Components Group and Ungroup Group: The group tool helps you to group the multiple items in the designer panel workspace. Grouping helps you to organize design components and keeps your workspace panel uncluttered. Ungroup: The ungroup tool helps you to ungroup the group items in the designer panel workspace.
Clipboard	The Clipboard group is a set of copy and paste menus. This includes Duplicate, Cut, Copy, Paste, Copy Visual, and Paste Visual. Duplicate: Duplicates the selected control. Duplicate Special: Brings up the following window. 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. 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. Readdress:

In the Properties view there are various type of editor available, which allows you to customize the Panel. All the following editour windows are mapped with respective properties.

• Parameter Address Editor
• Multi-Parameter Address Editor
• System Function Editor
• State Indication Setup Window
• Select Color Window
• Discrete Values Editor
• Indication Configuration Editor
• LED Values Editor
• Graph Parameters Window
• Scale Editor

The Scale Editor provides a way to customize ticks on a fader or rotary control.

• Type: Select between Real Values (default), Arbitrary or .
• Real Values: Shows the actual values on the control. The Values may be edited.
  

• Arbitrary: This shows the values of the table in two columns. The left column lists the actual values and the right column lists their corresponding labels.
  
• : Default settings or the display settings from the device panel.
• Ticks: List of the ticks shown on the control.
  • Add: Adds a new tick.
  • Remove: Removes the selected tick.
  • Default: Resets the ticks back to the default setting.
• Manipulate Values: Edits the selected tick.
• Value: Changes the actual value of the control.
• Label: Sets what the tick will display as the control in the panel.
• Generate New Values: Automatically Generate Ticks using the following properties.
• Anchor: Reference point where the automatically generated ticks will cross.
• Step: Sets the initial spacing between the anchor and the next tick.
• Linear: Sets the spacing between each automatically created tick to the Step value.
• Logarithmic: Spaces the automatically created ticks logarithmically with respect to the anchor.
• Integers: Automatically changes the labels to integers starting with the lowest tick value at 0.

• Channel Setup: Brings up the Channel Setup window.
• Reset Graph: Resets the graph back to its default state.
• Parameter Setup
  • Current Channel: Select the current channel to edit.
  • Current Curve: Select the process for the channel that was selected above.
  • Addresses: Brings up the Parameter Address Editor window.

Channel Setup Window

• Number of Channels: Click the up/down arrows to select the number of channels.
• PEQ per channel: Click the up/down arrows to select the number of parametric equalizers per channel
• Xover/Bandpass per channel: Click the up/down arrows to select the number of crossover / bandpass filters per channel.
• DeEsser per channel: Click the up/down arrows to select the number of DeEsser filters per channel.
• FIR per channel: When available, Click the up/down arrows to select the number of FIR filters per channel.
• Bandpass in Selector: When checked, displays the Bandpass in the graph.
• Color Scheme: Choose the color scheme for the graph. Select from Channel Number, Band Number or Curve Index

The LED Values Editor allows you to define the display for specified values for an LED or LED Image.

• Value Items: Displays a list of possible values of the parameter.
• Minimum: Sets the minimum allowable value.
• Maximum: Sets the maximum allowable value.
• Image: Brings up the Image Select window.
• Color: Select a color for the LED.
• Add: Add new Value Items.
• Remove: Remove selected Value Item.
• Validate: Authenticates the values.

The Indication Configuration form allows you to make specifications for a system indicator or region control on a Custom Panel.

1. Select Devices for State Logic: The devices that will be included in this configuration.
2. Conditions: The condition of the device that will facilitate the activation or deactivation events.
   
3. Select Logic Threshold: What will cause the logic action to occur:
   

   	– if the condition occurs on all devices.
   	– if the condition occurs on at least one device.
   	– if the condition occurs on a specified percentage of devices.

   The logic represented by the Conditions combined with the Threshold corresponds to AND/OR/Mixed logic.

4. Activation Event: The action that takes place each time the specified device state occurs including launch preset and/or play audio file.
5. Preset: The panel preset, device preset, or venue preset to be launched each time the device state occurs.
   
6. Play Audio: The audio file that will play each time the specified device state occurs. It will continue to play to the end of the file unless the deactivation event includes stop audio.Browse and select the name of the file to play. Windows sounds are located in the “Windowsmedia” directory.
7. Deactivation Event: The action that takes place when the event stops occurring, including launch preset and/or stop playing the audio file.
8. Preset: The panel preset, device preset, or venue recall to be launched when the device state stops occurring.
   
9. Stop Audio: Shuts down the audio file when the device state stops occurring.
10. Display Text rather than LED (System Indicator Only): Instead of an LED , a text button can display alternating states. Check the box to the left and enter the text to show the ON and OFF states.
    

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

• 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.

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.