Differences

This shows you the differences between two versions of the page.

--- macros:function:triggers.setpendingtargethardware [2018/09/10 15:35] – created icke_siegen
+++ macros:function:triggers.setpendingtargethardware [2024/09/30 15:03] (current) – [keyClass] icke_siegen
@@ Line 3: / Line 3: @@
 ====== Triggers.SetPendingTargetHardware ======
-  Void Triggers.SetPendingTargetHardware(String keyClass, MenuEventTypes eventType, String keyGroup, Int32 keyIndex, String keyName)
+  Void Triggers.SetPendingTargetHardware(
+    String keyClass, MenuEventTypes eventType, String keyGroup, Int32 keyIndex, String keyName
+    )
 ^ API | http://api.avolites.com/11.0/Triggers.SetPendingTargetHardware.html |
@@ Line 14: / Line 16: @@
 ^ ::: | keyName ( [[macros:type:string]] ) : the name of the button |
 ^ return value | [[macros:type:void]] |
+Inherently sets [[macros:property:Triggers.PendingTriggerTarget|]]
+==== keyClass ====
+This is case sensitive!
+Possible values:
+MastersEncoder, PresetBlack, PresetSelect, PresetSelectTouch, PresetFlash, PresetFlashTouch, PresetFader, PlaybackBlack, PlaybackSelect (this is also the swop button), PlaybackFlash, PlaybackFader (see below), StaticPlaybackSelect ( = Swop), StaticPlaybackFlash, StaticPlaybackFader, PlaybackSelectTouch, PlaybackTouch, GroupsTouch, PositionsTouch, BeamsTouch, MediaTouch, ColoursTouch, EffectsTouch, FixturesTouch, WorkspacesTouch, MacroSelect, PlaybackPageDown, PlaybackPageUp, FixturePage, RollerPage, GrandMaster, PresetMaster, PlaybackMaster, SwopMaster, FlashMaster, DBO, Connect, Stop, Go, PreviousStep, NextStep, Review, Bounce, LiveTime, NextTime, RecordStep, SnapBack, GoBack, Clear, Locate (and some more for the various wings)
+**In order to hardware-trigger faders the keyClass must read "FaderMove.Fader.PlaybackFader" (at least as of Titan v17), see https://www.facebook.com/groups/1811437589141428**
+==== eventType ====
+As in the examples this seems to be an [[macros:type:enum]]. Either get this with ''[[macros:function:math.toenum]]("","Avolites.Menus.MenuEventTypes", "EventType")'', or pass it directly, without quotes.
+Possible eventTypes used for triggers:
+OnValueChanged, OnSelect, OnButtonDown
+A full list of eventTypes is available here: http://api.avolites.com/11.0/Avolites.Menus.MenuEventTypes.html.
+==== keyGroup ====
+keyGroup appears to be the handle group as outlined in [[macros:identifier:location]], e.g. ''Playbacks'', ''PlaybackWindow'' etc.
+For the 'general purpose' buttons like  Connect. Go, PlaybackPageUp, NextStep etc. the keyGroup is ''NoGroup''.
+==== keyIndex ====
+keyIndex is the index of the button in the group - see [[macros:identifier:location]].
+==== keyName ====
+keyName is informational only (//ASSUMPTION!//), in order to display which button is associated with this trigger.
 == Example in ==
-[[macros:example:addminitrigger]]:
+[[macros:example:addmiditrigger]]:
 <code xml>