Differences

This shows you the differences between two versions of the page.

--- macros:example:stopwatchflash [2020/03/22 10:40] – created icke_siegen
+++ macros:example:stopwatchflash [2020/04/23 11:10] (current) – [functions] icke_siegen
@@ Line 16: / Line 16: @@
   * [[:macros:function:Timecode.TimecodeOne.Pause]]
+==== specials ====
+  * [[:macros:xml_file_format#lines_5_through_8|start/end notation]]
 ===== Code =====
 <code xml stopwatchflash.xml>
 <?xml version="1.0" encoding="utf-8"?>
-<!-- flash playback 1 while being held and use timecode 1 as stopwatch -->
+<!-- flash playback 900 while being held and use timecode 1 as stopwatch -->
 <avolites.macros>
@@ Line 30: / Line 33: @@
     </start>
     <end>
-      <step>Playbacks.ClearFlashPlayback("playbackHandleUN=900")</step>
+      <step>Playbacks.ClearFlashPlayback("cueHandleUN=900")</step>
       <step>Timecode.TimecodeOne.Pause()</step>
     </end>
@@ Line 42: / Line 45: @@
 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]]
-tbd
+This macro sports separate actions when being clicked/pressed and when being released.
+When the macro button/key is pressed the <start> sequence is performed:
+  * ''Playbacks.FlashPlayback("cueHandleUN=900")'' flashes a particular playback
+  * ''Timecode.TimecodeOne.Play()'' makes a particular timecode run
+When the macro button/key is released the <end> sequence is performed:
+  * ''Playbacks.ClearFlashPlayback("cueHandleUN=900")'' un-flashes the playback which was previously flashed
+  * ''Timecode.TimecodeOne.Pause()'' pauses the timecode
 ===== How to use it =====
-  - [[:macros:deploying|make this macro available]]
+  * [[:macros:deploying|make this macro available]]. **This macro needs to be __moved__** to a handle, e.g. to a hardware button (executor). **Copying the macro does not work.**
+  * record a playback with the action you want to stopwatch, e.g. with your CO2 jet @ 100%. **Give this playback the user number 900.**
+  * you can even unassign this playback, or move it to a page which is safe from being hit by accident
+Now, while this macro is activated, the timecode runs and the playback is being flashed.
+Further hints:
+  * this can only be some measure for you. Please don't use this for any items which are safety-relevant
+  * the internal timecode can easily be reset. Please make sure this particular timecode is only used for this stopwatch thing (you might change ''Timecode.TimecodeOne'' for e.g. ''Timecode.TimecodeFour''in order to use another timecode). Also make sure the timecode you use is set to be internal as play/pause will not work on all timecode sources or will have unexpected results.
-tbd
 ~~DISCUSSION~~