Using Controls
Controls are found on the control panel for each component. Controls are considered to be anything, other than text labels, that you find on a control panel; this includes graphs, meters, knobs, and so on. To display the control panel, add the component to the Schematic, then double-click the component; the control panel displays.
Controls behave differently depending on the mode of Q-SYS Designer.
- Run mode - all controls are active. Adjustable controls can be changed and will have an effect on the audio. Graphs, meters, and so on are active and display current information. Some graphs have "handles" you can move using your mouse, their movement is connected to a control on the same control panel.
- Emulate mode - all adjustable controls are active, control logic can be tested, but there is no audio passing therefore, no effect on audio. Graphs, meters are not active.
- Design mode - none of the controls are active, you cannot adjust them, if any information displayed on a control, it is from an earlier Emulate, or Run mode.
You can view a list of all controls for a selected component in your design. For named components, you can then use these control names for external control and control scripting. (For information on renaming components, see Labeling Schematic Elements.)
- In your schematic, select a component.
- From the main menu, select Tools > View Component Controls Info.
A list of all controls for the component is shown in a window. Note that you can copy one or more control names from this window.
There are a number of ways controls can be adjusted, including, External Control, Control Scripting, and manually. This topic address the manual method.
Basic
- Knobs and faders - click-and-hold the left mouse button on the control. Move the mouse up, down, left or right. The control adjusts with your mouse movement.
- Buttons - click the button. The button changes state according to the type of button, toggle, momentary, trigger, and so on.
- Drop-down lists - click the drop-down list, scroll or move the mouse to the entry you want, then click that entry.
- Meters - A read-only control that displays the level, gain, or reduction of a signal.
- Text box - A read-only control displaying a value or condition.
- Text Edit box - A text entry field. Enter the required text and click away from the box.
Keyboard Entry
Entering the value for a control offers a more precise way of adjusting the control. For numeric controls, the precision depends on the unit of measure, or value range, you may or may not be able to use decimals. To use the keyboard to adjust a control:
- Click the control, or hover the mouse cursor over the control.
- Enter the value. The value can be a number, item from the drop-down list, state of a button (mute, unmuted)
- Press the Enter key, or click away from the control. The value is changed.
Notes:
- Keyboard entry is limited by the range of the control. If you enter a value larger than the range, the control is set to the maximum value allowed, if the value entered is smaller than the lowest range value, the control is set to the lowest value.
- Precision of the display value (below a control) is typically limited by the number of characters allowed in that display area - usually a maximum of three digits (numeric) excluding the decimal point, minus (-) character, and the unit of measure (ms, dB, and so on). For example, you can enter 3.95, or 955m, and so on.
- Keyboard entries are rounded up at 5 in the display. For example, if you enter 0.000005 (seconds) or 0.0005m the control display is set to .001 ms.
Shortcuts
Time values, when entered via the keyboard, may be entered in milliseconds (ms) by typing an "m" after the value, or seconds by simply entering the value. If the number entered is greater than the range of the control in seconds, the entry is treated as milliseconds.
- For 2.00 ms, enter 2m or 0.002
- For 0.001 ms, enter .001m or 0.000001
Frequency values, when entered via the keyboard, may be entered in hertz by simply entering the value, or kilohertz by entering the value or 1/1000 of the value followed by the letter "k"
- For 120 Hz, enter 120
- For 17 kHz, enter either 17000 or 17k.
Adjust multiple controls of the same type at the same time. Select all the controls, enter a value or move the control.
You can use special commands, as detailed under the Push Action property, to set the value of numeric controls.
You can drag controls from a control panel into the Schematic, a User Control Interface (UCI), make them available for external control systems (see Named Controls), or place them in a Snapshot. The control , with the exception of a control in a Snapshot, is now a proxy for the actual control in the control panel. You can use it to make adjustments with out opening the control panel.
Control Properties
When you drag a control into the Schematic the following properties are available:
Presentation |
Function |
Value |
---|---|---|
Button |
A button for which you can set a push action. |
Push Action Reverse Action |
Combo Box |
Provides a drop-down list of the available parameters. |
None |
Fader |
Provides an adjustable fader-type control. Can be vertical or horizontal. |
Fader Style Show Text Box Reverse Action |
Knob |
Provides an adjustable knob-type control. |
Reverse Action |
LED |
Provides an LED. No adjustments available. |
LED Style Reverse Action |
List Box |
Provides a list of the available parameters. Scroll bars are available for long lists. |
None |
Media Display |
Available for all text controls, converts a JSON-formatted URL string into media that displays in the text box. See Media Display. |
Display media |
Meter |
Provides a meter. Can be horizontal or vertical. |
Show Text Box Meter Style Reverse Action |
Text Field |
Provides a text box for text type readouts. |
Text Field Style Word Wrap |
Property |
Function |
Value |
---|---|---|
Allows you to change the presentation style of the control. You can change the presentation style in the Properties of the control, or you can copy the style from another control in the Schematic. To copy the style from one control to another:
Regardless of the style you select, the control reacts in the appropriate manner based on the control you select or the control from which it was copied. Not all selectable Styles may be appropriate for the original control. |
Button Combo Box Fader Knob LED List Box Meter Text Field |
|
Position |
The coordinates reference a specific place in the Schematic. For example,100,100 (horizontal, vertical). 0,0 is upper left corner of the schematic. |
Min. 0,0 Max. >10,000,000 |
Size |
The numeric size of the control. For example 70,32 (width, height). |
Min. 6,6 Max. 2000, 2000 |
Fill |
Sets the Fill color of the button. The Fill color is the color of the button in its ON state. |
User-selected color. |
Weight (Font) |
Changes the weight of the Label. For the Text Field, this controls the text displayed or entered in the field in the Run or Emulate mode; it is not a Label. |
Bold Light Normal |
Horizontal Alignment (Font) |
Changes the alignment of the Label on a horizontal basis. For the Text Field, this controls the text displayed or entered in the field in the Run or Emulate mode; it is not a Label. |
Center Left Right |
Vertical Alignment (Font) |
Changes the alignment of the Label on a vertical basis. For the Text Field, this controls the text displayed or entered in the field in the Run or Emulate mode; it is not a Label. |
Bottom Center Top |
Property |
Function |
Value |
Available With |
---|---|---|---|
Sets the style of a Button. The following values are available: Momentary: When the button is clicked, it stays in its opposite state until released. Off: Sets the value of the button to "off" (or 0, or false). Clicking the button again does not turn it on. You can change the button to "on" (or 1, or true) by clicking the button in its Control Panel, or another copy of the button with any button Push Action except "Off". On: Sets the value of the button to "on" (or 1, or true). Clicking the button again does not turn it off. You can change the button to "off" (or 0, or false) by clicking the button in its Control Panel, or another copy of the button with any button Push Action except "On". String: When the button is clicked, it sends the string you entered to the control in the Control Panel. See Button String property. Toggle: Allows you to turn the button on or off. |
Momentary Off On String Toggle |
Button Polygon shape
Does not apply to trigger style buttons. |
|
Button String |
Available when Push Action is set to 'String'. The string you enter is case sensitive and must be valid for the control in the Control Panel. For example a fader control has a range of -100 to 20, the string must be numeric and within that range, a toggle button must be true/false, On / Off, or 1/0. Special string commands
In addition, the following special commands may be used in the String field:
|
String |
Push Action: String |
Changes the direction of the control. For example, a gain control normally increases gain as the control moves clockwise; apply the Reverse Action, and the gain now increases by moving the control in a counterclockwise direction. This is useful, for example, if you want a gain control to appear to be increasing attenuation. Another example is if you want to change a mute button (on state is muted, off is passing audio) to an enable button (on state is passing audio, off state is muted). |
No / Yes |
Button Fader Knob LED Meter |
|
Off Color |
Sets the color of the button in its OFF state. When the link to the right of the Off Color patch is linked, the Off Color is linked to the Fill, or ON color, and changes when you change the Fill color. If you click the link, you can manually set the Off Color. |
Linked to the Fill color, or user-selected color. |
Button LED |
Corner Radius |
Sets the radius of the button corners. You can also adjust a control's corner radius using the corner radius handle. |
0 to 300 |
Button |
Margin |
Sets the size of the margin. The button stays the same size, but the visible part of the button is reduced equally around the button. |
0 to 64 |
Button |
Padding |
Controls the margin within the visible part of the button. If there is text and/or an icon, they are reduced in size to fit within the padded margins. |
0 to 64 |
Button |
Icon |
Select an icon from the list, or select Custom to select your own icon image (.png, .jpg, .jpeg, .gif, or .svg). |
User Selected |
Button LED |
Icon Color |
Sets the color of the selected icon. |
User Selected |
|
Icon Alignment |
Determines the horizontal position of the icon when there is a text label on the button. |
Left Right |
Button |
Button Style |
Flat - The selected button is displayed without styling. Gloss - The selected button is displayed with a shiny appearance. Image - Select a custom image (.png, .jpg, .jpeg, .gif, or .svg) for the button. You can set separate images for On, Off, Pressed On, and Pressed Off states. Note: For information about using .svg files in a UCI, see Proper exporting of .svg files for a UCI. |
Flat Gloss Image |
Button |
Background Color |
Sets the background color of a Meter control |
User Selected |
Meter |
Background |
Meter Background - Used primarily when you change a Meter type control into a Text Field. The value read by the Meter is displayed, in text, in the center of the graphical Meter, instead of in a Text field below the Meter. No Background - No background or outline; displays the text on the object or Schematic background. The Fill color controls the color of the text. Normal - Standard Text field. The background is controlled by the Fill color, the text is automatically set to a color contrasting with the Fill color. |
Meter Background No Background Normal |
Text Field |
Size (Font) |
Changes the font size (in pixels) of the control's Label. This is the text you can type when the control is selected. For the Text Field, this controls the text displayed or entered in the field in the Run or Emulate mode; it is not a Label. |
10 |
Button Fader Text Field |
LED Style |
Changes the style of the LED. |
Normal TriColor |
LED |
Fader Style |
Set the style for the fader. With Custom, you can further adjust these properties:
|
Classic Custom None Round Square Tick |
Fader |
Show Text Box |
Displays the text read out of the control setting. |
Yes / No |
Fader Meter |
Meter Style |
Sets the style of the Meter. All of the meter styles are RMS meters, the difference is the way they are displayed, and the legends used. The text box associated with the meter styles always reads RMS with the exception of the Meter component in Peak mode.
|
Gain Level Reduction Standard |
Meter |
Meter Legend Style |
Select a style of the legend, or scale, for a meter. Note: For the Digital dBFS meter style, dBFS in Q-SYS is referenced to zero being the point at which the output of the D/A Converter will clip. Because of floating point capabilities, Q-SYS can read dBFS values above zero. The indication above zero dBFS lets you know that you need to bring the signal down before sending it to the D/A Converter. |
Analog dBu BBC PPM Custom Digital dBFS Digital dB-Linear Digital Gain Digital LKFS Digital Reduction SPL 0-100dB | 10-110dB | 20-120dB | 30-130dB | 40-140dB |
Meter Legend |
Refer to Aligning Schematic Elements for details.
Each control you place in the Schematic has a "behind-the-scenes" Control ID that ties it to the specific component it came from. The Control ID allows you to use a copy of the control in the Schematic, in Snapshots, UCIs, and External Control systems. The Control ID cannot be changed, but it can be copied from one control to another.
In addition, you can copy the Style of one control to another.
- Select the control you want to copy from.
- Hold the Ctrl button and drag the control over the control you want to copy to. (You can also drag the control first, then press the Ctrl button.)
- Release the mouse button, a selection list displays.
- Do one of the following
- Select "Remap Control". The "copy to" control now has the same Control ID as the "copy from" control, regardless of the control's style.
- Select "Transfer Control Style". The "copy to" control now has the same Style as the "copy from" control.
Tip: If you need to remap many UCI controls between components or within the same component, use the Remap UCI Controls [BETA] tool.
Polygon Control
You can make a shape using the Polygon tool then transfer the settings from a control to the polygon shape. The procedure is the same as above, with the exception that it copies both the Control ID and the Control Style in one operation.
- The polygon shape is always a button type control.
- You can copy or duplicate a polygon shape along with the assigned control's properties, then assign a different button style if you want to.
- You can not copy properties from a polygon shape control to another control, including another polygon shape.
You can copy all of a component's control settings to the same type of component. For example, if you have configured a Delay Matrix Mixer, you can copy all of its control settings to a second Delay Matrix Mixer. With your design in Run or Emulate mode:
- In your schematic, select the component from which you want to copy all of the component's control settings.
- From the main menu, select Tools > Component Controls > Copy Component Controls.
- In your schematic, select another component of the same type as the first component.
- From the main menu, select Tools > Component Controls > Paste Component Controls.
You can give names or Labels to Button and Fader style controls by selecting the control and simply typing the name.
You can drag bitmap type pictures onto a button control. Select the file in Windows Explorer or copy from a graphics editor onto the button. Resizing the button resizes the picture proportionally. The button must be in the Schematic, not in a component's control panel.