Example

====== Masters - BPM - Tap ======

^ by: | Sebastian Beutel |
^ published: | January 2019 |
^ description: | taps BPM masters, to be used in triggers |

{{tag>tap bpm master speed trigger}}

These macros seem to be very redundant but are useful to create triggers for tapping a BPM master: currently (Titan 11.1/11.2) masters cannot be triggered, but coded macros can. Trigger the macro which taps the BPM master -- done 8-)

**The Titan IDs used in this example have changed in Titan v11 (and were different in v10), see [[macros:identifier:titanid|]]**

==== functions ====
  * [[:macros:function:Masters.TapTempo]]
  * [[:macros:function:Math.GetCurrentTimeStamp]]

===== Code =====
<code xml tap_bpmmasters.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros>

<!-- January 2019, Sebastian Beutel -->
<!-- useful to trigger the tap for BPM Masters -->
<!-- January 2020 changed to v13/14/15 TitanIDs -->
<!-- June 2024 corrected v16 TitanIDs, added Masters 5~8 -->

  <macro id="Avolites.Macros.TapBPM1" name="Tap BPM 1">
    <sequence>
      <step>Masters.TapTempo(1612, Math.GetCurrentTimeStamp())</step>
    </sequence>
  </macro>

  <macro id="Avolites.Macros.TapBPM2" name="Tap BPM 2">
    <sequence>
      <step>Masters.TapTempo(1613, Math.GetCurrentTimeStamp())</step>
    </sequence>
  </macro>

  <macro id="Avolites.Macros.TapBPM3" name="Tap BPM 3">
    <sequence>
      <step>Masters.TapTempo(1614, Math.GetCurrentTimeStamp())</step>
    </sequence>
  </macro>
  
  <macro id="Avolites.Macros.TapBPM4" name="Tap BPM 4">
    <sequence>
      <step>Masters.TapTempo(1615, Math.GetCurrentTimeStamp())</step>
    </sequence>
  </macro>
  
  <macro id="Avolites.Macros.TapBPM5" name="Tap BPM 5">
    <sequence>
      <step>Masters.TapTempo(1616, Math.GetCurrentTimeStamp())</step>
    </sequence>
  </macro>

  <macro id="Avolites.Macros.TapBPM6" name="Tap BPM 6">
    <sequence>
      <step>Masters.TapTempo(1617, Math.GetCurrentTimeStamp())</step>
    </sequence>
  </macro>

  <macro id="Avolites.Macros.TapBPM7" name="Tap BPM 7">
    <sequence>
      <step>Masters.TapTempo(1618, Math.GetCurrentTimeStamp())</step>
    </sequence>
  </macro>
  
  <macro id="Avolites.Macros.TapBPM8" name="Tap BPM 8">
    <sequence>
      <step>Masters.TapTempo(1619, Math.GetCurrentTimeStamp())</step>
    </sequence>
  </macro>
  
  <macro id="Avolites.Macros.TapAllBPM" name="Tap All BPM Masters">
    <sequence>
      <step>Masters.TapTempo(1612, Math.GetCurrentTimeStamp())</step>
      <step>Masters.TapTempo(1613, Math.GetCurrentTimeStamp())</step>
      <step>Masters.TapTempo(1614, Math.GetCurrentTimeStamp())</step>
      <step>Masters.TapTempo(1615, Math.GetCurrentTimeStamp())</step>
      <step>Masters.TapTempo(1616, Math.GetCurrentTimeStamp())</step>
      <step>Masters.TapTempo(1617, Math.GetCurrentTimeStamp())</step>
      <step>Masters.TapTempo(1618, Math.GetCurrentTimeStamp())</step>
      <step>Masters.TapTempo(1619, Math.GetCurrentTimeStamp())</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]]

The four macros are distinct only by their name, id, and the [[macros:identifier:titanid|titanId]] of the respective BPM master.

Each macros simply taps its designated BPM master. However, while neither masters nor recorded macros can be triggered (MIDI, sACN etc.), coded macros can. This way you can trigger a master remotely.


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

  * [[:macros:deploying|make this macro available]]
  * create a BPM master and assign it as speed source where needed
  * copy/move the macro you need into any workspace window
  * create a trigger for this macro (only hardware triggers are available)
  * fire the trigger in order to tap the master

~~DISCUSSION~~