Example

====== Masters - Group Masters ======

^ by:           | Alex del Bondio                                                         |
^ published:    | October 2017                                                            |
^ description:  | Groupmaster control for Groups in the Fixtures and Playbacks workspace  |

Useful for groups which you don't change that often, which you dont give a real fader and rather use some buttons for just up/down.

{{tag>group master groupmaster preset level}}

==== functions ====
  * [[:macros:function:Group.SetGroupFaderLevel]]

==== affected properties ====
  * [[:macros:property:Global.PageSwitchAccuracy]]

There is a file available which has these macros already prepared for groups on preset buttons 1~10: {{ :macros:example:adb_groupmaster.xml |}}. 
 
===== Code =====
<code xml groupmaster.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros>

<!--> Examples for handle 1 in the Fixtures and Playbacks workspace <-->
  <macro id="user.macros.GroupMaster1FF" name="Group Master 1 @FF">
    <sequence>
      <step>Group.SetGroupFaderLevel("Presets", 0, level:1, Global.PageSwitchAccuracy)</step>
    </sequence>
  </macro>
  
  <macro id="user.macros.GroupMaster1-50" name="Group Master 1 @50%">
    <sequence>
      <step>Group.SetGroupFaderLevel("Presets", 0, level:0.5, Global.PageSwitchAccuracy)</step>
    </sequence>
  </macro>
  
  <macro id="user.macros.GroupMaster1zero" name="Group Master 1 @0">
    <sequence>
      <step>Group.SetGroupFaderLevel("Presets", 0, level:0, Global.PageSwitchAccuracy)</step>
    </sequence>
  </macro>
  
  <macro id="user.macros.GroupMaster1plus" name="Group Master 1 +10%">
    <sequence>
      <step>Group.SetGroupFaderLevel("Presets", 0, levelDelta:0.1, Global.PageSwitchAccuracy)</step>
    </sequence>
  </macro>
  
  <macro id="user.macros.GroupMaster1minus" name="Group Master 1 -10%">
    <sequence>
      <step>Group.SetGroupFaderLevel("Presets", 0, levelDelta:-0.1, Global.PageSwitchAccuracy)</step>
    </sequence>
  </macro>

</avolites.macros>
</code>


===== Explanation =====

This explains the functional steps within the sequence. For all the other XML details please refer to [[:macros:formats_and_syntax#xml_format|Formats and syntax]]

''Group.SetGroupFaderLevel'' does exactly that: sets a group master to a designated - absolute or relative - level. For more details see [[:macros:function:Group.SetGroupFaderLevel]].

===== How to use it =====

  - [[:macros:deploying|make this macro available]]
  - create some groups, and copy them to buttons 1~10 in the Fixtures and Playbacks window (this is another window than the Fixtures window! You get it via [Open Workspace Window] [Fixtures and Playbacks]).
  - now, with the macros mapped to buttons, you can control the 'virtual group faders'

~~DISCUSSION~~