Example

====== Playback - Set playback cue's fade-in time ======

^ by: | Sebastian Beutel |
^ published: | August 2018 |
^ description: | Set a playback cue's fade-in time |
^ remarks: |  |

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

See also http://forum.avolites.com/viewtopic.php?f=20&t=5790.

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

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

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


===== Code =====
<code xml SetCueFadeInTime.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros>
  <macro id="Wiki.Macros.CueFadeintime3" name="Cue Fade-In Time 3s">
    <sequence>
      <step>ActionScript.SetProperty("Playbacks.Editor.SelectedPlayback", handle:"Location=Playbacks,1,1")</step>
      <step>Playbacks.Editor.CueSelection.SelectCueByNumber(handle:"Location=Playbacks,1,1", 3)</step>
      <step>ActionScript.SetProperty("Playbacks.Editor.Times.CueFadeInTime", time:2.5)</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.SelectCueByNumber(handle:"Location=Playbacks,1,1", 3)'' selects a particular cue of a playback and brings it into the editor
  * ''ActionScript.SetProperty("Playbacks.Editor.Times.CueFadeInTime", time:2.5)'' finally sets the fade-in time to the value. ''time:2.5'' 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~~