Example

====== Playback - Set all playback cues' fade-in time ======

^ by: | Sebastian Beutel |
^ published: | April 2020 |
^ description: | Set the fade-in time of all cues of a cuelist|
^ remarks: |  |

This is also an example how ''time:x'' is parsed into a time value.

Developed from [[macros:example:setplaybackcuefadeintime|]]

{{tag> cue cuelist fade-in time multiple selection }}

==== functions ====
  * [[:macros:function:ActionScript.SetProperty]]
  * [[:macros:function:Playbacks.Editor.CueSelection.SelectAll]]

==== affected properties ====
  * [[:macros:property:Playbacks.Editor.SelectedPlayback]]
  * [[:macros:property:Playbacks.Editor.Times.CueFadeInTime]]


===== Code =====
<code xml SetAllCuesFadeInTime.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros>
  <macro id="Wiki.Macros.AllCuesFadeintime3" name="Cue Fade-In Time 3s">
    <sequence>
      <step>ActionScript.SetProperty("Playbacks.Editor.SelectedPlayback", handle:"Location=Playbacks,1,1")</step>
      <step>Playbacks.Editor.CueSelection.SelectAll(handle:"Location=Playbacks,1,1")</step>
      <step>ActionScript.SetProperty("Playbacks.Editor.Times.CueFadeInTime", time:3.0)</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]]

  * ''ActionScript.SetProperty("Playbacks.Editor.SelectedPlayback", handle:"Location=Playbacks,1,1")'' selects a particular playback based on its [[macros:identifier:location]]
  * ''Playbacks.Editor.CueSelection.SelectAll(handle:"Location=Playbacks,1,1")'' selects all cues of this playback and brings them into the editor
  * ''ActionScript.SetProperty("Playbacks.Editor.Times.CueFadeInTime", time:2.5)'' finally sets the fade-in time to the value. ''time:3.0'' tells the parser what to do with the number 3, i.e. parse it as time value.


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

  * [[:macros:deploying|make this macro available]]
  * while it's well possible to create some macros to set some playbacks to a given fade-in time, it does make more sense to integrate this into a bigger context like [[macros:example:createworkspaces|]] in order to setup a known show environment.

~~DISCUSSION~~