DMXControl-Messages

aus dem DMXControl-Wiki

DMXControl verwendet zur internen Kommunikation eine Reihe von Windows-Messages, um Vorgänge asynchron ausführen zu können. Wenn Sie ein Plugin entwickeln, ist diese Liste für sie wichtig. Jede Message hat zwei zusätzliche Datenparameter, die verschieden benutzt werden: Arg1 und Arg2. Beides sind Variablen vom Typ "Long", es können also keine Zeichenketten direkt übermittelt werden.

Bitte beachten Sie, dass Messages natürlich nur funktionieren können, wenn das entsprechende Empfänger-Fenster auch geöffnet ist.

Folgende Nachrichten sind in DMXC verfügbar:

• MSG_Channel_Set
  • Der Kanal Arg1 soll auf den Wert Arg2 gesetzt werden. Diese Nachricht wird vom DMX-Mixer bei Werteänderungen erzeugt. Sie gibt nicht den endgültig auszugebeneden Wert wieder, da dieser erst noch vom Core verändert werden kann.

• MSG_Channel_Send
  • Der Kanal Arg1 soll auf den Wert Arg2 gesetzt werden. Arg2 gibt den endgültigen DMX-Wert an, wie er auch zum Interface gesendet wird. Sie können diese Message verwenden, um über DMX-Werteänderungen informiert zu werden.

• MSG_Master_Set
  • Der in Arg1 angegebene Fader des Masterfader-Tools wird auf den Wert Arg2 gesetzt. Dabei kann Arg1 folgende Werte annehmen:
    • MST_Grand = 1
    • MST_Flash = 3

• MSG_SM_Set
  • Der in Arg1 angegebene Submaster (1-12) wird auf den Wert aus Arg2 gesetzt.

• MSG_SM_Move (Privat)
  • Der in Arg1 angegebene Submaster (1-12) wird um den Wert aus Arg2 geändert.

• MSG_SM_Flash
  • Der in Arg1 angegebene Submaster (1-12) wird geflasht (Arg2=True) oder "deflashed" (Arg2=False)

• MSG_Beat_Detected
  • Eines der Sound-Tools hat einen Beat erkannt. Es ist gleichzeitig immer nur eine Beat-Quelle aktiv. Kommt der Beat vom Sound-Analyzer ist Arg1=1, kommt der Beat vom BeatTool ist Arg1=2. Arg2 wird nicht verwendet und ist immer 0.

• MSG_Command_Blackout
  • Ein Blackout wird aktiviert (Arg1=True) oder deaktiviert (Arg1=False). Arg2 wird nicht ausgewertet.

• MSG_Device_Changed
  • Die Gerätekonfiguration hat sich geändert. Arg1 kann das geänderte Gerät enthalten, tut dies aber nicht unter allen Umständen.

• MSG_Modules_Changed
  • Die Modulkonfiguration hat sich verändert. Arg1 gibt die numerische ID des geänderten Moduls an, sollte aber nicht ausgewertet werden.

• MSG_Config_Changed
  • Eine Einstellung hat sich verändert. Arg1 kann folgende Werte annehmen:
    • CHG_MIDIRemote = 1
    • CHG_Filename = 2
    • CHG_Device = 3
    • CHG_Joystick = 4
    • CHG_Keyboard = 5
    • CHG_DMXInRemote = 6
    • CHG_ProjectFile = 7
  • Beim Auftreten dieser Message mit Arg1=CHG_Filename hat der Benutzer ein anderes Projekt geöffnet. Die Tools müssen die neue Projektdatei laden.

• MSG_Config_WillChange
  • Eine Einstellung wird sich ändern. Arg1 kann die gleichen Werte wie bei MSG_Config_Changed annehmen. In Verbindung mit Arg1=CHG_Filename tritt diese Message auf, wenn der Benutzer die Projektdatei wechseln möchte, aber noch bevor die Änderung aktiv wird. Daher müssen die Tools nachfragen, ob eventuelle Änderungen gespeichert werden sollen. Anschließend wird meistens MSG_Config_Changed auftreten.

• MSG_Item_Select (privat)
  • Ein Element wird ausgewählt. Arg1 gibt den Elementtyp an und kann folgende Werte annehmen:
    • ITM_Device = 1
    • ITM_Selection = 4
    • ITM_TapButton = 5
    • ITM_Scenelist = 6
    • ITM_SyncButton = 7
  • Über Arg2 wird das Element spezifiziert. Werte größer oder gleich 0 wählen ein definiertes Element aus, folgende Werte sind ebenfalls möglich:
    • SEL_Next = -1
    • SEL_Prev = -2
    • SEL_Act = -3
    • SEL_Unselect = -4
  • SEL_Next und SEL_Prev wählen das nächte bzw. vorhergehende Element aus. Sel_Act ändert die Auswahl nicht und SEL_Unselect entfernt die Auswahl des Elements.

• MSG_File_Save
  • Der Benutzer möchte das Projekt speichern. Alle Tools speichern die aktuellen Daten in ihren Projektdateien.

• MSG_Toggle_OnOff (Privat)
  • Eine Funktion soll ein- oder ausgeschaltet werden. Arg1 gibt die Funktion an und kann folgende Werte annehmen:
    • TGL_Sound2Light = 1
  • Arg2 bestimmt das Umschaltverhalten und kann folgende Werte annehmen:
    • MDE_On = 1
    • MDE_Off = 2
    • MDE_Toggle = 3
  • MDE_On und MDE_Off schalten die Funktion ein- bzw. aus, während MDE_Toggle den aktuellen Zustand umschaltet (On -> Off, Off -> On)

• MSG_Scenelist_Go (Privat)
  • Der "Go!"-Button der Szenenliste soll ausgelöst werden

• MSG_Window_View
  • Die Fensteransicht wurde umgeschaltet (Edit/Execution). Arg1 kann folgende Werte annehmen:
    • VIW_Execute = 1
    • VIW_Edit = 2

• MSG_DMXIn_Channel_Set
  • Der DMX-In-Wert für den Kanal Arg1 wurde auf den Wert Arg2 geändert.

• MSG_Item_Next (Privat)
  • Der nächste Schitt eines Elements wird ausgeführt. Arg1 und Arg2 sind wie bei MSG_Item_Select belegt.