Example

====== Release - Set Master Release Time ======

^ by: | Gregory Haynes |
^ published: | March 2018 |
^ description: | Set the Master Release Time. |
^ remarks: | Watch the slighly different syntax, compared to [[macros:example:palettemasterfadetime|]] |

{{tag>Release Time}}

==== functions ====
  * [[:macros:function:ActionScript.SetProperty]]

==== affected properties ====
  * [[:macros:property:Playbacks.MasterReleaseTime]]

 
===== Code =====
<code xml masterreleasetime.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="Avolites.Menus.xsd">
 <macro name="Master Release 12s" id="UserMacro.MasterRelease.12">
    <description>Sets Master Release Time to 12s.</description>
    <sequence>
      <step>ActionScript.SetProperty("Playbacks.MasterReleaseTime", time:12)</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]]

This simply sets the property Playbacks.MasterReleaseTime to the specified value.

The interesting part is the casting ''time:12'':

>The Playbacks.MasterReleaseTime property is of the type AcwTimeSpan so values will need to be specified as such. As mentioned before since the automatic casting is done based on the parameter types for the function being called so ActionScript.SetProperty functions will not cast as prior to them being called the type of the property is unknown.
> 
>You therefore need to explicitly cast the value to the correct type, for example:
>''ActionScript.SetProperty("Playbacks.MasterReleaseTime", time:12)''
> (G. Haynes)


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

  * [[:macros:deploying|make this macro available]]
  * you might want to create some of these macros, with various times.


~~DISCUSSION~~