AVOSUPPORT

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
Function

====== Triggers.ToggleMappingEnable ======

  Void Triggers.ToggleMappingEnable(Int32 mappingId)

^ API | http://api.avolites.com/10.1/Triggers.ToggleMappingEnable.html |
^ description | Toggles whether a mapping is enabled. |
^ [[macros:namespace|namespace]] | [[macros:namespace:Triggers]] |
^ parameter | mappingId ( [[macros:type:int32]] ) : The ID of the trigger mapping to toggle |
^ return value | [[macros:type:void]] |  

<fs xx-large>**This is version-dependent**</fs>

**In Titan v10**, the mappingId is independent from the titanId and starts at 0:
  * mappingId 0 refers to the factory mapping DJ Tap
  * mappingId 1 refers to the factory mapping MIDI Show Control
  * mappingId 2 refers to the first user-defined macro
  * mappingId 3 refers to the second user-defined macro
  * user-defined macros are numbered in the order of their creation. However they are displayed in an alphanumerical order regardless which one was created first.

**From Titan v11 on** the mappingId is part of the titanId scope which are created internally and cannot be changed nor made visible easily.

I found that in a **new show in v11** the factory defined mappings have the titanIds 1815 and 1816, and user-defined macros start with 1817. but this may change as soon as anything else is programmed, and is of limited use.

In a **new show in v12** the factory mappings have titanIds 1817 and 1818 and the user-defined macros start thereafter. However v12 has a function to make use of the mapping's user number: [[macros:function:ToggleMappingEnabledByHandle|Triggers.ToggleMappingEnabledByHandle()]]. The user numbers cannot be edited or displayed but are assigned in a similar fashion like the mappingIds in v10 (see above): the factory mappings have Ids 1 and 2, and the user defined mappings start from Id 3.

In a **new show in v13** the titanIds have changed again and are now in the 1820 range, depending from macros loaded on startup. There is no DJ Tap mapping, MIDI Show Control has user number 1, and user defined trigger mappings start at user number 2 in order of their creation,


== Example in == 
[[macros:example:toggletriggermappings|]]: 

<code xml>
<step>Triggers.ToggleMappingEnable(2)</step>
</code>

== Also used in ==

{{backlinks>.}}

== Remarks ==

~~DISCUSSION~~