Q_SYS_muteSliders

Module Function

This module allows you to create pairs of volume sliders and mute toggles which work in tandem, influencing each other and providing a visual indication of the mute state.

Module operation

The logic is contained within the init.lua file, which should become accessible in your UCI script after installing this module (step 3 in 'Setup Instructions' below). You will need to add a fader and toggle manually, then declare both in the UCI script (steps 6 and 7 in the 'Setup Instructions' below). Changing Control element styles requires the appropriate stylesheet to be installed in the Q-Sys design file. I have supplied a sample stylesheet, but for more elaborate visual changes, this will need to be modified, or added to an existing stylesheet within your design. The CSS classes are dynamically reassigned, and you can adjust them in the init.lua file.

Setup Instructions

1. Move Style Folder

   • Move the style_muteSliders folder to QSC/Q-Sys Designer/Styles.

2. Move Module Directory

   • Move the parent directory (Q-SYS_muteSliders) to QSC/Q-Sys Designer/Modules.

3. Install in Q-SYS Designer

   • In Q-SYS Designer, install both the style (style_muteSliders) and the module (Q-SYS_muteSliders) by going to Tools -> Show Design Resources... -> Available and clicking the Install Module buttons.

   For help, see Q-Sys 'External Lua Modules' guide and/or the Q-Sys UCI Styles Guide

4. Apply the Style

   • Make sure to apply the style in your UCI's properties panel.

5. Add Controls in UCI

   • In your UCI, add Knob and Toggle controls, naming them appropriately. They will be tied together, so it's recommended to use names which indicate that pairing. Controls' styles are assigned automatically in the Module script.

6. Initialise the Module in UCI Script

   • Insert the following Lua code in the UCI Script:

     mutesliders = require('Q-SYS_muteSliders')

7. Use .addSlider() Function

   • Call the .addSlider() function, passing it first the name of the Knob control, then the Toggle. For example, insert this Lua code:

     mutesliders.addSlider(Controls.fader_1, Controls.toggle_1)

   • Repeat this for each pair of sliders and toggles in your design.

Additional Information

For more detailed instructions or troubleshooting, please refer to the official documentation.