Example

====== Masters - Size Master Functions ======

^ by: | Alex del Bondio |
^ published: | April 2019 |
^ description: | Macros for size masters. |
^ remarks: | This is based on the [[macros:identifier:titanid|fixed Titan IDs]] which we found exactly for these macros. |

{{tag>size master}}
==== functions ====
  * [[macros:function:Masters.SetMaster]]
  * [[macros:function:Masters.DeadBlackOut]]
  * [[macros:function:Masters.ClearFlash]]
  * [[macros:function:Masters.NudgeUp]]
  * [[macros:function:Masters.NudgeDown]]

**The Titan IDs have slightly changed from v10 to v11 see [[macros:identifier:titanid]], and while the mentioned reserved IDs are a good starting point, there is no guarantee they haven't changed in your show. If these macros do not work for you then try to find the Titan IDs of your masters and adjust the macros accordingly.**

===== Code =====
These are examples for Size Master 1. For other Size Masters (including Size Grand Master) please refer to the Titan IDs mentioned above
<code xml sizemaster.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros>

  <macro id="Macros.SizeMaster1.Full" name="Set Sizemaster 1 to full">
    <sequence>
      <step>Masters.SetMaster(1614, 1)</step>
    </sequence>
  </macro>
  
  <macro id="Macros.SizeMaster1.50" name="Set Sizemaster 1 to 50%">
    <sequence>
      <step>Masters.SetMaster(1614, 0.5)</step>
    </sequence>
  </macro>
  
  <macro id="Macros.SizeMaster1.Freeze" name="Set Sizemaster 1 to 0 (temp.)">
    <sequence>
      <step>Masters.DeadBlackOut(1614)</step>
    </sequence>
  </macro>
  
  <macro id="Macros.SizeMaster1.Unfreeze" name="Set Sizemaster 1 to previous value">
    <sequence>
      <step>Masters.ClearFlash(1614)</step>
    </sequence>
  </macro>
  
  <macro id="Macros.SizeMaster1.NudgeUp" name="Increase Sizemaster 1 by 10%">
    <sequence>
      <step>Masters.NudgeUp(1614)</step>
    </sequence>
  </macro> 
    
  <macro id="Macros.SizeMaster1.NudgeDown" name="Decrease Sizemaster 1 by 10%">
    <sequence>
      <step>Masters.NudgeDown(1614)</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]]



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

  - [[macros:deploying|make this macro available]]
  - apply when needed (you'll see the results when you have the relevant master assigned)


~~DISCUSSION~~