Example

====== Cuelist - Record Cuelist and insert a cue (Snippet) ======

^ by: | Sebastian Beutel, February 2019 |
^ published: | here |
^ description: | Snippet to record a cuelist and insert the cue |
^ remarks: | of course fixtures need to be selected, values set etc. - this is only the record cuelist part |

{{tag>record cuelist insert cue}}

==== functions ====
  * [[:macros:function:Playbacks.CueList.CreateCueList]]
  * [[:macros:function:Playbacks.Select.EditHandle]]
  * [[:macros:function:Playbacks.AppendOrInsertPlaybackStep]]
  * [[:macros:function:Playbacks.PlaybackEdit.Exit]]


==== affected properties ====
  * [[:macros:property:Playbacks.PlaybackEdit.Handle]]

 
===== Code =====
<code xml>

<!-- select fixtures, set values etc. ... -->

<step>Playbacks.CueList.CreateCueList("Playbacks", 0)</step>
<step>Playbacks.Select.EditHandle("Location=Playbacks,1,0")</step>
<step>Playbacks.AppendOrInsertPlaybackStep(Playbacks.PlaybackEdit.Handle,1)</step>
<step>Playbacks.PlaybackEdit.Exit()</step>

</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]]

  * ''Playbacks.CueList.CreateCueList(..)'' creates the cuelist at a specific location
  * ''Playbacks.Select.EditHandle(..)'' selects the just created cuelist to be edited - know that this sets the property Playbacks.PlaybackEdit.Handle which is required in the next step
  * ''Playbacks.AppendOrInsertPlaybackStep()'' appends/insert (the current programmer contents) as step into the cuelist
  * ''Playbacks.PlaybackEdit.Exit()'' exits the RecordCuelist state

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

This is a snippet and cannot be used on its own. However, you may use this in your macros where needed


~~DISCUSSION~~