User Tools

Site Tools


macros:example:setplaybackreleasetime

Example

Playback - Set release time

by: Sebastian Beutel
published: August 2018
description: Set a playback's release time
remarks:

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

functions

affected properties

control structures

Code

SetPBReleaseTime.xml
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros>
  <macro id="Wiki.Macros.Releasetime0" name="PB Release Time 0s">
    <sequence>
      <step>Handles.ClearSelection()</step>
      <step>ActionScript.SetProperty("Playbacks.Editor.SelectedPlayback", null)</step>
 
      <step>Handles.SetSourceHandle("PlaybackWindow", 0)</step>
      <step condition="Playbacks.IsCueHandle(Handles.SourceHandle)">
        ActionScript.SetProperty("Playbacks.Editor.SelectedPlayback", Handles.SourceHandle)</step>
      <step>ActionScript.SetProperty("Playbacks.Editor.Times.PlaybackReleaseTime", time:0)</step>
 
      <step>Handles.SetSourceHandle("PlaybackWindow", 1)</step>
      <step condition="Playbacks.IsCueHandle(Handles.SourceHandle)">
        ActionScript.SetProperty("Playbacks.Editor.SelectedPlayback", Handles.SourceHandle)</step>
      <step>ActionScript.SetProperty("Playbacks.Editor.Times.PlaybackReleaseTime", time:0)</step>
 
      <step>Handles.ClearSelection()</step>
      <step>ActionScript.SetProperty("Playbacks.Editor.SelectedPlayback", null)</step>
  </macro>
</avolites.macros>

Explanation

This explains the functional steps within the sequence. For all the other XML details please refer to Formats and syntax

  • The first and last two lines Handles.ClearSelection() and ActionScript.SetProperty(“Playbacks.Editor.SelectedPlayback”, null) make handle and playback selection empty so that no other handle/playback is affected by accident.
  • Handles.SetSourceHandle(“PlaybackWindow”, 0) selects a playback as source handle
  • <step condition=“Playbacks.IsCueHandle(Handles.SourceHandle)”>: only if this is a cue playback handle (and not maybe a macro or group handle which would break the macro)…
  • ActionScript.SetProperty(“Playbacks.Editor.SelectedPlayback”, Handles.SourceHandle) derive the playback from the given handle (the playback holds the time, not the handle)
  • ActionScript.SetProperty(“Playbacks.Editor.Times.PlaybackReleaseTime”, time:0) finally sets the releaseTime to the value. time:0 tells the parser what to do with the number 0, i.e. parse it as time value.

How to use it

  • while it's well possible to create some macros to set some playbacks to a given release time, it does make more sense to integrate this into a bigger context like Create Workspaces in order to setup a known show environment.
You could leave a comment if you were logged in.
macros/example/setplaybackreleasetime.txt · Last modified: 2019/04/27 17:09 by sideshowbond