Example

====== Playback - Fire and Flash playbacks together ======

^ by: | Sebastian Beutel, April 2020 |
^ published: | here |
^ description: | Fires one playback, flashes another one, unflashes the flashed one when the macro is let go |
^ remarks: | Intention: temporarily flash some fixtures, at the same time set the background for more fixtures, and when this macro is being released the flashed fixtures return to the new background. See https://www.youtube.com/watch?v=cQ4EX1cy3f0 |

{{tag>combine playbacks fire flash release}}

==== functions ====
  * [[:macros:function:Playbacks.FirePlaybackAtLevel]]
  * [[:macros:function:Playbacks.FlashPlayback]]

==== control structures ====
  * [[:macros:xml_file_format#lines_5_through_8|start/end notation]]
 
===== Code =====
<code xml combinePlaybacks.xml>
<?xml version="1.0" encoding="utf-8"?>

<!-- 
	flashes (and unflashes) one playback and fires another at the same time 	
	See https://www.youtube.com/watch?v=cQ4EX1cy3f0
-->

<avolites.macros>
  <macro id="wiki.Macros.combined.1" name="fire 900, flash 901">
    <description>Fires PB 900, Flashes PB 901</description>
    <start>
      <step>Playbacks.FirePlaybackAtLevel(userNumber:900, level:1, true)</step>
      <step>Playbacks.FlashPlayback("cueHandleUN=901")</step>
    </start>
    <end>
      <step>Playbacks.ClearFlashPlayback("cueHandleUN=901")</step>
    </end>
  </macro>
  
  <macro id="wiki.Macros.combined.2" name="fire 900, flash 902">
    <description>Fires PB 900, Flashes PB 902</description>
    <start>
      <step>Playbacks.FirePlaybackAtLevel(userNumber:900, level:1, true)</step>
      <step>Playbacks.FlashPlayback("cueHandleUN=902")</step>
    </start>
    <end>
      <step>Playbacks.ClearFlashPlayback("cueHandleUN=902")</step>
    </end>
  </macro>
  
  <macro id="wiki.Macros.combined.3" name="fire 900, flash 903">
    <description>Fires PB 900, Flashes PB 903</description>
    <start>
      <step>Playbacks.FirePlaybackAtLevel(userNumber:900, level:1, true)</step>
      <step>Playbacks.FlashPlayback("cueHandleUN=903")</step>
    </start>
    <end>
      <step>Playbacks.ClearFlashPlayback("cueHandleUN=903")</step>
    </end>
  </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]]

Each of these macros, when fired, fires playback with usernumber 900 at 100% using ''Playbacks.FirePlaybackAtLevel(...)''. Additionally, one of the playbacks 901, 902 or 903 are flashed -- and are unflashed when the macro button is being let go.

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

  - [[:macros:deploying|make this macro available]] - in this example move the macros to one of the executor buttons\\ **You need to ''MOVE'' the macros as ''COPY'' would strip the start and end tags and would render the macros useless.**
  - create a base look, e.g. with all your fixtures in blue
  - create some flash-strobe bump playbacks, for some fixture groups. Each sets one group to white and strobe. Set these playbacks to flash (via key profiles), release mask to include I and C, user numbers 901, 902 or 903
  - create a target look which you want your fixtures to assume as soon as any bump is fired, e.g. red. Store this as playback, give it the user number 900.
  - To use it: fire the base look. Then fire the bump macros - any number, any order. Various fixture groups will flash white and then release to the new red background look.

~~DISCUSSION~~