Example

====== Set Wheel Mode ======

^ by:           | Sebastian Beutel, July 2021                                                                          |
^ published:    | here                                                                                                 |
^ description:  | macros to directly set the wheel mode (level/fade/delay/visualiser)                                  |
^ remarks:      | idea: Ntokozo Mandla Mahlangu, see https://www.facebook.com/groups/Avolites/posts/2257625777702977/  |

{{tag>wheels wheelmode visualiser}}

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

==== affected properties ====
  * [[:macros:property:Programmer.Editor.Fixtures.WheelsControlAttribute]]

==== control structures ====
  * [[macros:active_binding|]]
  * [[macros:converter:Math.EnumAsStringEqualityConverter|]]
 
===== Code =====
<code xml SetWheelMode.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros>

<!-- Macros to directly set the wheel mode -->
<!-- idea: Ntokozo Mandla Mahlangu -->
<!-- https://www.facebook.com/groups/Avolites/posts/2257625777702977/ -->
<!-- Sebastian Beutel, July 2021 -->

  <macro id="Wiki.Macros.SetWheelsLevel" name="Set Wheels=Level">
    <active binding="{propertyLink id='Programmer.Editor.Fixtures.WheelsControlAttribute' 
      converter='Math.EnumAsStringEqualityConverter' 
      converterParameter='Level'}"/>
    <sequence>
      <step>ActionScript.SetProperty.Enum("Programmer.Editor.Fixtures.WheelsControlAttribute","Level")</step>
    </sequence>
  </macro>
  
  <macro id="Wiki.Macros.SetWheelsFade" name="Set Wheels=Fade Time">
    <active binding="{propertyLink id='Programmer.Editor.Fixtures.WheelsControlAttribute' 
      converter='Math.EnumAsStringEqualityConverter' 
      converterParameter='Fade'}"/>
    <sequence>
      <step>ActionScript.SetProperty.Enum("Programmer.Editor.Fixtures.WheelsControlAttribute","Fade")</step>
    </sequence>
  </macro>
  
  <macro id="Wiki.Macros.SetWheelsDelay" name="Set Wheels=Delay Time">
    <active binding="{propertyLink id='Programmer.Editor.Fixtures.WheelsControlAttribute' 
      converter='Math.EnumAsStringEqualityConverter' 
      converterParameter='Delay'}"/>
    <sequence>
      <step>ActionScript.SetProperty.Enum("Programmer.Editor.Fixtures.WheelsControlAttribute","Delay")</step>
    </sequence>
  </macro>
  
  <macro id="Wiki.Macros.SetWheelsVisualiser" name="Set Wheels=Visualiser">
    <active binding="{propertyLink id='Programmer.Editor.Fixtures.WheelsControlAttribute' 
      converter='Math.EnumAsStringEqualityConverter' 
      converterParameter='Visualiser'}"/>
    <sequence>
      <step>ActionScript.SetProperty.Enum("Programmer.Editor.Fixtures.WheelsControlAttribute","Visualiser")</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]]

The main thing is just the line ''ActionScript.SetProperty.Enum("Programmer.Editor.Fixtures.WheelsControlAttribute","...")'' which sets Titan's property to the value you want (here: Level, Fade, Delay, or Visualiser).

Additionally the [[macros:active_binding|]] part is used to highlight the currently selected option for better overview.

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

  - [[:macros:deploying|make this macro available]]
  - copy the macros to some easy-to-reach buttons. This makes it easier to toggle between visualiser and level, instead of repeatedly pressing the menu button.



~~DISCUSSION~~