Lektion 1 Tut3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
Zur Navigation springen Zur Suche springen
(Veraltete Informationen entfernt)
 
(86 dazwischenliegende Versionen von 16 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<h2 style="{{Style:Hauptseite:Überschrift}}" align="center">DMXControl 3 Übungen/Tutorial?</h2>
+
{{Hauptüberschrift
<div style="{{Style:Hauptseite:Box}} background-color:#ffffff">
+
| logo = Im-aim.png
<!-- Rechte Spalte -->
+
| ueberschrift = Erste Schritte: {{PAGENAME}}
<div class="floatright" style="width: 78%;  margin-top:-8px;">
+
}}
 +
{{NavigationTop-Tut3
 +
| vorLink = Lektion_2_Tut3
 +
| vorText = Lektion 2
 +
}}
  
 
==Überblick==
 
==Überblick==
Dieser Artikel gibt einen ersten Einblick in die zweigeteilte Struktur von DMXControl 3. Du wirst lernen wie die Client-Server Kommunikation funktioniert und wie man mit dem Kernel umgeht.
 
  
 +
'''Updates erforderlich:'''
  
==Artikel:Installation und Konfiguraion==
+
* Links funktionieren nicht mehr
 +
* es gibt jetzt auch den "dark mode"
  
DMXControl 3 besteht aus zwei Softwareteilen. Der eine Teil fungiert als Server, der andere als Client. Der Client ist ein Windows-Programm, dass aber mittels Mono auch auf Linux ausgeführt werden kann.
 
  
Einer oder mehrere Cleints können auf verschiedenen Betriebssystemen gestartet werden (z.B. Windows, iOS, Android, ...). Diese Struktur ermöglicht das arbeiten in Teams während der Einrichtung und der Show, wobei Szenenlisten schon abgespielt werden können, während ein andere noch daran arbeitet.
+
Durch das komplett veränderte Bedienkonzept im Vergleich zu DMXControl 2 ist ein grundlegendes Umdenken bei der Bedienung von DMXControl 3 nötig. Diese Lektionen sollen dabei helfen, sich in dieses Konzept einzuarbeiten und die nötigen Kenntnisse über die grundlegenden Eigenheiten der neuen Oberfläche vermitteln.
 +
Hier zu Beginn ein Vorgeschmack auf das, was Euch erwartet:
 +
{{Bild_mit_Unterschrift|DMXC3 Overview.jpg|1|Auswahl einiger DMXControl 3 Fenster|center|600px}}
 +
<br>
  
Die Trennung von Server und Client bringt folgende Vorteile mit sich:
+
DMXControl 3 besteht aus zwei Softwareteilen. Der eine Teil fungiert als Server, der andere als Client. Der Server (im Folgenden als Kernel bezeichnet) verwaltet alle Information bezüglich des Projektes. Der Client (im Folgenden als GUI bezeichnet) dient als Schnittstelle zwischen dem Kernel und dem User. Vor allem am Anfang wirst davon nur bedingt etwas mitbekommen.
  
    * Wenn die Benutzeroberfläche ausfällt arbeitet der Server weiter und verschickt weiterhin DMX-Signale
+
Ein oder mehrere GUIs können auf verschiedenen Systemen (PCs) gestartet werden. Diese Struktur ermöglicht das Arbeiten in Teams während der Einrichtung und der Show, wobei Szenenlisten schon abgespielt werden können, während ein anderer noch an der Show arbeitet.
    * Mehrere Nutzer können sich den Kernel teilen und als Team zusammenarbeiten
 
    * Der Kernel und die Benutzeroberfläche können auf verschieden Computern ausgeführt werden
 
  
===Der Kernel===
+
Die Trennung von Server und Client bringt folgende Vorteile mit sich:
  
Starte zuerst den Kernel, in diesem Fall den DMXControl Server. Momentan heißt diese Applikation ''Lumos.exe''. Zukünftig wird sich ein normaler Nutzer nicht mehr um den Kernel kümmern müssen, er wird automatisch mit DMXControl gestartet werden.
+
* Wenn die GUI ausfällt, arbeitet der Kernel weiter und verschickt weiterhin DMX-Signale
 +
* Mehrere Nutzer können sich den Kernel teilen und als Team zusammenarbeiten
 +
* Der Kernel und die GUI können auf verschiedenen Computern ausgeführt werden
  
[[Datei:DMXC3L01 kernel.JPG|600px]]
 
  
Während des Startvorgangs kannst du beobachten, was alles von DMXControl geladen wird. Der Kernel ist die zentrale Stelle für alle Informationen über Geräte, cues?, Projekte usw. auf welche von allen Clients zugegriffen werden kann.
+
==Lektion 1: Installation und Konfiguration==
  
Der Kernel stellt eine Kommandozeile zur Verfügung. Mit dem Schlüsselwort ''help'' kann man sich eine Liste aller möglichen Kommandos ausgeben lassen.
+
DMXControl&nbsp;3 wird über einen Installations-Assistent installiert. Dieser prüft auch, ob die notwendige Software auf dem PC installiert ist und bietet an, diese gegebenenfalls zu installieren. Optional kann, wie auch bei DMXControl 2, die Installation von EasyView oder nur bestimmte Ausgabe-Plugins ausgewählt werden. Nach der Installation befinden sich drei Verknüpfungen im Startmenü:
 +
* DMXControl&nbsp;3
 +
* DMXControl&nbsp;3 GUI
 +
* DMXControl&nbsp;3 Kernel
  
[[Datei:DMXC3L01 konsole.JPG|600px]]
+
<br>
  
 +
Für den Einstieg und wenn du DMXControl&nbsp;3 nur auf einem PC ausführst reicht es, dass du die einfache Verknüpfung mit dem Namen "DMXControl&nbsp;3" auswählst. Darüber startest du Kernel und GUI gemeinsam. Beim ersten Start muss gegebenenfalls die Kommunikation zwischen den Prozessen von DMXControl freigeben werden, sofern eine Firewall wie die Windows Firewall aktiv ist.
 +
{{Bild_mit_Unterschrift |DMXC3_Tutorial_Lektion1_Firewall.png|5|Warnung der Firewall beim Ausführen von DMXControl 3|center}}
  
Hier ein paar Kommandozeilenbefehle um genauere Informationen über den Status des Kernels zu bekommen:
+
Ist das Fenster der GUI vollständig geladen, kannst du direkt starten. DMXControl&nbsp;3 lädt am Anfang automatisch immer ein leeres Projekt. Möchtest du das aktuelle Projekt speichern, klicke auf '''File''' => '''Save Project''' bzw. '''File''' => '''Save Project As...'''. Dann speichert DMXControl&nbsp;3 alle Projektdaten in einer .zip-Datei ab. Abgespeicherte Projekte können über '''File''' => '''Load Project''' geöffnet werden.
* shutdown: Beendet den Kernel
+
<br><br>
* status: Zeigt Statusinformationen an
 
* menu: Zugang zum Control menue?
 
* clear: Leert die Konsole
 
* notification: Sendet eine Benachrichtigung an alle Clients
 
* width: Legt Breite der Konsole fest (Anz. der Zeichen)
 
* help: Hilfemenü (auch über "?" erreichbar)
 
  
Für ''menu'' und ''status'' gibt es zusätzliche Kommandos.
 
  
  
===Der Client/Die Benutzeroberfläche ?===
+
===Der Kernel===
Im nächsten Schritt sollst du die Windows basierende Benutzeroberfläche starten (aktuell ''LumosGUI.exe'' genannt). Dieses Programm wird in den nächsten Kapiteln erklärt. Zuerst musst du
+
Starte zuerst den Kernel (Verknüpfung DMXControl&nbsp;3 Kernel), also den DMXControl Server.  
In next step you should start the Windows based GUI client (currently called "LumosGUI.exe". This client will be explained in next lectures. At first you have to select the "Tools->Connection" panel in order to connect with the server.
+
{{Bild_mit_Unterschrift |DMXC3L01 kernel.JPG|2|Der Kernel beim Startup|center|600px}}
  
 +
Während des Startvorgangs kannst du beobachten, was alles von DMXControl geladen wird. Der Kernel ist die zentrale Stelle für alle Informationen über Geräte, Szenen, Projekte usw., auf welche von allen Clients zugegriffen werden kann.
  
[[Datei:DMXC3L01 connect.JPG]]
+
Der Kernel stellt eine Kommandozeile zur Verfügung. Mit dem Schlüsselwort ''help'' kann man sich eine Liste aller möglichen Kommandos ausgeben lassen.
 +
{{Bild_mit_Unterschrift |DMXC3L01 konsole.JPG|3|Konsolenansicht des Kernels|center|600px}}
  
If you have installed a firewall you have to grant the communication between client and server.
+
Hier ein paar Kommandozeilenbefehle um genauere Informationen über den Status des Kernels zu bekommen:
 +
* shutdown: Beendet den Kernel
 +
* status: Zeigt Statusinformationen an
 +
* menu: Zugang zum Kontrollmenü
 +
* clear: Leert die Konsole
 +
* notification xxx:  Sendet eine Benachrichtigung an alle Clients
 +
* width xxx: Legt Breite der Konsole fest (Anz. der Zeichen)
 +
* load "[Dateipfad]": Lädt ein Projekt
 +
* save "[Dateipfad]": Sichert das aktuelle Projekt
 +
* dmxout [channel, val]+: Setzt DMX Out Werte
 +
* dmxin [channel, val]+: Setzt DMX In Werte
 +
* help: Hilfemenü (auch über '?' erreichbar)
  
 +
Für ''menu'' und ''status'' gibt es zusätzliche Kommandos. (siehe Appendix2)
 +
<br><br>
 +
===Der Client / Die Benutzeroberfläche ===
 +
Im nächsten Schritt solltest du die Windows basierende Benutzeroberfläche (''LumosGUI.exe'' genannt) starten (Verknüpfung DMXControl&nbsp;3 GUI).
 +
Dieses Programm wird in den nächsten Lektionen näher erklärt.
  
[[Datei:DMXC3L01 startGUI.JPG|600px]]
+
<br>
 +
Zuerst muss jedoch die Kommunikation zwischen Kernel und Client initiiert werden. Beim Start des Clients wird automatisch ein Verbindungsfenster geöffnet. Man kann aber auch nachträglich über das Menü ''Connection-->Connect'' dieses Fenster öffnen. In der rechten unteren Ecke des DMXControl-Fensters befindet sich ein kleines Monitor-Icon, welches ein rotes Kreuz aufweist, wenn keine Verbindung zum Server besteht. Auch ein Klick auf dieses Icon öffnet das Verbindungs-Fenster.
 +
{{Bild_mit_Unterschrift |DMXC3L01 connect.JPG|4|Verbindungsfenster des Clients|center}}
  
After establishing the connection you should see a small icon in the lower line of the client.
+
Wenn du eine aktive Firewall hast (hier am Beispiel der Windows Firewall), muss die Kommunikation zwischen den Prozessen von DMXControl freigeben werden.
 +
{{Bild_mit_Unterschrift |DMXC3_Tutorial_Lektion1_Firewall.png|5|Warnung der Firewall beim Ausführen von DMXControl 3|center}}
  
Now you are able to load your project. DMXControl will provide a default demo project. You can oen it with menue point "Project".
+
Nach dem Aufbauen der Verbindung zeigt das kleine Icon in der unteren Zeile des Clients ein blaues Monitor-Icon für eine erfolgreiche Verbindung sowie die Anzahl der mit dem Server verbundenen Clients an.
  
 +
{{Bild_mit_Unterschrift |DMXC3L01 connected.png|6|Client erfolgreich mit dem Kernel verbunden|center}}
  
'''topics to be added (by beta tester)'''
+
{{BoxHinweis
* how to save a project
+
|Text = Wenn du dem Programm "LumosGUI.exe" beim Ausführen den Parameter "-nonetwork" übergibst, wird beim Start des Kernels automatisch ein Client mitgestartet und direkt mit dem Kernel verbunden. Dadurch ersparst du dir den manuellen Verbindungsaufbau und das System ist nach dem Start sofort einsatzbereit. '''Im Startmenü wird bei der Installation eine Verknüpfung erzeugt, die diesen Parameter beim Start übergibt. Die Verknüpfung heißt "DMXControl&nbsp;3".'''}}
*
 
  
==Excercise==
+
=== Projekt Management ===
 +
Um ein neues Projekt anzulegen, klickst du auf '''File''' => '''New Project'''. Möchtest du das aktuelle Projekt speichern, klicke auf '''File''' => '''Save Project''' bzw. '''File''' => '''Save Project As...'''. Dann speichert DMXControl&nbsp;3 alle Projektdaten in einer .zip-Datei ab. Abgespeicherte Projekte können über '''File''' => '''Load Project''' geöffnet werden.
 +
<br><br>
  
1) Please try following commands in command shell:
+
==Übung==
 +
1) Teste die folgenden Kommandos in der Konsole:
 
* menue
 
* menue
 
* status
 
* status
* shutdown -> uups!
+
* shutdown
 
+
<br>
2) Restart kernel and GUI and connect your client with DMXControl server.
+
2) Starte den Kernel neu und verbinden den DMXControl Client ( "DMXControl 3 GUI") mit dem Server.
 
 
 
 
Congratulation! Now you have successfully installed your own DMXControl configuration!
 
 
 
 
 
==Assumptions for installation==
 
 
 
DMXControl 3.0 requires following software to be installed before executing the setup program:
 
 
 
* DirectX 9.0c
 
* .NET Framework 3.5 SP1 or higher
 
* XNA Framework 3.0(xnafx30_redist.msi)
 
 
 
==Additional links and references==
 
 
 
# [http://www.microsoft.com/DOWNLOADS/details.aspx?familyid=9226A611-62FE-4F61-ABA1-914185249413&displaylang=de DirectX 9.0c]
 
# [http://www.microsoft.com/downloads/de-de/details.aspx?FamilyID=333325fd-ae52-4e35-b531-508d977d32a6 .NET Framework 3.5]
 
# [http://www.microsoft.com/downloads/de-de/details.aspx?FamilyID=ab99342f-5d1a-413d-8319-81da479ab0d7 .NET Framework 3.5 Service Pack 1]
 
# [http://www.microsoft.com/downloads/details.aspx?FamilyID=6521d889-5414-49b8-ab32-e3fff05a4c50&displaylang=en XNA Framework 3.0]
 
 
 
==Certificate==
 
I have understood the topics of this lecture and want to continue with next course:
 
[http://www.dmxcontrol.de/mediawiki_beta/index.php?title=Einsteiger:Lesson2/en Lecture2: The panel concept]
 
 
 
</div>
 
 
 
<!-- Linke Spalte -->
 
<div style="{{Style:Hauptseite:Box}} width: 17%; background-color:#f5faff">
 
{{DMXC3_lesson/en}}
 
</div>
 
  
 +
3) Probiere es einfach aus: Schieße die GUI mit dem Taskmanager ab und starte sie neu. Der Kernel hat zwischendurch weitergearbeitet.
 +
<br><br>
 +
Herzlichen Glückwunsch! Jetzt hast du DMXControl 3 erfolgreich installiert!
 +
<br><br>
  
__NOTOC__
+
{{NavigationTop-Tut3
{{Languages|Einsteiger:lesson1}}
+
| vorLink = Lektion_2_Tut3
 +
| vorText = Lektion 2
 +
}}
 +
[[en: Lesson_1_Tut3]]
 +
[[Kategorie: Tutorials DMXControl 3]]

Aktuelle Version vom 14. August 2021, 16:43 Uhr

Im-aim.png Erste Schritte: Lektion 1 Tut3
Lektion 2 Arrow forw.png
Inhaltsverzeichnis


Überblick

Updates erforderlich:

  • Links funktionieren nicht mehr
  • es gibt jetzt auch den "dark mode"


Durch das komplett veränderte Bedienkonzept im Vergleich zu DMXControl 2 ist ein grundlegendes Umdenken bei der Bedienung von DMXControl 3 nötig. Diese Lektionen sollen dabei helfen, sich in dieses Konzept einzuarbeiten und die nötigen Kenntnisse über die grundlegenden Eigenheiten der neuen Oberfläche vermitteln. Hier zu Beginn ein Vorgeschmack auf das, was Euch erwartet:

Abbildung 1:Auswahl einiger DMXControl 3 Fenster
Abbildung 1: Auswahl einiger DMXControl 3 Fenster


DMXControl 3 besteht aus zwei Softwareteilen. Der eine Teil fungiert als Server, der andere als Client. Der Server (im Folgenden als Kernel bezeichnet) verwaltet alle Information bezüglich des Projektes. Der Client (im Folgenden als GUI bezeichnet) dient als Schnittstelle zwischen dem Kernel und dem User. Vor allem am Anfang wirst davon nur bedingt etwas mitbekommen.

Ein oder mehrere GUIs können auf verschiedenen Systemen (PCs) gestartet werden. Diese Struktur ermöglicht das Arbeiten in Teams während der Einrichtung und der Show, wobei Szenenlisten schon abgespielt werden können, während ein anderer noch an der Show arbeitet.

Die Trennung von Server und Client bringt folgende Vorteile mit sich:

  • Wenn die GUI ausfällt, arbeitet der Kernel weiter und verschickt weiterhin DMX-Signale
  • Mehrere Nutzer können sich den Kernel teilen und als Team zusammenarbeiten
  • Der Kernel und die GUI können auf verschiedenen Computern ausgeführt werden


Lektion 1: Installation und Konfiguration

DMXControl 3 wird über einen Installations-Assistent installiert. Dieser prüft auch, ob die notwendige Software auf dem PC installiert ist und bietet an, diese gegebenenfalls zu installieren. Optional kann, wie auch bei DMXControl 2, die Installation von EasyView oder nur bestimmte Ausgabe-Plugins ausgewählt werden. Nach der Installation befinden sich drei Verknüpfungen im Startmenü:

  • DMXControl 3
  • DMXControl 3 GUI
  • DMXControl 3 Kernel


Für den Einstieg und wenn du DMXControl 3 nur auf einem PC ausführst reicht es, dass du die einfache Verknüpfung mit dem Namen "DMXControl 3" auswählst. Darüber startest du Kernel und GUI gemeinsam. Beim ersten Start muss gegebenenfalls die Kommunikation zwischen den Prozessen von DMXControl freigeben werden, sofern eine Firewall wie die Windows Firewall aktiv ist.

Abbildung 5:Warnung der Firewall beim Ausführen von DMXControl 3
Abbildung 5: Warnung der Firewall beim Ausführen von DMXControl 3


Ist das Fenster der GUI vollständig geladen, kannst du direkt starten. DMXControl 3 lädt am Anfang automatisch immer ein leeres Projekt. Möchtest du das aktuelle Projekt speichern, klicke auf File => Save Project bzw. File => Save Project As.... Dann speichert DMXControl 3 alle Projektdaten in einer .zip-Datei ab. Abgespeicherte Projekte können über File => Load Project geöffnet werden.


Der Kernel

Starte zuerst den Kernel (Verknüpfung DMXControl 3 Kernel), also den DMXControl Server.

Abbildung 2:Der Kernel beim Startup
Abbildung 2: Der Kernel beim Startup


Während des Startvorgangs kannst du beobachten, was alles von DMXControl geladen wird. Der Kernel ist die zentrale Stelle für alle Informationen über Geräte, Szenen, Projekte usw., auf welche von allen Clients zugegriffen werden kann.

Der Kernel stellt eine Kommandozeile zur Verfügung. Mit dem Schlüsselwort help kann man sich eine Liste aller möglichen Kommandos ausgeben lassen.

Abbildung 3:Konsolenansicht des Kernels
Abbildung 3: Konsolenansicht des Kernels


Hier ein paar Kommandozeilenbefehle um genauere Informationen über den Status des Kernels zu bekommen:

  • shutdown: Beendet den Kernel
  • status: Zeigt Statusinformationen an
  • menu: Zugang zum Kontrollmenü
  • clear: Leert die Konsole
  • notification xxx: Sendet eine Benachrichtigung an alle Clients
  • width xxx: Legt Breite der Konsole fest (Anz. der Zeichen)
  • load "[Dateipfad]": Lädt ein Projekt
  • save "[Dateipfad]": Sichert das aktuelle Projekt
  • dmxout [channel, val]+: Setzt DMX Out Werte
  • dmxin [channel, val]+: Setzt DMX In Werte
  • help: Hilfemenü (auch über '?' erreichbar)

Für menu und status gibt es zusätzliche Kommandos. (siehe Appendix2)

Der Client / Die Benutzeroberfläche

Im nächsten Schritt solltest du die Windows basierende Benutzeroberfläche (LumosGUI.exe genannt) starten (Verknüpfung DMXControl 3 GUI). Dieses Programm wird in den nächsten Lektionen näher erklärt.


Zuerst muss jedoch die Kommunikation zwischen Kernel und Client initiiert werden. Beim Start des Clients wird automatisch ein Verbindungsfenster geöffnet. Man kann aber auch nachträglich über das Menü Connection-->Connect dieses Fenster öffnen. In der rechten unteren Ecke des DMXControl-Fensters befindet sich ein kleines Monitor-Icon, welches ein rotes Kreuz aufweist, wenn keine Verbindung zum Server besteht. Auch ein Klick auf dieses Icon öffnet das Verbindungs-Fenster.

Abbildung 4:Verbindungsfenster des Clients
Abbildung 4: Verbindungsfenster des Clients


Wenn du eine aktive Firewall hast (hier am Beispiel der Windows Firewall), muss die Kommunikation zwischen den Prozessen von DMXControl freigeben werden.

Abbildung 5:Warnung der Firewall beim Ausführen von DMXControl 3
Abbildung 5: Warnung der Firewall beim Ausführen von DMXControl 3


Nach dem Aufbauen der Verbindung zeigt das kleine Icon in der unteren Zeile des Clients ein blaues Monitor-Icon für eine erfolgreiche Verbindung sowie die Anzahl der mit dem Server verbundenen Clients an.

Abbildung 6:Client erfolgreich mit dem Kernel verbunden
Abbildung 6: Client erfolgreich mit dem Kernel verbunden


 Wichtiger Hinweis Wenn du dem Programm "LumosGUI.exe" beim Ausführen den Parameter "-nonetwork" übergibst, wird beim Start des Kernels automatisch ein Client mitgestartet und direkt mit dem Kernel verbunden. Dadurch ersparst du dir den manuellen Verbindungsaufbau und das System ist nach dem Start sofort einsatzbereit. Im Startmenü wird bei der Installation eine Verknüpfung erzeugt, die diesen Parameter beim Start übergibt. Die Verknüpfung heißt "DMXControl 3".


Projekt Management

Um ein neues Projekt anzulegen, klickst du auf File => New Project. Möchtest du das aktuelle Projekt speichern, klicke auf File => Save Project bzw. File => Save Project As.... Dann speichert DMXControl 3 alle Projektdaten in einer .zip-Datei ab. Abgespeicherte Projekte können über File => Load Project geöffnet werden.

Übung

1) Teste die folgenden Kommandos in der Konsole:

  • menue
  • status
  • shutdown


2) Starte den Kernel neu und verbinden den DMXControl Client ( "DMXControl 3 GUI") mit dem Server.

3) Probiere es einfach aus: Schieße die GUI mit dem Taskmanager ab und starte sie neu. Der Kernel hat zwischendurch weitergearbeitet.

Herzlichen Glückwunsch! Jetzt hast du DMXControl 3 erfolgreich installiert!

Lektion 2 Arrow forw.png
Inhaltsverzeichnis