====== VP101 - Step 01: Opti-Track Trackingsystem einrichten ======

===== 1. Motive und Unreal Engine aufsetzen und miteinander verknüpfen =====

==== OT-Kameras aufbauen ====
  - Kameras aufstellen. System darf nicht schwingen.
  - Mit einem Switch verkabeln. **Hinweis:** Pro OT-Switch maximal 10 Kameras verwenden (wegen Stromversorgungslimit).
  - Blende der Kameras vollständig aufdrehen.
  - Fokus einstellen
    * Einen Tracker in die Mitte legen und Scharfstellen.
  - Blende auf ca. **3.5** schließen.
  - Blende- und Fokusknopf verriegeln.

==== PC mit Optitrack-Switch verbinden ====
  - Motive installieren.
  - OT-System kalibrieren
    * **"New Calibration"** auswählen oder bestehende Kalibrierung unter **"Load Calibration"** öffnen.
    * Vor dem "masken" und "wanden" alle Tracker und reflektierenden Objekte aus dem Volume entfernen.
    * Den Anweisungen der Software folgen.
    * Wanden:
      - Wanden, bis alle grünen Kreise um die Kameralinsen ausgefüllt sind.
      - Achten auf Overfitting, nicht zu lange Samplen
      - Große Bewegungen machen, immer 3 Kameras müssen den Wand sehen
  - Ground Plane kalibrieren
     * Auf Bodenebene platzieren und wässern.
     * **Wichtig:** Die X-Achse muss zur LED-Wand zeigen.
     * Die Ecke des Kalibrierungstools ist nun der Nullpunkt für alle Trackingdaten (Am Besten mit Tape auf dem Boden markieren)

==== Motive Streaming Settings konfigurieren (Zahnrad → **Streaming**) ====
  - Interface (IP) auswählen, über das die Daten ins Netzwerk geschickt werden.
  - **Unicast** auswählen.
  - Festlegen, was gestreamt werden soll.
  - UP-Axis auf **Y-Axis** einstellen.
  - Ganz oben auf **"Enable"** drücken.

==== Rigid Body erstellen ====
  - Trackingpunkte im "**Perspective**"-Fenster per Drag-Bewegung auswählen.
  - Rechtsklick → **Rigid Body erstellen**.
  - Rigid Body als **Kameratracker** benennen.
  - Der Tracker ist nun im "**Assets**"-Fenster zu sehen

==== Unreal Engine einrichten ====
  - Unreal Engine auf einem zweiten Rechner installieren.
  - Neues leeres Projekt erstellen (Raytracing aus)
  - OT-Unreal Plugin installieren:
    * Download: [Optitrack Plugin](https://optitrack.com/support/downloads/plugins.html#unreal-plugin).
    * Dateien ablegen unter: "C:\Program Files\Epic Games\[Engine Version]\Engine\Plugins\"      
  -Plugins in Unreal Engine aktivieren:
    * **Edit → Plugins**:
      - **Optitrack – Live Link**
      - **Live Link**
  - Unreal Engine neu starten.
  - Live Link konfigurieren (**Window → Virtual Production → Live Link**)
  - Live Link Fenster öffnen.
  - Über **+Source → Optitrack Source**:
    * Automatische IPs anwählen.
    * Unicast auswählen.
  - **Falls das nicht funktioniert:**
      - Automatische IPs abwählen.
      - Manuell die IPs eingeben:
        * **Server Address:** IP Optitrack.
        * **Client Address:** IP Unreal PC.
  - Rigid Bodys aus Motive erscheinen mit grüner Statusleuchte im Live Link Fenster.

==== TEST: Trackingdaten in Unreal nutzen ====
  - Neues Objekt in Unreal Engine erstellen:
    * **+Add → Shape → Cube**.
  - Im **Details-Panel**:
    * Über **+Add** einen **Live Link Controller** hinzufügen.
    * Den Controller umbenennen und auswählen.
    * Unter **Live Link → Subject Representation** den gewünschten Rigid Body auswählen.