Dokumentation des Elvis-Pakets „Artnet“
Übersicht
Der im Elvis-Setup eingebaute DMX-Anschluss ist auf DMX-Interfaces der Fa. Cinetix ausgelegt, die nicht mehr produziert werden.
Dieses Paket realisiert den Zugriff über beliebige Artnet-kompatible DMX-Interfaces, wie sie von vielen Herstellern am Markt verfügbar sind. Wir haben den Anschluss z.B. mit dem Enttec ODE Mk2 erfolgreich getestet.
Im Vergleich zum vorhandenen DMX-Anschluss bietet der neue Anschluss auch erweiterte Funktionalität.
Dieses Paket ist im Moment eine BETA-Version!
Vorgehensweise
Nach dem Einfügen des Pakets über den Paket-Manager (ab Elvis 3.3.114) in das Server-Projekt steht der neue Anschluss-Treiber „ArtnetDriver“ zur Verfügung.
Als Nächstes ist im Server-Projekt ein neuer Datenpunkt-Anschluss zu erstellen: Rechtsklick auf das Serverprojekt -> Hinzufügen -> Serverdaten hinzufügen -> Anschluss mit Datenpunkten. Die zugehörige *.elvissc-Datei sollte dabei gleich einen entsprechenden Namen erhalten.
Anschließend erstellt man in dieser Datei durch Klick auf das grüne Kreuz einen ersten Tabelleneintrag, d.h. eine neue Port-Instanz, und wählt dazu in der Spalte „Treibertyp“ die Option „ArtnetDriver“ aus. Die Konfiguration dieses neuen Ports erfolgt im Eigenschaftsfenster. Im Feld „Lokale IP-Adresse“ müssen Sie nur etwas eintragen, wenn der Elvis-Server-Computer mehrere Netzwerkschnittstellen hat; in diesem Fall tragen Sie hier die IP-Adresse der gewünschten Netzwerkschnittstelle ein. Unter Subnetz-Maske geben Sie die zugehörige Subnetz-Maske ein; Standardwert ist 255.255.255.0.
Nun kann man Datenpunkte für diesen Anschluss für die einzelnen zu übertragenden Daten anlegen (oder auch aus dem Prozess importieren). Die Adressen haben die Form:
uni:kanal
Hierbei ist uni das am Artnet-Interface einstellbare „Universum“. Werden auch die Artnet-Features Net und Subnet benutzt, schreibt man für das Universum net.subnet.universe.
Für Mehrfachkanäle geben Sie einen Kanalbereich an:
uni:startkanal–endkanal
Über ein angehängtes L oder B können Sie bei Mehrfachkanälen die Byteanordnung LitteEndian (L) oder BigEndian (B; Standardwert) festlegen.
Der Anschluss unterstützt folgende Datenpunkttypen:
- Numerisch (z.B. Byte oder Double). Hier kann zusätzlich in ProcessTypeInfo ein Skalierungsfaktor angegeben werden. „*0.39216“ sorgt z.B. dafür, dass die DMX-Werte 0-255 in Elvis als 0-100 repräsentiert werden.
- Color. Hier muss zusätzlich in ProcessTypeInfo „RGB“ angegeben werden. Damit können drei aufeinanderfolgende DMX-Kanäle als Farbwert abgebildet werden.
Download Beispielprojekt
Hinweis: Die zip-Datei bitte mit einem Packprogramm (z.B. 7-Zip) entpacken oder die Eigenschaften der heruntergeladenen zip-Datei aufrufen und bei Sicherheit den Haken bei „Zulassen“ setzen. Andernfalls werden die dll-Dateien blockiert!
