# LumiScan Cockpit 1.2.0.8 – complete documentation

> All pages of the LumiScan Cockpit 1.2.0.8 manual (language: de) by HD Vision Systems GmbH, in navigation order. Each page starts with a level-1 heading followed by its URL; cite that URL. Manual: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/

# Beschreibung – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/description.html

LumiScan Cockpit zeigt, was die Vision-Anwendungen auf einer ctrlX CORE, einem ctrlX IPC oder einem PC gerade sehen und was sie darin gefunden haben: auf ctrlX OS in einem gewöhnlichen Webbrowser, auf einem PC in einem eigenen Fenster. Es ist ein Viewer: Es zeichnet die Bilder und Ergebnisse, die andere Anwendungen veröffentlichen, und konfiguriert nichts an ihnen.

Eine Ansicht folgt der Anwendung, die sie zeigt. Ändert sich das Bild dahinter, wird der Browser benachrichtigt und holt das neue Bild, sodass auf dem Bildschirm zu sehen ist, was die Station gerade getan hat - nicht ein Schnappschuss von vor bis zu zwei Sekunden. Während eine Kamera streamt, ist ihre Ansicht live: Sie zeigt die Frames, sobald sie eintreffen. Siehe [Live-Aktualisierung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html).

## Data Layer {#data-layer}

LumiScan Cockpit hat keine eigenen Knoten: Es liest die Knoten der anderen Apps.

Auf ctrlX OS (ctrlX CORE oder ctrlX IPC) nutzt LumiScan Cockpit den [ctrlX Data Layer](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/ctrlx-data-layer.html).

Auf einem PC mit Windows 11 oder Ubuntu 24.04 nutzt LumiScan Cockpit [LumiScan Keryx](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html).

Knotenadressen, Typen und Aufrufmuster sind auf beiden gleich.

Wie Adressen aufgebaut sind, wie Funktionen aufgerufen werden, die Statuscodes und die Werkzeuge sind in [LumiScan Keryx](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/index.html) beschrieben.

Das Cockpit liest alles, was es anzeigt, vom Data Layer - dem ctrlX Data Layer auf ctrlX OS, LumiScan Keryx auf einem PC: die Bildknoten der veröffentlichenden Anwendungen und die Ergebnisknoten der Anwendungen, deren Funde es zeichnet.

Was für jede LumiScan-App gleich ist - wie Adressen aufgebaut sind, die Aufrufmuster Handshake, Execute und Stream, Statuscodes, Einstellungen und Werkzeuge - ist im Handbuch [LumiScan Keryx](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/index.html) beschrieben. Dieses Handbuch behandelt nur, was spezifisch für LumiScan Cockpit ist; die Seiten dieses Handbuchs beschreiben seine eigenen Knoten.

> [!NOTE]
> Das Cockpit stellt **keine eigene Ausgabe auf dem Data Layer** bereit. Nichts anderes auf dem System kann verwenden, was es zeichnet - die Zeichnung existiert nur im Browser oder im Fenster des Cockpits. Um ein Ergebnis programmatisch zu verarbeiten, lesen Sie die Ergebnisknoten der jeweiligen Anwendung.

## Was es zeigt

Zwei Anwendungen veröffentlichen eigene Bilder, und das Cockpit zeigt diese Bilder so, wie sie sind:

- LumiScan Cam Driver (`lumiscan-cam-driver`)
- LumiScan AI Object Matching (`lumiscan-ai-object-matching`)

Acht weitere Anwendungen veröffentlichen kein eigenes Bild - jede liest eines von einer anderen Anwendung -, und das Cockpit zeichnet ihre Funde in Grün auf das Bild, in dem sie gefunden wurden. Diese acht sind in [Ergebnisse ansehen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html) aufgeführt. Die Boxen von AI Object Matching werden auch auf die Live-Frames einer Kamera gezeichnet, während es auf dem Stream der Kamera inferiert.

LumiScan Calibration erzeugt Koordinaten statt eines Bildes und wird nicht angezeigt.

Die Startseite ist eine Übersicht über alle kompatiblen Anwendungen, die gerade auf dem System laufen. Sie beantwortet also auch, welche davon aktiv sind, bevor Sie eine einzelne Ansicht öffnen.

# Voraussetzungen – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/requirements.html

## Lizenz {#licence}

Wie LumiScan Cockpit lizenziert wird, hängt davon ab, wo Sie es gekauft haben und wo es läuft:

| Gekauft bei | Läuft auf | Lizenzierung |
| --- | --- | --- |
| HD Vision Systems | Windows 11 oder Ubuntu 24.04 | Die Lizenz liegt auf Ihrem LumiScan Key. Sie ist ein Einmalkauf und wird nicht verlängert.<br><br>[Lizenzierungsweg: gekauft bei HD Vision Systems](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-hdvs.html) |
| ctrlX Store | Windows 11 | Die Lizenz liegt in ctrlX WORKS. Zusätzlich ist der LumiScan Key erforderlich; er schützt die Software vor Reverse Engineering.<br><br>[Lizenzierungsweg: ctrlX Store, Windows](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-windows.html) |
| ctrlX Store | ctrlX OS (ctrlX CORE oder IPC) | ctrlX-Lizenz `SWL-W-XCx-COCKPITxxxHDVSx-V1NN`, eine Lizenz pro App-Instanz.<br><br>[Lizenzierungsweg: ctrlX Store, ctrlX OS](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-os.html) |

Jedes Gerät, auf dem LumiScan Cockpit gleichzeitig läuft, benötigt einen eigenen LumiScan Key. Keys können zwischen Geräten ausgetauscht werden.

Wie Sie die CodeMeter Runtime installieren und Lizenzen anfordern, verlängern und an einem anderen PC verwenden, steht in [LumiScan Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/index.html).

Auf ctrlX OS beendet sich die Anwendung kurz nach dem Start, wenn die Lizenz fehlt; der Grund wird in das Systemprotokoll geschrieben.

## Wo das Cockpit läuft

| Das Cockpit läuft auf | Data Layer |
| --- | --- |
| ctrlX OS (ctrlX CORE oder ctrlX IPC) | dem ctrlX Data Layer |
| einem PC | LumiScan Keryx (siehe [Das Cockpit öffnen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/opening-the-cockpit.html#windows) und [LumiScan Keryx auf einem PC](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html)) |

Auf einem PC braucht das Bauen der Cockpit-Seiten aus dem Quellcode Node.js mit npm.

## Die Anwendungen, die es zeigt

Das Cockpit zeigt die Daten anderer Anwendungen an, für sich allein zeigt es also eine leere Übersicht. Die Anwendungen, deren Bilder und Ergebnisse es zeichnet, müssen auf **demselben Gerät** laufen - derselben ctrlX CORE, demselben ctrlX IPC oder demselben PC -, weil das Cockpit sie dort vom Data Layer liest.

In der Praxis ist der Ausgangspunkt LumiScan Cam Driver mit einer konfigurierten Kamera: Er veröffentlicht das Bild, das die anderen Anwendungen lesen und auf das die Ergebnisse gezeichnet werden.

## Ein Browser oder das Fenster des Cockpits

**Auf ctrlX OS:** Das Cockpit wird über die ctrlX-Weboberfläche erreicht; jeder Browser, der die ctrlX-Oberfläche öffnen kann, kann also auch das Cockpit öffnen. Ansichten sind gewöhnliche Browser-Tabs.

**Auf einem PC:** Das Cockpit zeigt seine Seiten in einem eigenen Fenster. Mit `--no-gui` gestartet, öffnet das Cockpit kein Fenster, und seine Seiten werden in einem Browser geöffnet. Das Cockpit antwortet nur auf `127.0.0.1`, der Browser muss also auf demselben PC laufen.

(Windows) Das Fenster des Cockpits braucht die Microsoft Edge WebView2 Runtime; ohne sie öffnet das Cockpit seine Seiten stattdessen im Standardbrowser.

Auf beiden Plattformen fragt eine Ansicht, die nicht sichtbar ist, keine Aktualisierungen mehr an. Ansichten, die in Browser-Tabs im Hintergrund offen bleiben, kosten also nichts. Eine Live-Ansicht ist ein MJPEG-Stream, den jeder aktuelle Browser in einem gewöhnlichen Bild anzeigt.

> [!NOTE]
> (ctrlX OS) Ob die ctrlX-Weboberfläche eine Live-Ansicht ohne Verzögerung durchreicht, wurde noch nicht auf einem Gerät geprüft. Falls nicht, zeigt eine Live-Ansicht stattdessen Einzelbilder - siehe [Live-Aktualisierung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html).

## Speicher

Das Cockpit speichert nur eines: seine Einstellungsdatei, wenige Kilobyte JSON im Datenverzeichnis der Anwendung, mit den optionalen Overlays und den Einstellungen der Live-Ansicht. Es behält keine Bilder - jeder Frame wird von der veröffentlichenden Anwendung geholt, wenn er angezeigt wird. Siehe [Overlays](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/overlays.html) und [Einstellungen der Live-Ansicht](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html#settings).

# Anleitung: Positionen auf Kamerabildern mit Overlays markieren – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/how-tos/mark-image-positions-with-overlays.html

Diese Anleitung zeigt ein Kamerabild von LumiScan Cam Driver in LumiScan Cockpit an und zeichnet feste Markierungen darauf: ein Kreuz in der Bildmitte und optional Kreise und Rechtecke. Solche Overlays helfen, eine Kamera auszurichten, ein Teil gegen eine Region von Interesse zu prüfen oder einem Bediener zu zeigen, wo ein Teil liegen muss.

Am Ende zeigt das Cockpit jedes Bild der Kamera mit Ihren Markierungen darüber.

## Bevor Sie beginnen {#prerequisites}

- LumiScan Cockpit und LumiScan Cam Driver sind auf derselben ctrlX CORE installiert und laufen.
- Die Kamera ist verbunden und hat mindestens ein Bild aufgenommen. Falls nicht, siehe das Handbuch von LumiScan Cam Driver.
- Sie können die ctrlX-Weboberfläche in einem Browser auf Ihrem PC öffnen.
- Grundkenntnisse in JSON.

## Wie es zusammenhängt {#overview}

Das Cockpit zeigt die Bilder, die andere LumiScan-Anwendungen auf den ctrlX Data Layer legen. Eigene Bilder erzeugt es nicht. Für LumiScan Cam Driver listet es jedes Kameramodul auf, das unter `hdvisionsystems/lumiscan-cam-driver` gefunden wird.

Overlays sind nicht Teil des Bildes. Sie werden in der Einstellungsdatei des Cockpits, `lumiscan-cockpit.json`, unter `overlay` festgelegt, mit dem Schlüssel `<Anwendung>/<Bildname>`, und das Cockpit zeichnet sie auf jedes Bild mit diesem Schlüssel. Die Datei wird beim Start des Cockpits gelesen; ein geändertes Overlay erscheint also nach einem Neustart. Alle Eigenschaften sind in [Overlays](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/overlays.html) beschrieben.

## Schritt 1 - Prüfen, ob die Kamera Bilder liefert {#step-1-check-camera}

1. Öffnen Sie die ctrlX-Weboberfläche.
2. Prüfen Sie unter **Settings > Apps**, dass LumiScan Cam Driver läuft.
3. Nehmen Sie mit der Kamera ein Bild auf, wie im Handbuch von LumiScan Cam Driver beschrieben.

## Schritt 2 - Das Bild im Cockpit öffnen {#step-2-open-cockpit}

1. Klicken Sie in der Seitenleiste der ctrlX-Weboberfläche auf **LumiScan Cockpit**.

   Die Anwendungsübersicht listet die verfügbaren Bilder auf, gruppiert nach der Anwendung, die sie veröffentlicht. Bei LumiScan Cam Driver ist jedes Kameramodul ein Eintrag mit dem Namen des Moduls.

   ![Übersicht von LumiScan Cockpit mit den Einträgen lumiscan-cam-driver camera 1 und lumiscan-ai-object-matching example](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/howto-overlays-overview.png)

   *Abbildung 1. Anwendungsübersicht von LumiScan Cockpit*

2. Klicken Sie auf den Namen des Bildes. Es öffnet sich in einem neuen Browser-Tab.

Merken Sie sich die beiden Namen: die Anwendung (`lumiscan-cam-driver`) und das Bild (im Beispiel `camera 1`). Zusammen bilden sie den Schlüssel des Overlays.

## Schritt 3 - Die Einstellungsdatei des Cockpits öffnen {#step-3-open-settings}

1. Gehen Sie in der ctrlX-Weboberfläche zu **Home > Manage app data** und klicken Sie auf **Open file view**.

2. Öffnen Sie den Ordner `lumiscan-cockpit`.

3. Klicken Sie auf `lumiscan-cockpit.json`. Die Datei öffnet sich rechts im Editor.

   Der Editor prüft die Datei gegen ihr Schema und markiert Fehler.

   ![Dateiansicht des Ordners lumiscan-cockpit mit geöffneter lumiscan-cockpit.json im Editor](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/howto-overlays-settings-file.png)

   *Abbildung 2. Einstellungsdatei des Cockpits in der Dateiansicht der ctrlX-Weboberfläche*

## Schritt 4 - Ein Overlay hinzufügen {#step-4-add-overlay}

Fügen Sie unter `overlay` einen Eintrag für Ihr Bild hinzu, mit einem Element je Form. Dieses Beispiel zeichnet ein grünes Kreuz von 30 Pixel Breite in die Bildmitte:

```json
{
  "$schema": "schemas/lumiscan-cockpit.schema.json",
  "overlay": {
    "lumiscan-cam-driver/camera 1": [
      {
        "color": "green",
        "shape": "cross",
        "centerX": 0.5,
        "centerY": 0.5,
        "width": 30,
        "height": 30
      }
    ]
  }
}
```

Jedes Element hat diese Eigenschaften:

- **`color`:** Eine benannte Farbe (`red`, `green`, `blue`, `black`, `white`, `yellow`, `cyan`, `magenta`) oder sechs Hex-Ziffern, `#RRGGBB`. Eine nicht lesbare Farbe wird weiß gezeichnet.
- **`shape`:** `rectangle`, `circle` oder `cross`.
- **`centerX`, `centerY`:** Der Mittelpunkt der Form.
- **`width`, `height`:** Die Größe der Form. Bei einem Kreis ist `width` der Durchmesser.

Position und Größe folgen einer Regel: Werte **unter** `1.0` sind relativ zum Bild (`0.5` ist die Mitte), Werte ab `1.0` sind Pixel. Das Kreuz oben sitzt also in der Mitte jedes Bildes, unabhängig von der Auflösung, und ist 30 Pixel breit.

Um auf mehrere Bilder zugleich zu zeichnen, verwenden Sie `*` im Schlüssel:

- `lumiscan-cam-driver/*` - jedes Bild von LumiScan Cam Driver
- `*/resultImage` - das Bild `resultImage` jeder Anwendung
- `/` - jedes Bild

Ein Bild, auf das mehrere Schlüssel passen, zeigt die Overlays aller dieser Schlüssel.

## Schritt 5 - Speichern und das Cockpit neu starten {#step-5-save-restart}

1. Prüfen Sie, dass der Editor keine Fehler markiert, und klicken Sie auf **Save**.
2. Wählen Sie unter **Settings > Apps** **LumiScan Cockpit** aus und klicken Sie auf **Restart**.
3. Öffnen Sie das Bild im Cockpit erneut, wie in Schritt 2.

Erwartet: Das Bild zeigt ein grünes Kreuz in der Mitte.

![Kamerabild eines ringförmigen Teils in LumiScan Cockpit mit kleinem grünem Kreuz in der Bildmitte](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/howto-overlays-cross.jpg)

*Abbildung 3. Kamerabild im Cockpit mit grünem Kreuz in der Mitte*

## Beispiel: mehrere Overlays auf allen Kamerabildern {#example-several-overlays}

Diese Konfiguration zeichnet auf jedes Bild von LumiScan Cam Driver ein Mittelkreuz, drei konzentrische Kreise als Zielmarke zum Ausrichten und zwei Rechtecke, die Regionen von Interesse markieren. Die Kreise haben `height` `0`, da nur die Breite (der Durchmesser) verwendet wird. Die Rechtecke verwenden Pixelkoordinaten.

```json
{
  "$schema": "schemas/lumiscan-cockpit.schema.json",
  "overlay": {
    "lumiscan-cam-driver/*": [
      { "color": "green", "shape": "cross", "centerX": 0.5, "centerY": 0.5, "width": 30, "height": 30 },
      { "color": "red", "shape": "circle", "centerX": 0.5, "centerY": 0.5, "width": 100, "height": 0 },
      { "color": "yellow", "shape": "circle", "centerX": 0.5, "centerY": 0.5, "width": 150, "height": 0 },
      { "color": "green", "shape": "circle", "centerX": 0.5, "centerY": 0.5, "width": 200, "height": 0 },
      { "color": "#c8b100", "shape": "rectangle", "centerX": 400, "centerY": 400, "width": 250, "height": 200 },
      { "color": "#c8b100", "shape": "rectangle", "centerX": 400, "centerY": 800, "width": 250, "height": 200 }
    ]
  }
}
```

![Kamerabild in LumiScan Cockpit mit Mittelkreuz](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/howto-overlays-multiple.jpg)

*Abbildung 4. Kamerabild mit mehreren Overlays*

## Ergebnis {#result}

- LumiScan Cockpit zeigt die Bilder von LumiScan Cam Driver mit Ihren Overlays.
- Die Markierungen bleiben auf jedem neuen Bild an der konfigurierten Position.
- Um sie zu ändern, bearbeiten Sie `lumiscan-cockpit.json` und starten das Cockpit neu.

> [!WARNING]
> `1.0` ist nicht der ferne Bildrand, sondern ein Pixel. Um eine Form relativ nahe am rechten oder unteren Rand zu platzieren, verwenden Sie einen Wert knapp unter `1.0`, zum Beispiel `0.99`.

Erscheint ein Overlay nicht, vergleichen Sie den Schlüssel mit den Namen in der Anwendungsübersicht und lesen Sie [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html).

# Das Cockpit öffnen – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/opening-the-cockpit.html

Wie das Cockpit geöffnet wird, hängt davon ab, wo es läuft: Auf ctrlX OS wird es aus der ctrlX-Weboberfläche geöffnet, auf einem PC öffnet es ein eigenes Fenster.

## Auf ctrlX OS

Auf dem Gerät hat das Cockpit kein eigenes Fenster. Es wird aus der ctrlX-Weboberfläche geöffnet, über den Link, den die Anwendung der Seitenleiste hinzufügt, wenn sie installiert ist und läuft.

1. Öffnen Sie die Weboberfläche der ctrlX CORE in einem Browser.
2. Klicken Sie in der Seitenleiste auf **LumiScan Cockpit**.

Der Link öffnet die Adresse `/ctrlx-hdvisionsystems-cockpit/` der ctrlX-Weboberfläche; ctrlX reicht sie an das Cockpit weiter.

## Auf einem PC (LumiScan Keryx)

Auf einem PC läuft das Cockpit mit LumiScan Keryx, zusammen mit den Anwendungen, die es zeigt. Es öffnet seine Seiten in einem eigenen Fenster und liefert sie selbst aus, nur auf `127.0.0.1`.

1. Starten Sie die Anwendungen und das Cockpit. Es muss vorher kein Broker gestartet werden: Die erste von ihnen, die keinen findet, startet den LumiScan-Keryx-Broker unter der Standardadresse `tcp://127.0.0.1:5555`, und der Broker läuft weiter, wenn sie enden (siehe [LumiScan Keryx auf einem PC](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html#broker)).
   ```
   lumiscan-cam-driver
   lumiscan-cockpit
   ```
2. Das Fenster **LumiScan Cockpit** öffnet sich. Wird das Cockpit erneut gestartet, während es läuft, holt das dieses Fenster in den Vordergrund, statt ein zweites zu öffnen.

Das Schließen des Fensters beendet das Cockpit; der Broker und die Anwendungen laufen weiter.

Zu Broker, Port, Fenster und Log siehe [Broker, Fenster und Seiten (PC)](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/opening-the-cockpit.html#windows).

## Die Anwendungsübersicht

Die Seite, die sich öffnet, ist die **Anwendungsübersicht**: alle kompatiblen Anwendungen von HD Vision Systems, die gerade auf dem System laufen, und die Ansichten, die jede von ihnen bietet. So sehen Sie, was verfügbar und aktiv ist, bevor Sie etwas öffnen.

**Auf ctrlX OS:** Ein Klick auf eine Ansicht öffnet sie in einem neuen Browser-Tab, der sich dann selbst aktuell hält, solange er der sichtbare Tab ist.

**Auf einem PC:** Ein Klick auf eine Ansicht öffnet sie im selben Fenster, das sie dann aktuell hält. Die Leiste oben im Fenster geht zurück (**←**) und vorwärts (**→**) durch die darin geöffneten Seiten und zur Übersicht (**⌂**).

## Wenn eine Ansicht nichts zu zeigen hat

Eine Ansicht nennt den Grund, statt einen leeren Frame zu zeigen. Die Gründe und was zu tun ist, sind unter [Fehlerbehebung: Eine Ansicht zeigt eine Meldung statt eines Bildes](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-view-nothing-to-show) und [Fehlerbehebung: Funde werden nicht gezeichnet](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-findings-not-drawn) beschrieben.

## Broker, Fenster und Seiten (PC) {#windows}

Dieser Abschnitt gilt für das Cockpit auf einem PC mit LumiScan Keryx.

Der Broker, den die Anwendungen starten, ist der von **LumiScan Keryx**, wenn es installiert ist; er bringt auch die Data-Layer-Seite `http://127.0.0.1:7555/` hoch, auf der Sie den Baum ansehen können. Andernfalls ist es das `krxsystem` neben den Anwendungen. Antwortet der Broker nicht mehr, laufen die Anwendungen weiter und starten ihn erneut.

Das Cockpit und die Anwendungen müssen dieselbe Adresse verwenden. Ohne Optionen tun sie das alle; eine mit `--keryx-url` übergebene Adresse muss jeder von ihnen übergeben werden. In zwei Fällen wird kein Broker gestartet; starten Sie dann zuerst selbst `krxsystem --backend hdv --url <address>`:

- bei einer `ipc://`-Adresse relativ zu dem Ordner, in dem gestartet wird (`ipc://x`); starten Sie den Broker und jede Anwendung aus demselben Ordner;
- bei `--no-keryx-autostart` oder der Umgebungsvariablen `LUMISCAN_KERYX_AUTOSTART=0`.

Siehe auch [Optionen und Umgebungsvariablen](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html#options).

Das Cockpit liefert seine Seiten auf Port 8000 aus. Ist dieser Port belegt, durch ein anderes Programm oder durch ein mit `--no-gui` gestartetes Cockpit, meldet das Cockpit dies in einer Nachricht und beendet sich; `--port` wählt einen anderen Port.

(Windows) Das Fenster des Cockpits zeigt seine Seiten mit der Microsoft Edge WebView2 Runtime. Ohne die Runtime öffnet das Cockpit sie stattdessen im Standardbrowser und zeigt eine Meldung; ein Klick auf **OK** dort beendet das Cockpit.

`--no-gui` öffnet kein Fenster: Das Cockpit liefert seine Seiten für einen Browser auf demselben PC aus, unter `http://127.0.0.1:8000/lumiscan-cockpit/` (`http://127.0.0.1:8000/` führt ebenfalls dorthin). Eine Ansicht öffnet sich dann in einem neuen Browser-Tab.

(Windows) Aus einer Konsole als `lumiscan-cockpit` gestartet, ohne `.exe`, behält das Cockpit diese Konsole, bis es endet, schreibt sein Log dorthin und endet mit Strg+C, mit seinem Fenster oder mit `--no-gui`. Der Name startet `lumiscan-cockpit.com`, das `lumiscan-cockpit.exe` startet und darauf wartet; direkt gestartet gibt `lumiscan-cockpit.exe` die Konsole sofort zurück.

(Windows) Das Cockpit schreibt sein Log immer nach `%LOCALAPPDATA%\LumiScan Cockpit\logs\lumiscan-cockpit.log`.

Das Cockpit sucht seine Seiten in einem Ordner `www` neben seinem Programm oder in dem Ordner, den `--frontend` nennt. Ohne sie liefert es nur seine API aus und sagt das in seinem Log.

## Mit einem Beispiel beginnen (PC) {#generate-settings}

Auf einem PC schreibt das Cockpit ein Beispiel seiner Einstellungen in einen Ordner Ihrer Wahl und beendet sich, ohne zu starten. Zum Beispiel (Windows):

```shell
lumiscan-cockpit --generate-settings C:\work\cockpit-settings
```

Ohne Ordner (`-g` allein) schreibt es in den aktuellen Ordner. Das Beispiel ist die Einstellungsdatei `lumiscan-cockpit.json` - das Overlay, das auf die Ansichten gezeichnet wird, und die Grenzen der Live-Ansicht - und ihr Schema, `schemas\lumiscan-cockpit.schema.json`. Vorhandene Dateien werden nie überschrieben: Liegt eine von ihnen bereits im Ordner, wird nichts geschrieben, und das Cockpit nennt, welche.

Das Cockpit nennt dann den Ordner, aus dem es seine Einstellungen liest. Unter Windows ist das `%APP_RESOURCE_DIR%\etc\lumiscan-cockpit`, wenn die Umgebungsvariable `APP_RESOURCE_DIR` gesetzt ist, andernfalls `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-cockpit\etc\lumiscan-cockpit`. Bearbeiten Sie das Beispiel, kopieren Sie es dorthin und starten Sie das Cockpit.

# Ergebnisse ansehen – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html

Bei acht Anwendungen werden die Funde in Grün auf das Bild gezeichnet, in dem sie gefunden wurden, und bei AI Object Matching werden die Boxen auf die Live-Frames einer Kamera gezeichnet (siehe [AI Object Matching auf einem Kamera-Stream](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html#ai-on-a-stream)):

| Anwendung | Gezeichnet wird | Beschriftet mit |
| --- | --- | --- |
| `lumiscan-template-finder` | ein Rechteck im Winkel, in dem der Treffer gefunden wurde | dem Namen der Vorlage und dem Score |
| `lumiscan-object-finder` | ein Rechteck um das Objekt | der ID des Objekts und dem Score |
| `lumiscan-text-reader` | ein Rechteck um jedes Wort | dem Wort selbst und dem Score |
| `lumiscan-area-detector` | jede Region eingefärbt, eine Farbe pro Region | der Nummer der Region und ihrer Fläche, als `<label>:<area>` |
| `lumiscan-dmc-reader` | ein Rechteck um jeden Code | dem dekodierten Text und dem Score |
| `lumiscan-qr-code-reader` | ein Rechteck um jeden Code | dem dekodierten Text und dem Score |
| `lumiscan-aztec-code-reader` | ein Rechteck um jeden Code | dem dekodierten Text und dem Score |
| `lumiscan-barcode-reader` | ein Rechteck um jeden Code | dem dekodierten Text und dem Score |

Ein Code, der gefunden, aber nicht dekodiert wurde, hat keinen Text und wird nur mit seinem Score beschriftet.

## Wie eine Ansicht benannt ist

Eine Anwendung mit Modulen wird nach Modulen aufgeführt, und jedes Modul ist eine Ansicht.

Ein Code Reader hat keine Module - es gibt einen Reader pro Anwendung -, er hat also eine einzige Ansicht, benannt nach dem Code, den er liest: `datamatrix-code`, `qr-code`, `aztec-code` oder `bar-code`.

## Wie die Ansichten aussehen

### Template Finder

![Template Finder](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/template-finder.png)

### Object Finder

![Object Finder](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/object-finder.png)

### Text Reader

![Text Reader](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/text-reader.png)

### Area Detector

![Area Detector](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/areadetect.png)

### DMC Reader

![DMC Reader](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/datamatrix-code.png)

### QR Code Reader

![QR Code Reader](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/qrcode.png)

### Aztec Code Reader

![Aztec Code Reader](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/aztec-code.png)

### Barcode Reader

![Barcode Reader](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/barcode.png)

## Der Area Detector wird anders gezeichnet

Ein Rechteck kann nicht zeigen, ob zwei sich berührende Teile getrennt oder zusammengefasst wurden: Überlappende Boxen sehen in beiden Fällen gleich aus. Die Regionen des Area Detector werden stattdessen eingefärbt, eine Farbe pro Region, über dem darunterliegenden Bild, sodass das Teil durch die Färbung hindurch sichtbar bleibt.

Die Zahl vor der Fläche ist die Nummer der Region in `output/blob-labels`; sie bestimmt auch die Farbe der Region. So lässt sich eine Fläche auf dem Bildschirm zu den Pixeln zurückverfolgen, aus denen sie gemessen wurde.

## AI Object Matching auf einem Kamera-Stream {#ai-on-a-stream}

Während ein Modul von AI Object Matching auf dem Bild-Stream einer Kamera inferiert (sein `control/subscribe/output/stream/active` ist `true`), ist die Ansicht des Moduls live: Sie zeigt die Frames der Kamera mit den Boxen des letzten Ergebnisses des Moduls, in Grün, jede beschriftet mit ihrem Klassennamen und Score. Eine Klasse, die die Klassennamen des Moduls nicht abdecken, wird mit ihrer Nummer beschriftet. Siehe [Live-Ansicht](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html#live-view).

Die Ansicht zeigt die eine Quelle des Moduls, den Stream, den seine `setting/stream/address` nennt. Ein Ergebnis, das nicht von der Kamera der Quelle stammt (seine Herkunft nennt eine andere Kamera), wird nicht auf den Frame dieser Kamera gezeichnet. Abonniert das Modul einen anderen Stream, folgt die Ansicht ihm innerhalb von etwa einer Sekunde.

> [!NOTE]
> Die Boxen werden auf **genau den Frame** gezeichnet, in dem das Ergebnis gefunden wurde: Die Herkunft des Ergebnisses nennt ihn, und das Cockpit behält die letzten Frames der Kamera (64 MB), um ihn zu finden. Die Ansicht zeigt daher mit jedem Ergebnis ein neues Bild, nicht mit jedem Frame. Wird der Frame nicht mehr vorgehalten - das Modul hat länger als das für die Inferenz gebraucht -, werden die Boxen stattdessen auf den neuesten Frame gezeichnet, und der Hinweis **approximate** zeigt das an: Während sich die Szene bewegt, kann eine Box dann etwas versetzt sein.

Während das Modul nicht streamt, zeigt seine Ansicht wie bisher sein letztes Ergebnisbild.

## Was nicht gezeigt wird

LumiScan Calibration erzeugt Koordinaten, kein Bild, daher zeigt das Cockpit sie nicht.

# Der Ansichtsbereich – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/the-view-region.html

Keine der acht Anwendungen, die Funde zeichnen, veröffentlicht ein eigenes Bild - jede liest eines von einer anderen Anwendung. Das Cockpit folgt daher der `input-image-address` des Moduls, um das Bild zu finden, zu dem die Funde gehören. Ist diese nicht gesetzt, meldet die Ansicht das, statt einen leeren Frame zu zeigen; richten Sie das Modul zuerst auf den Bildknoten einer Kamera.

## Die Ansicht ist der durchsuchte Bereich

Wo ein Modul nur einen Teil des Bildes durchsucht, sehen Sie diesen Teil, in seiner eigenen Größe, mit den Funden darauf - genau das, was der Detektor bekommen hat. Ein Modul ohne konfigurierten Ausschnitt durchsucht das ganze Bild, seine Ansicht ist also der ganze Frame.

Das gilt für die vier Anwendungen mit Modulen. Ein Code Reader meldet nichts als die Codes, die er gefunden hat, seine Ansicht ist also immer das ganze Bild, das er gelesen hat.

Der Bereich stammt aus **dem Ergebnis selbst**, nicht aus den Ausschnitt-Einstellungen des Moduls. Wird der Ausschnitt nach einem Lauf bearbeitet, verschiebt sich das Bild also nicht unter den noch angezeigten Funden. Die Ansicht zeigt weiterhin, woraus dieses Ergebnis stammt, bis der nächste Lauf es ersetzt.

## Wenn die Bildgröße nicht mehr passt

Wurde das letzte Ergebnis in einem Kamerabild mit einer **anderen Größe** als dem jetzt angezeigten gefunden, werden die Funde nicht gezeichnet, und ein Hinweis nennt die Größe, zu der das Ergebnis gehört. Was zu tun ist, steht unter [Fehlerbehebung: Funde werden nicht gezeichnet](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-findings-not-drawn).

# Live-Aktualisierung – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html

Eine Ansicht hält sich selbst aktuell, auf eine von zwei Arten:

- **Einzelbilder** - solange die Anwendung hinter der Ansicht ein Bild nach dem anderen aufnimmt, teilt das Cockpit dem Browser mit, wenn sich das Bild geändert hat, und der Browser holt das neue.
- **Live-Ansicht** - solange eine Kamera ihre Bilder streamt, zeigt die Ansicht den Stream selbst: Frame für Frame, sobald sie eintreffen, markiert mit **LIVE** neben dem Namen der Ansicht.

Die Ansicht wechselt von selbst zwischen beiden. Sie wählen nicht.

## Einzelbilder

Solange eine Ansicht offen ist, beobachtet das Cockpit die Anwendung dahinter und teilt dem Browser mit, wenn sich das Bild geändert hat; der Browser holt dann den neuen Frame.

Das Cockpit schaut etwa **fünfmal pro Sekunde** nach und meldet sich **höchstens zweimal pro Sekunde**; das begrenzt, was eine schnell taktende Station kostet. Dabei geht nichts verloren, weil der Browser immer den neuesten Frame holt und nicht eine Warteschlange alter Frames.

Eine Ansicht, die nicht sichtbar ist, fragt nicht mehr nach; Tabs im Hintergrund kosten also nichts.

## Live-Ansicht {#live-view}

Eine Ansicht wird live, wenn die Kamera dahinter streamt: wenn `control/publish/execute` von LumiScan Cam Driver den Stream für diese Kamera gestartet hat (siehe das Handbuch des Cam Driver, „Bilder streamen"). Die Ansicht eines Moduls von AI Object Matching wird live, wenn das Modul auf Kamera-Streams inferiert; sie zeigt dann die Frames der Kamera, von der sein letztes Ergebnis stammt, mit den Boxen des Moduls darauf (siehe [Ergebnisse ansehen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html#ai-on-a-stream)).

- Die Frames werden als JPEG gesendet, höchstens mit der **Bildrate**, die in den Einstellungen der Live-Ansicht festgelegt ist, mit den Overlays darauf.
- Treffen Frames schneller ein, wird der neueste gezeigt und die anderen werden übersprungen: Eine Ansicht hinkt der Kamera nie hinterher.
- Stoppt der Stream, kehrt die Ansicht innerhalb von etwa einer Sekunde zu Einzelbildern zurück und zeigt das letzte Bild, das die Kamera veröffentlicht hat.

Das Cockpit empfängt den Stream einer Kamera nur, solange eine Live-Ansicht davon offen ist, und kodiert jeden Frame einmal, egal wie viele Tabs oder Fenster dieselbe Ansicht zeigen. Wenn der letzte davon schließt oder die Ansicht verlässt, endet das etwa zehn Sekunden später; ein Neuladen dazwischen startet es nicht neu.

## Einstellungen der Live-Ansicht {#settings}

Das Zahnrad (⚙) oben auf jeder Seite öffnet die Einstellungen der Live-Ansicht:

| Einstellung | Bereich | Standard | Was sie bewirkt |
| --- | --- | --- | --- |
| Frames per second, at most | 1 bis 30 | 10 | Wie oft jede Live-Ansicht kodiert und gesendet wird. Niedrigere Werte sparen Prozessorzeit auf dem Gerät (Steuerung oder PC) und Netzwerkbandbreite. |
| JPEG quality | 50 bis 95 | 85 | Wie scharf jeder Frame ist. Niedrigere Werte ergeben kleinere Frames. |

**Save** übernimmt die Einstellungen sofort für den nächsten Frame jeder Live-Ansicht, wo auch immer sie offen ist. Sie werden in der Einstellungsdatei des Cockpits (Abschnitt `liveView`) gespeichert und überstehen einen Neustart.

## Wenn Live oder Streaming nicht verfügbar ist

**Acht Ansichten können gleichzeitig streamen** - Einzelbilder oder live. Darüber hinaus fällt eine Ansicht darauf zurück, ihr Bild alle zwei Sekunden neu zu holen. Derselbe Rückfall gilt, wenn die Verbindung über einen Proxy kein Streaming erlaubt.

**Vier Live-Ansichten können gleichzeitig offen sein**, jeden Tab und jedes Fenster mitgezählt. Darüber hinaus zeigt eine Live-Ansicht stattdessen Einzelbilder und versucht es alle fünf Sekunden erneut.

Das Bild bleibt in beiden Fällen korrekt - es kommt nur später an.

# Overlays – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/overlays.html

Ein **Overlay** ist eine feste Form, die das Cockpit über ein Bild zeichnet - eine Region von Interesse, eine Ausrichtmarke, eine Grenze, an der der Bediener ein Teil beurteilen soll. Es wird auf Einzelbilder und auf die Frames einer Live-Ansicht gleichermaßen gezeichnet. Anders als die Funde in [Ergebnisse ansehen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html) stammt ein Overlay von Ihnen und nicht von einer Anwendung, und es ändert sich nicht von Frame zu Frame.

Overlays werden in einer JSON-Datei konfiguriert, der Einstellungsdatei des Cockpits:

**Auf ctrlX OS:** Die Datei ist über die Dateiansicht auf dem ctrlX-Startbildschirm erreichbar.

**Auf einem PC:** Die Datei ist `lumiscan-cockpit.json` in dem Ordner, aus dem das Cockpit seine Einstellungen liest. Unter Windows ist das `%APP_RESOURCE_DIR%\etc\lumiscan-cockpit`, wenn die Umgebungsvariable `APP_RESOURCE_DIR` gesetzt ist, andernfalls `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-cockpit\etc\lumiscan-cockpit`. Öffnen Sie sie in einem beliebigen Texteditor, am besten in einem, der JSON gegen das Schema im Ordner `schemas` prüft. Das Cockpit schreibt auf Wunsch ein Beispiel der Datei, siehe [Mit einem Beispiel beginnen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/opening-the-cockpit.html#generate-settings).

> [!IMPORTANT]
> Die Datei wird **einmal, beim Start** gelesen. Sie zu bearbeiten ändert ein laufendes Cockpit nicht - starten Sie die Anwendung neu, damit ein geändertes Overlay übernommen wird. Dieselbe Datei enthält die Einstellungen der Live-Ansicht (`liveView`), die das Einstellungsfenster sofort ändert - siehe [Einstellungen der Live-Ansicht](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html#settings).

## Wählen, wofür ein Overlay gilt

Jedes Overlay ist nach der Anwendung und dem Bild, zu dem es gehört, in der Form `appName/imageName` benannt.

Jede der beiden Hälften kann der Platzhalter `*` sein, der auf jeden Wert passt:

| Schlüssel | Gilt für |
| --- | --- |
| `lumiscan-cam-driver/resultImage` | dieses eine Bild dieser einen Anwendung |
| `*/resultImage` | das Ergebnisbild **jeder** Anwendung |
| `lumiscan-cam-driver/*` | **jedes** Bild, das diese Anwendung veröffentlicht |

## Eine Form definieren

Jedes Overlay-Element ist eine Form mit diesen Eigenschaften:

- **Color:** Die Farbe der Form. Entweder eine benannte Farbe - `red`, `green`, `blue`, `black`, `white`, `yellow`, `cyan`, `magenta` - oder sechs Hexadezimalziffern, `RRGGBB`, wobei das weggelassen werden darf. Eine Farbe, die nicht gelesen werden kann, wird **weiß** gezeichnet statt abgelehnt; ein Tippfehler zeigt sich also als weiße Form.
- **Shape:** Die Art der zu zeichnenden Form: `rectangle`, `circle` oder `cross`.
- **Center position (`centerX`, `centerY`):** Die Position des Mittelpunkts der Form auf dem Bild.
- **Width und height:** Die Größe der Form. Bei Kreisen wird die Breite als Durchmesser verwendet.

### Relative und absolute Koordinaten

Position und Größe folgen einer gemeinsamen Regel, die erlaubt, ein Overlay auf beide Arten zu schreiben:

- Werte **unter** `1.0` sind **relativ** zu den Bildabmessungen - `0.0` ist der linke oder obere Rand, `0.5` die Mitte, `0.99` fast der gegenüberliegende Rand.
- Werte von `1.0` **und darüber** sind **absolute Pixel**-Koordinaten.

Ein relatives Overlay behält seinen Platz, wenn sich die Kameraauflösung ändert; ein absolutes bleibt auf denselben Pixeln.

> [!WARNING]
> `1.0` ist **nicht** der gegenüberliegende Rand - es ist ein Pixel. Die Regel wird entschieden, bevor etwas gezeichnet wird, und sie hängt davon ab, ob die Zahl unter `1.0` liegt; `1.0` fällt also auf die absolute Seite. Um etwas relativ am gegenüberliegenden Rand zu platzieren, verwenden Sie einen Wert knapp unter `1.0`.
>
> Dieselbe Falle gilt für die Größe: Eine `width` von `1.0` ist eine ein Pixel breite Form, nicht eine über die volle Breite.

## Beispiel

Diese Konfiguration fügt ein grünes Rechteck in der Bildmitte hinzu und einen roten Kreis, der einen bestimmten Bereich hervorhebt:

```json
{
  "overlay": {
    "lumiscan-cam-driver/resultImage": [
      {
        "color": "green",
        "shape": "rectangle",
        "centerX": 0.5,
        "centerY": 0.5,
        "width": 0.4,
        "height": 0.3
      },
      {
        "color": "red",
        "shape": "circle",
        "centerX": 75,
        "centerY": 25,
        "width": 100,
        "height": 100
      }
    ]
  }
}
```

Das grüne Rechteck wird mit relativen Koordinaten in der Bildmitte zentriert - 50 % von links, 50 % von oben, vier Zehntel der Breite und drei Zehntel der Höhe. Der rote Kreis verwendet absolute Pixelkoordinaten: Sein Mittelpunkt liegt 75 Pixel vom linken Rand und 25 Pixel vom oberen Rand entfernt, und er ist 100 Pixel groß.

## Vollständige Referenz {#complete-reference}

Alle Einstellungen dieser Datei, wie sie ihr JSON-Schema `lumiscan-cockpit.schema.json` festlegt, erzeugt für Version 1.2.0 (Beschreibungen aus dem Schema, auf Englisch):

| Einstellung | Typ | Standard | Zulässige Werte | Beschreibung |
| --- | --- | --- | --- | --- |
| `overlay` | object |   |   | **Pflichtangabe.** Overlay settings for image annotations |
| `overlay/<Name>` | object[] |   |   | Array of overlay elements to be drawn on the image. The name of this should follow the format appName/imageName it is possible to use a \* as a wildcard for either part |
| `overlay/<Name>[]/color` | string |   | Muster `^(red\|green\|blue\|black\|white\|yellow\|cyan\|magenta\|#?[0-9A-Fa-f]{6})$` | **Pflichtangabe.** Color of the overlay element. Can be a named color (red, green, blue, black, white, yellow, cyan, magenta) or hex format (#RRGGBB or RRGGBB) |
| `overlay/<Name>[]/shape` | string |   | `rectangle`, `circle`, `cross` | **Pflichtangabe.** Shape type of the overlay element |
| `overlay/<Name>[]/centerX` | number |   |   | **Pflichtangabe.** X-coordinate of the shape center. Values < 1.0 are relative to image width (0.0-1.0), values >= 1.0 are absolute pixel coordinates |
| `overlay/<Name>[]/centerY` | number |   |   | **Pflichtangabe.** Y-coordinate of the shape center. Values < 1.0 are relative to image height (0.0-1.0), values >= 1.0 are absolute pixel coordinates |
| `overlay/<Name>[]/width` | number |   |   | **Pflichtangabe.** Width of the shape. Values < 1.0 are relative to image width (0.0-1.0), values >= 1.0 are absolute pixel values. For circles, this is the diameter |
| `overlay/<Name>[]/height` | number |   |   | **Pflichtangabe.** Height of the shape. Values < 1.0 are relative to image height (0.0-1.0), values >= 1.0 are absolute pixel values |

## JSON-Schemas {#json-schemas}

Die Anwendung legt die JSON-Schemas ihrer Einstellungsdateien in ihrem Ordner `schemas` ab; diese Kopien passen immer zur installierten Version. Die Schemas von LumiScan Cockpit 1.2.0 stehen außerdem zum Download bereit: [JSON-Schemas von LumiScan Cockpit 1.2.0](https://docs.hdvisionsystems.com/schemas/lumiscan-cockpit/1.2.0/index.html).

Damit ein Editor wie Visual Studio Code eine Kopie einer Einstellungsdatei prüft, die Sie auf Ihrem PC bearbeiten, lassen Sie deren Eintrag `$schema` auf das veröffentlichte Schema zeigen:

```json
{
  "$schema": "https://docs.hdvisionsystems.com/schemas/lumiscan-cockpit/1.2.0/lumiscan-cockpit.schema.json",
  ...
}
```

Lassen Sie den Eintrag `$schema` der Dateien auf dem Gerät so, wie die Anwendung ihn geschrieben hat.

# FAQ – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/faq.html

Kurze Antworten auf häufige Fragen zu LumiScan Cockpit. Jeder Eintrag verweist auf die Seite mit den Details. Probleme und Fehlermeldungen sind unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html) beschrieben.

> [!TIP]
> Jeder Eintrag hat einen festen Anker (zum Beispiel `#faq-open-cockpit`). Um eine Fehlermeldung zu finden, durchsuchen Sie die Seite [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html) danach.

## Erste Schritte

### Was macht LumiScan Cockpit? {#faq-what-is-cockpit}

- **Antwort:** Das Cockpit zeigt, was die Vision-Anwendungen auf einer ctrlX CORE, einem ctrlX IPC oder einem PC gerade sehen und was sie gefunden haben: auf ctrlX OS in einem Webbrowser, auf einem PC in einem eigenen Fenster. Es ist nur ein Viewer: Es zeigt die Bilder, die LumiScan Cam Driver und LumiScan AI Object Matching veröffentlichen, und zeichnet die Funde von acht weiteren Anwendungen auf das Bild, in dem sie gefunden wurden. Es konfiguriert nichts in diesen Anwendungen.
- **Mehr:** [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/description.html)

### Was brauche ich, um das Cockpit zu verwenden? {#faq-requirements}

- **Antwort:** Die Anwendungen, deren Bilder und Ergebnisse das Cockpit zeigt, müssen auf demselben Gerät laufen - derselben ctrlX CORE, demselben ctrlX IPC oder demselben PC -, weil das Cockpit sie dort vom Data Layer liest (dem ctrlX Data Layer auf ctrlX OS, LumiScan Keryx auf einem PC); für sich allein zeigt es eine leere Übersicht. In der Praxis beginnen Sie mit LumiScan Cam Driver und einer konfigurierten Kamera. Auf ctrlX OS kann jeder Browser, der die ctrlX-Weboberfläche öffnen kann, auch das Cockpit öffnen; auf einem PC öffnet das Cockpit ein eigenes Fenster (unter Windows mit der Microsoft Edge WebView2 Runtime). Das Cockpit speichert nur seine Einstellungsdatei (die optionalen Overlays und die Einstellungen der Live-Ansicht) und behält keine Bilder.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/requirements.html)

### Wie öffne ich das Cockpit? {#faq-open-cockpit}

- **Antwort:** Auf ctrlX OS öffnen Sie die Weboberfläche der ctrlX CORE in einem Browser und klicken in der Seitenleiste auf **LumiScan Cockpit**; die Anwendung fügt diesen Link hinzu, wenn sie installiert ist und läuft. Ein Klick auf eine Ansicht öffnet sie in einem neuen Browser-Tab. Auf einem PC starten Sie die Anwendungen und `lumiscan-cockpit`: Das Fenster **LumiScan Cockpit** öffnet sich, und eine Ansicht öffnet sich im selben Fenster. Die Seite, die sich öffnet, ist die Anwendungsübersicht: alle kompatiblen Anwendungen von HD Vision Systems, die gerade laufen, und die Ansichten, die jede bietet.
- **Mehr:** [Das Cockpit öffnen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/opening-the-cockpit.html)

### Kann eine SPS oder eine andere Anwendung verwenden, was das Cockpit zeichnet? {#faq-programmatic-results}

- **Antwort:** Nein. Das Cockpit stellt keine eigene Ausgabe auf dem Data Layer bereit; die Zeichnung existiert nur im Browser oder im Fenster des Cockpits. Um ein Ergebnis programmatisch zu verarbeiten, lesen Sie die Ergebnisknoten der jeweiligen Anwendung.
- **Mehr:** [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/description.html)

## Ergebnisse ansehen

### Die Ergebnisse welcher Anwendungen werden gezeichnet, und wie? {#faq-supported-apps}

- **Antwort:** Funde werden in Grün auf das Bild gezeichnet, in dem sie gefunden wurden:
  - `lumiscan-template-finder`: ein Rechteck im Winkel des Treffers, beschriftet mit Vorlagenname und Score.
  - `lumiscan-object-finder`: ein Rechteck um das Objekt, beschriftet mit Objekt-ID und Score.
  - `lumiscan-text-reader`: ein Rechteck um jedes Wort, beschriftet mit dem Wort und dem Score.
  - `lumiscan-area-detector`: jede Region in ihrer eigenen Farbe eingefärbt, beschriftet mit `<label>:<area>`.
  - `lumiscan-dmc-reader`, `lumiscan-qr-code-reader`, `lumiscan-aztec-code-reader`, `lumiscan-barcode-reader`: ein Rechteck um jeden Code, beschriftet mit dem dekodierten Text und dem Score. Ein Code, der gefunden, aber nicht dekodiert wurde, wird nur mit seinem Score beschriftet.
  - `lumiscan-ai-object-matching`, solange ein Modul auf einem Kamera-Stream inferiert: die Boxen des Moduls auf den Live-Frames der Kamera, beschriftet mit Klassennamen und Score.
- **Mehr:** [Ergebnisse ansehen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html)

### Wie sind die Ansichten benannt? {#faq-view-names}

- **Antwort:** Eine Anwendung mit Modulen wird nach Modulen aufgeführt, und jedes Modul ist eine Ansicht. Ein Code Reader hat keine Module, er hat also eine einzige Ansicht, benannt nach dem Code, den er liest: `datamatrix-code`, `qr-code`, `aztec-code` oder `bar-code`.
- **Mehr:** [Ergebnisse ansehen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html)

### Was bedeutet die Beschriftung einer Region des Area Detector? {#faq-area-detector-labels}

- **Antwort:** Die Beschriftung hat die Form `<label>:<area>`. Die Zahl vor dem Doppelpunkt ist die Nummer der Region in `output/blob-labels`; sie bestimmt auch die Farbe der Region, sodass sich eine Fläche auf dem Bildschirm zu den Pixeln zurückverfolgen lässt, aus denen sie gemessen wurde. Regionen werden eingefärbt statt umrahmt, weil überlappende Rechtecke nicht zeigen können, ob sich berührende Teile getrennt oder zusammengefasst wurden.
- **Mehr:** [Ergebnisse ansehen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html)

### Warum zeigt eine Ansicht nur einen Teil des Kamerabildes? {#faq-view-shows-region}

- **Antwort:** Bei den vier Anwendungen mit Modulen zeigt eine Ansicht den durchsuchten Bereich in seiner eigenen Größe; ein Modul ohne Ausschnitt durchsucht und zeigt den ganzen Frame. Die Ansicht eines Code Reader ist immer das ganze Bild, das er gelesen hat. Der Bereich stammt aus dem Ergebnis selbst, nicht aus den aktuellen Ausschnitt-Einstellungen; das Bearbeiten des Ausschnitts ändert die Ansicht also erst mit dem nächsten Lauf.
- **Mehr:** [Der Ansichtsbereich](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/the-view-region.html)

## Live-Aktualisierung

### Wie schnell aktualisiert sich eine Ansicht? {#faq-update-rate}

- **Antwort:** Solange eine Ansicht Einzelbilder zeigt, prüft das Cockpit die Anwendung etwa fünfmal pro Sekunde und benachrichtigt den Browser höchstens zweimal pro Sekunde; der Browser holt dann den neuesten Frame, es baut sich also keine Warteschlange von Frames auf. Solange eine Kamera streamt, ist die Ansicht live und zeigt die Frames, sobald sie eintreffen, höchstens mit der Bildrate aus den Einstellungen der Live-Ansicht (Standard 10 pro Sekunde). Eine Ansicht, die nicht sichtbar ist, fragt nicht mehr nach; Tabs im Hintergrund kosten also nichts.
- **Mehr:** [Live-Aktualisierung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html)

### Wie ändere ich die Bildrate oder die Qualität einer Live-Ansicht? {#faq-live-view-settings}

- **Antwort:** Klicken Sie auf das Zahnrad (⚙) oben auf einer beliebigen Seite. **Frames per second, at most** (1 bis 30, Standard 10) und **JPEG quality** (50 bis 95, Standard 85) gelten sofort für jede Live-Ansicht und werden im Abschnitt `liveView` der Einstellungsdatei des Cockpits gespeichert.
- **Mehr:** [Einstellungen der Live-Ansicht](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html#settings)

## Overlays

### Wie zeichne ich eine feste Region von Interesse oder eine Marke auf ein Bild? {#faq-overlay-config}

- **Antwort:** Konfigurieren Sie ein Overlay in der Einstellungsdatei des Cockpits und starten Sie das Cockpit neu. Auf ctrlX OS ist die Datei über die Dateiansicht auf dem ctrlX-Startbildschirm erreichbar; auf einem PC ist sie `lumiscan-cockpit.json` im Einstellungsordner des Cockpits (unter Windows `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-cockpit\etc\lumiscan-cockpit` oder `%APP_RESOURCE_DIR%\etc\lumiscan-cockpit`, wenn `APP_RESOURCE_DIR` gesetzt ist). Auf einem PC schreibt `lumiscan-cockpit --generate-settings <folder>` ein Beispiel.
  - Jedes Overlay ist nach `appName/imageName` benannt; jede der beiden Hälften kann der Platzhalter `*` sein.
  - Jedes Element hat `color` (`red`, `green`, `blue`, `black`, `white`, `yellow`, `cyan`, `magenta` oder `RRGGBB` mit optionalem ), `shape` (`rectangle`, `circle` oder `cross`), `centerX`, `centerY`, `width` und `height`. Bei Kreisen ist `width` der Durchmesser.
- **Mehr:** [Overlays](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/overlays.html)

### Sind Overlay-Positionen relativ oder in Pixeln? {#faq-overlay-coordinates}

- **Antwort:** Beides ist möglich, für Position und Größe gleichermaßen. Werte unter `1.0` sind relativ zu den Bildabmessungen (`0.0` = linker oder oberer Rand, `0.5` = Mitte); Werte von `1.0` und darüber sind absolute Pixel. `1.0` ist also ein Pixel, nicht der gegenüberliegende Rand: Verwenden Sie für den gegenüberliegenden Rand einen Wert knapp unter `1.0`, und beachten Sie, dass eine `width` von `1.0` ein Pixel breit ist.
- **Mehr:** [Overlays](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/overlays.html)

## Fehlerbehebung {#troubleshooting}

Probleme und Fehlermeldungen sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html) beschrieben:

- [Auf ctrlX OS beendet sich das Cockpit kurz nach dem Start](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#ts-shuts-down-after-start)
- [Auf einem PC meldet das Cockpit, dass sein Port belegt ist, und beendet sich](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-port-taken)
- [Unter Windows öffnet sich das Cockpit im Browser statt in seinem eigenen Fenster](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-no-window)
- [Die Übersicht zeigt keine Anwendungen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-overview-empty-pc)
- [Eine Ansicht zeigt eine Meldung statt eines Bildes](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-view-nothing-to-show)
- [Funde werden nicht gezeichnet, und ein Hinweis nennt die Größe, zu der das Ergebnis gehört](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-findings-not-drawn)
- [Eine Ansicht von AI Object Matching auf einem Stream zeigt **approximate**](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-ai-approximate)
- [Eine Ansicht aktualisiert sich nur alle zwei Sekunden](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-view-updates-slowly)
- [Eine Kamera streamt, aber ihre Ansicht zeigt Einzelbilder statt **LIVE**](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-live-view-still)
- [Eine Overlay-Änderung hat keine Wirkung, oder eine Form wird weiß gezeichnet](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-overlay-not-applied)

## Lizenzierung und Support

### Welche Lizenz brauche ich, und was passiert ohne? {#faq-licence}

- **Antwort:** Die ctrlX-Lizenz für LumiScan Cockpit ist `SWL-W-XCx-COCKPITxxxHDVSx-V1NN`. Im ctrlX Store für ctrlX OS gekauft, ist sie eine ctrlX-Lizenz und braucht keinen LumiScan Key. Auf ctrlX OS beendet sich die Anwendung kurz nach dem Start, wenn die Lizenz fehlt; der Grund steht im Systemprotokoll. Für einen PC siehe den Abschnitt Lizenz auf der Seite Voraussetzungen.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/requirements.html#licence), [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html)

### Wo finde ich weitere Antworten oder erhalte Support? {#faq-support}

- **Antwort:** Siehe die übergreifende [LumiScan-FAQ](https://docs.hdvisionsystems.com/de/faq.html). Zum Data Layer auf beiden Plattformen siehe die [Data-Layer-FAQ](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/faq.html). Wenden Sie sich an den Customer Success von HD Vision Systems unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder +49 6221 6721905; für Lizenzen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).
- **Mehr:** [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html)

# Fehlerbehebung – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html

Beginnen Sie mit den [Allgemeine Prüfungen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#general-checks): Sie helfen bei jedem Problem mit LumiScan Cockpit. Suchen Sie dann Ihr Symptom in den folgenden Abschnitten und arbeiten Sie dessen Schritte der Reihe nach ab. Der letzte Abschnitt nennt, was Sie an den Support senden, wenn das Problem weiterhin besteht.

## Allgemeine Prüfungen {#general-checks}

Prüfen Sie zuerst diese Punkte:

- **Die Anwendungen laufen auf demselben Gerät.** Das Cockpit zeigt die Daten anderer Anwendungen an: Die Anwendungen, deren Bilder und Ergebnisse es zeichnet, müssen auf derselben ctrlX CORE, demselben ctrlX IPC oder demselben PC laufen. Für sich allein zeigt das Cockpit eine leere Übersicht. Siehe [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/requirements.html).

- **Die Anwendungsübersicht.** Sie führt alle kompatiblen Anwendungen von HD Vision Systems auf, die gerade laufen, und die Ansichten, die jede von ihnen bietet. Siehe [Das Cockpit öffnen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/opening-the-cockpit.html).

- **Auf einem PC: dieselbe Broker-Adresse.** Das Cockpit und die Anwendungen müssen dieselbe Adresse verwenden. Ohne Optionen tun sie das alle; eine mit `--keryx-url` übergebene Adresse muss jeder von ihnen übergeben werden. Ist LumiScan Keryx installiert, zeigt die Data-Layer-Seite `http://127.0.0.1:7555/` den Baum. Siehe [Broker, Fenster und Seiten (PC)](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/opening-the-cockpit.html#windows).

- **Die Einstellungsdatei wird einmal, beim Start, gelesen.** Nur die Einstellungen der Live-Ansicht, die im Einstellungsfenster geändert werden, gelten sofort. Siehe [Overlays](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/overlays.html).

- **Das Log.**

  | Plattform | Log |
  | --- | --- |
  | ctrlX OS | das Systemprotokoll von ctrlX OS: das Logbuch der ctrlX-Weboberfläche oder `journalctl`. Siehe [ctrlX Data Layer auf ctrlX OS](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/ctrlx-data-layer.html) |
  | Windows | `%LOCALAPPDATA%\LumiScan Cockpit\logs\lumiscan-cockpit.log`. Aus einer Konsole als `lumiscan-cockpit` gestartet, schreibt das Cockpit sein Log auch in diese Konsole |

## Das Cockpit öffnen {#opening-cockpit}

### Problem: Auf ctrlX OS beendet sich das Cockpit kurz nach dem Start {#ts-shuts-down-after-start}

**Symptome**

Auf ctrlX OS beendet sich die Anwendung Cockpit kurz nach dem Start.

**Mögliche Ursachen**

- Die Lizenz fehlt. Die ctrlX-Lizenz für LumiScan Cockpit ist `SWL-W-XCx-COCKPITxxxHDVSx-V1NN`.

**Diagnose**

1. Lesen Sie das Systemprotokoll von ctrlX OS - erwartet: Es nennt den Grund, warum sich die Anwendung beendet hat.
2. Prüfen Sie die Seitenleiste der ctrlX-Weboberfläche - erwartet: der Link **LumiScan Cockpit**. Die Anwendung fügt ihn hinzu, wenn sie installiert ist und läuft.

**Lösung**

- **Wenn die Lizenz fehlt:** Aktivieren Sie die ctrlX-Lizenz `SWL-W-XCx-COCKPITxxxHDVSx-V1NN` auf dem Gerät und starten Sie die Anwendung dann erneut. Siehe [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/requirements.html#licence) und [LumiScan Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/path-ctrlx-os.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit den Zeilen des Systemprotokolls, die den Grund nennen.

### Problem: Auf einem PC meldet das Cockpit, dass sein Port belegt ist, und beendet sich {#faq-port-taken}

**Symptome**

Auf einem PC zeigt das Cockpit eine Meldung, dass sein Port belegt ist, und beendet sich.

**Mögliche Ursachen**

- Das Cockpit liefert seine Seiten auf Port 8000 aus. Ein anderes Programm verwendet diesen Port bereits.
- Ein mit `--no-gui` gestartetes Cockpit verwendet diesen Port bereits.

**Diagnose**

1. Prüfen Sie, ob ein mit `--no-gui` gestartetes Cockpit läuft - erwartet: keines, wenn Sie das Cockpit mit seinem Fenster starten wollen.
2. Prüfen Sie, ob ein anderes Programm Port 8000 verwendet.

**Lösung**

- **Wenn ein anderes Programm oder ein mit `--no-gui` gestartetes Cockpit den Port verwendet:** Beenden Sie es und starten Sie das Cockpit dann erneut.
- **Wenn der Port beim anderen Programm bleiben muss:** Starten Sie das Cockpit mit `--port` und einem anderen Port.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Meldung des Cockpits und den Optionen, mit denen es gestartet wurde.

### Problem: Unter Windows öffnet sich das Cockpit im Browser statt in seinem eigenen Fenster {#faq-no-window}

**Symptome**

Unter Windows öffnet das Cockpit seine Seiten im Standardbrowser statt in seinem eigenen Fenster und zeigt eine Meldung. Ein Klick auf **OK** in der Meldung beendet das Cockpit.

**Mögliche Ursachen**

- Die Microsoft Edge WebView2 Runtime fehlt. Das Fenster des Cockpits zeigt seine Seiten mit ihr.

**Diagnose**

1. Prüfen Sie, ob das Cockpit mit `--no-gui` gestartet wurde - erwartet: nein, wenn Sie sein Fenster wollen. Mit `--no-gui` öffnet das Cockpit bestimmungsgemäß kein Fenster.
2. Prüfen Sie, ob die Microsoft Edge WebView2 Runtime auf dem PC installiert ist.

**Lösung**

- **Wenn die WebView2 Runtime fehlt:** Installieren Sie sie und starten Sie das Cockpit dann erneut. Oder verwenden Sie das Cockpit im Browser.

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Meldung des Cockpits.

### Problem: Die Übersicht zeigt keine Anwendungen {#faq-overview-empty-pc}

**Symptome**

Die Anwendungsübersicht führt keine Anwendungen auf.

**Mögliche Ursachen**

- Die Anwendungen laufen nicht.
- Die Anwendungen laufen nicht auf demselben Gerät wie das Cockpit.
- Auf einem PC: Das Cockpit und die Anwendungen verwenden nicht denselben Broker. Eine mit `--keryx-url` übergebene Adresse wurde nicht jeder von ihnen übergeben.
- Auf einem PC: Es wurde kein Broker gestartet. Das passiert bei einer `ipc://`-Adresse relativ zu dem Ordner, in dem ein Programm gestartet wird, und bei `--no-keryx-autostart` oder `LUMISCAN_KERYX_AUTOSTART=0`.

**Diagnose**

1. Prüfen Sie, ob die Anwendungen auf demselben Gerät wie das Cockpit laufen.
2. Vergleichen Sie auf einem PC die Optionen, mit denen das Cockpit und die Anwendungen gestartet wurden - erwartet: dieselbe `--keryx-url` oder keine.
3. Öffnen Sie auf einem PC mit LumiScan Keryx die Data-Layer-Seite `http://127.0.0.1:7555/` - erwartet: Der Baum zeigt die laufenden Anwendungen.

**Lösung**

- **Wenn die Anwendungen nicht laufen:** Starten Sie sie.
- **Wenn die Anwendungen auf einem anderen Gerät laufen:** Betreiben Sie sie auf demselben Gerät wie das Cockpit.
- **Wenn sie unterschiedliche Broker-Adressen verwenden:** Übergeben Sie jeder Anwendung, auch dem Cockpit, dieselbe `--keryx-url`, oder starten Sie alle ohne die Option.
- **Wenn kein Broker gestartet wurde:** Starten Sie zuerst selbst `krxsystem --backend hdv --url <address>`. Bei einer relativen `ipc://`-Adresse starten Sie den Broker und jede Anwendung aus demselben Ordner.

Siehe auch [Fehlerbehebung Data Layer: der Broker](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#no-broker) und [Fehlerbehebung Data Layer: eine App fehlt](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/troubleshooting.html#app-missing).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit den Optionen, mit denen das Cockpit und die Anwendungen gestartet wurden.

## Ansichten und Ergebnisse {#views-and-results}

### Problem: Eine Ansicht zeigt eine Meldung statt eines Bildes {#faq-view-nothing-to-show}

**Symptome**

Eine Ansicht nennt den Grund, warum sie nichts zu zeigen hat, statt einen leeren Frame zu zeigen.

**Mögliche Ursachen**

- Die Anwendung hat noch kein Bild erzeugt.
- Es ist keine Bildquelle konfiguriert. Die acht Anwendungen, die Funde zeichnen, lesen ihr Bild von anderswo, und das Cockpit folgt der `input-image-address` des Moduls, um es zu finden.
- Das Ergebnis gehört zu einer anderen Bildgröße, siehe [Problem: Funde werden nicht gezeichnet, und ein Hinweis nennt die Größe, zu der das Ergebnis gehört](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-findings-not-drawn).

**Diagnose**

1. Lesen Sie den Grund, den die Ansicht nennt.
2. Bei einer veröffentlichenden Anwendung: Prüfen Sie, ob sie seit ihrem Start gelaufen ist.
3. Bei einer der acht Anwendungen, die Funde zeichnen: Lesen Sie die `input-image-address` des Moduls - erwartet: der Bildknoten einer Kamera.

**Lösung**

- **Wenn die Anwendung noch kein Bild erzeugt hat:** Führen Sie die veröffentlichende Anwendung einmal aus.
- **Wenn keine Bildquelle konfiguriert ist:** Richten Sie das Modul zuerst auf den Bildknoten einer Kamera.
- **Wenn das Ergebnis zu einer anderen Bildgröße gehört:** Siehe [Problem: Funde werden nicht gezeichnet, und ein Hinweis nennt die Größe, zu der das Ergebnis gehört](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#faq-findings-not-drawn).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit dem Grund, den die Ansicht nennt, und der `input-image-address` des Moduls.

### Problem: Funde werden nicht gezeichnet, und ein Hinweis nennt die Größe, zu der das Ergebnis gehört {#faq-findings-not-drawn}

**Symptome**

Die Ansicht zeigt das Bild ohne Funde, und ein Hinweis nennt die Bildgröße, zu der das Ergebnis gehört.

**Mögliche Ursachen**

- Das letzte Ergebnis wurde in einem Kamerabild mit einer anderen Größe als dem angezeigten gefunden, meist weil sich die Kameraauflösung nach dem letzten Lauf geändert hat.

**Diagnose**

1. Vergleichen Sie die Größe im Hinweis mit der aktuellen Kameraauflösung - erwartet: Sie unterscheiden sich.

**Lösung**

- **Wenn sich die Kameraauflösung nach dem letzten Lauf geändert hat:** Führen Sie die Anwendung erneut aus, um das Ergebnis für die neue Auflösung zu erneuern.

Siehe [Der Ansichtsbereich](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/the-view-region.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Größe aus dem Hinweis und der Kameraauflösung.

### Problem: Eine Ansicht von AI Object Matching auf einem Stream zeigt **approximate** {#faq-ai-approximate}

**Symptome**

Die Live-Ansicht eines Moduls von AI Object Matching zeigt den Hinweis **approximate**. Während sich die Szene bewegt, kann eine Box etwas versetzt sein.

**Mögliche Ursachen**

- Das Modul hat für die Inferenz länger gebraucht, als das Cockpit die letzten Frames der Kamera (64 MB) vorhält. Der Frame, in dem das Ergebnis gefunden wurde, wird nicht mehr vorgehalten; die Boxen werden daher auf den neuesten Frame gezeichnet.

**Diagnose**

1. Prüfen Sie, ob das Modul auf dem Bild-Stream einer Kamera inferiert - erwartet: Seine `control/subscribe/output/stream/active` ist `true`. Der Hinweis erscheint nur in einer solchen Live-Ansicht.

**Lösung**

- **Wenn der Frame nicht mehr vorgehalten wird:** Es ist nichts zu tun. Die Boxen werden auf den neuesten Frame gezeichnet und mit **approximate** markiert. Kommt ein Ergebnis rechtzeitig, werden seine Boxen auf genau den Frame gezeichnet, in dem es gefunden wurde.

Siehe [AI Object Matching auf einem Kamera-Stream](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html#ai-on-a-stream).

**Wenn das Problem weiterhin besteht**

Wenden Sie sich mit den unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, wenn etwas versetzte Boxen für Ihre Anwendung ein Problem sind.

## Live-Aktualisierung {#live-updates}

### Problem: Eine Ansicht aktualisiert sich nur alle zwei Sekunden {#faq-view-updates-slowly}

**Symptome**

Eine Ansicht zeigt nur alle zwei Sekunden ein neues Bild.

**Mögliche Ursachen**

- Mehr als acht Ansichten streamen gleichzeitig, Einzelbilder oder live. Darüber hinaus fällt eine Ansicht darauf zurück, ihr Bild alle zwei Sekunden neu zu holen.
- Die Verbindung über einen Proxy erlaubt kein Streaming.

**Diagnose**

1. Zählen Sie die geöffneten Ansichten - erwartet: acht oder weniger.
2. Prüfen Sie, ob der Browser das Cockpit über einen Proxy erreicht.

**Lösung**

- **Wenn mehr als acht Ansichten geöffnet sind:** Schließen Sie Ansichten, die Sie nicht brauchen.
- **Wenn ein Proxy kein Streaming erlaubt:** Die Ansicht holt ihr Bild weiterhin alle zwei Sekunden neu. Das Bild bleibt korrekt; es kommt nur später an.

Siehe [Live-Aktualisierung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Anzahl der geöffneten Ansichten und der Angabe, ob ein Proxy verwendet wird.

### Problem: Eine Kamera streamt, aber ihre Ansicht zeigt Einzelbilder statt **LIVE** {#faq-live-view-still}

**Symptome**

Die Kamera streamt ihre Bilder, aber ihre Ansicht zeigt Einzelbilder, und **LIVE** erscheint nicht neben dem Namen der Ansicht.

**Mögliche Ursachen**

- Mehr als vier Live-Ansichten sind gleichzeitig offen, jeden Tab und jedes Fenster mitgezählt. Darüber hinaus zeigt eine Live-Ansicht Einzelbilder und versucht es alle fünf Sekunden erneut.
- Der Stream wurde nicht mit `control/publish/execute` von LumiScan Cam Driver gestartet. Erst dann wird eine Ansicht live. Die Ansicht eines Moduls von AI Object Matching wird live, wenn das Modul auf Kamera-Streams inferiert.
- Auf ctrlX OS: Die ctrlX-Weboberfläche reicht die Live-Ansicht nicht durch. Ob sie das tut, wurde noch nicht auf einem Gerät geprüft.

**Diagnose**

1. Zählen Sie die Live-Ansichten, die in allen Tabs und Fenstern offen sind - erwartet: vier oder weniger.
2. Lesen Sie an der Kamera `control/publish/output/stream/active` von LumiScan Cam Driver - erwartet: `true`. Siehe [Der Produzent: der Cam Driver](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html#producer).

**Lösung**

- **Wenn mehr als vier Live-Ansichten offen sind:** Schließen Sie Live-Ansichten, die Sie nicht brauchen. Die Ansicht versucht es alle fünf Sekunden erneut.
- **Wenn der Stream nicht gestartet wurde:** Starten Sie ihn mit `control/publish/execute` des Cam Driver. Siehe das Handbuch des Cam Driver, „Bilder streamen".
- **Wenn die ctrlX-Weboberfläche die Live-Ansicht nicht durchreicht:** Die Ansicht zeigt Einzelbilder. Das Bild bleibt korrekt; es kommt nur später an.

Siehe [Live-Ansicht](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html#live-view).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Anzahl der offenen Live-Ansichten und dem Wert von `control/publish/output/stream/active`.

## Overlays {#overlays}

### Problem: Eine Overlay-Änderung hat keine Wirkung, oder eine Form wird weiß gezeichnet {#faq-overlay-not-applied}

**Symptome**

Nachdem Sie die Einstellungsdatei des Cockpits bearbeitet haben, ändert sich das Overlay nicht; oder eine Form wird weiß statt in ihrer Farbe gezeichnet.

**Mögliche Ursachen**

- Das Cockpit wurde seit der Änderung nicht neu gestartet. Die Einstellungsdatei wird nur einmal, beim Start, gelesen.
- Der Wert von `color` kann nicht gelesen werden. Eine Farbe, die nicht gelesen werden kann, wird weiß gezeichnet statt abgelehnt.
- Eine Position oder Größe von `1.0` oder darüber ist in absoluten Pixeln angegeben: `1.0` ist ein Pixel, nicht der gegenüberliegende Rand oder die volle Breite.

**Diagnose**

1. Prüfen Sie, ob das Cockpit nach dem Bearbeiten der Datei neu gestartet wurde.
2. Prüfen Sie den Wert von `color` jeder weißen Form - erwartet: `red`, `green`, `blue`, `black`, `white`, `yellow`, `cyan`, `magenta` oder sechs Hexadezimalziffern `RRGGBB` (das darf entfallen).
3. Prüfen Sie `centerX`, `centerY`, `width` und `height` - erwartet: Werte unter `1.0`, wo Sie relative Werte meinen.

**Lösung**

- **Wenn das Cockpit nicht neu gestartet wurde:** Starten Sie die Anwendung Cockpit neu.
- **Wenn die Farbe nicht gelesen werden kann:** Korrigieren Sie den Tippfehler im Wert von `color` und starten Sie das Cockpit dann neu.
- **Wenn ein Wert von `1.0` als gegenüberliegender Rand oder volle Breite gemeint war:** Verwenden Sie einen Wert knapp unter `1.0` und starten Sie das Cockpit dann neu.

Siehe [Overlays](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/overlays.html).

**Wenn das Problem weiterhin besteht**

Senden Sie die unter [Informationen für den Support](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html#support-information) genannten Informationen an den Support, zusammen mit der Einstellungsdatei des Cockpits.

## Informationen für den Support {#support-information}

Wenden Sie sich an den Customer Success von HD Vision Systems unter [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) oder +49 6221 6721905; für Lizenzen an [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com). Senden Sie bitte:

- die Version von LumiScan Cockpit;
- die Plattform: ctrlX OS mit seiner Version auf einer ctrlX CORE oder einem ctrlX IPC, oder einen PC und sein Betriebssystem;
- Datum und Uhrzeit des Fehlers;
- das Log: auf ctrlX OS aus dem Systemprotokoll (Logbuch der ctrlX-Weboberfläche oder `journalctl`); unter Windows `%LOCALAPPDATA%\LumiScan Cockpit\logs\lumiscan-cockpit.log`;
- den Kommunikationsstatus: die Anwendungen und Ansichten, die die Übersicht aufführt, und auf einem PC die Data-Layer-Adresse (`--keryx-url`), die dem Cockpit und den Anwendungen übergeben wurde;
- die Meldung oder den Hinweis, den die Ansicht zeigt;
- die Konfiguration: die Einstellungsdatei des Cockpits (`lumiscan-cockpit.json` auf einem PC) und auf einem PC die Optionen, mit denen das Cockpit gestartet wurde.

# Release Notes: v1.3.0 - noch nicht veröffentlicht – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/release-notes/v1-3-0.html

Das Cockpit zeigt eine streamende Kamera jetzt live.

## Neu

**Live-Ansicht.** Solange eine Kamera ihre Bilder streamt (`control/publish/execute` von LumiScan Cam Driver), zeigt ihre Ansicht den Stream selbst, Frame für Frame, markiert mit **LIVE**. Stoppt der Stream, kehrt die Ansicht von selbst zu Einzelbildern zurück. Siehe [Live-Ansicht](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html#live-view).

**AI Object Matching auf einem Stream.** Solange ein Modul auf Kamera-Streams inferiert, zeigt seine Ansicht die Frames der Kamera mit den Boxen des Moduls darauf, beschriftet mit Klassennamen und Score - jedes Ergebnis auf genau dem Frame, in dem es gefunden wurde. Siehe [Ergebnisse ansehen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html#ai-on-a-stream).

**Einstellungen der Live-Ansicht.** Ein Zahnrad oben auf jeder Seite stellt die Bildrate (1 bis 30, Standard 10) und die JPEG-Qualität (50 bis 95, Standard 85) jeder Live-Ansicht ein. Sie gelten sofort und überstehen einen Neustart. Siehe [Einstellungen der Live-Ansicht](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html#settings).

**Läuft unter Windows** mit LumiScan Keryx, für Entwicklung und Tests. Siehe [Das Cockpit öffnen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/opening-the-cockpit.html#windows).

## Wissenswert

Das Cockpit empfängt den Stream einer Kamera nur, solange eine Live-Ansicht davon offen ist, und kodiert jeden Frame einmal für alle Tabs, die ihn zeigen. Vier Live-Ansichten können gleichzeitig offen sein; darüber hinaus zeigt eine Ansicht Einzelbilder und versucht es alle fünf Sekunden erneut.

Die Boxen von AI Object Matching werden auf den Frame gezeichnet, in dem das Ergebnis gefunden wurde; das Cockpit behält ihn unter den letzten Frames der Kamera (64 MB). Ein Ergebnis, dessen Frame nicht mehr vorgehalten wird, wird auf den neuesten Frame gezeichnet, markiert mit **approximate**.

Ob die ctrlX-Weboberfläche eine Live-Ansicht ohne Verzögerung durchreicht, wurde noch nicht auf einem Gerät geprüft. Falls nicht, zeigt die Ansicht wie bisher Einzelbilder.

## Bugfix

**Eine Einzelbild-Ansicht bleibt bei einer bewegten Szene nicht mehr hängen.** Jede Änderung startete das Bild neu, das der Browser gerade lud; auf einer Station, die sich schneller änderte, als ein Bild eintraf, zeigte die Ansicht daher nichts Neues. Die neueste Änderung wartet jetzt auf das Bild, das gerade geladen wird.

# Release Notes: v1.2.0 – LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/release-notes/v1-2-0.html

Das Cockpit zeigt jetzt das Ergebnis jeder Vision-Anwendung der Suite, nicht nur ein Kamerabild.

## Neu

**Acht Anwendungen zeichnen ihre Ergebnisse**, jede auf das Bild, das sie verarbeitet hat: Text Reader, Template Finder, Object Finder und Area Detector sowie die Reader für Aztec Code, QR Code, Barcode und DMC. Eine Anwendung mit Modulen wird als ihre Module aufgeführt; ein Code Reader hat eine Ansicht, benannt nach dem Code, den er liest. Siehe [Ergebnisse ansehen](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/viewing-results.html).

**Live-Bilder.** Eine Ansicht aktualisiert sich etwa 200 ms, nachdem sich das Bild dahinter geändert hat, statt in einem festen Zwei-Sekunden-Takt; was auf dem Bildschirm ist, folgt also der Linie, statt ihr hinterherzulaufen. Siehe [Live-Aktualisierung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/live-updates.html).

## Wissenswert

Die Regionen des Area Detector werden als durchscheinende Färbung gezeichnet, eine Farbe pro Region, beschriftet mit `<label>:<area>` - die Beschriftung ist die Nummer der Region in `output/blob-labels`, sodass sich eine gemessene Fläche zu den Pixeln zurückverfolgen lässt, aus denen sie stammt. Ein Rechteck konnte das nicht zeigen: Zwei sich berührende Teile, die getrennt wurden, und zwei, die zusammengefasst wurden, ergeben dieselben überlappenden Boxen.

Eine Ansicht zeigt **den durchsuchten Bereich**, aus dem Ergebnis selbst entnommen und nicht aus den aktuellen Ausschnitt-Einstellungen des Moduls. Wird ein Ausschnitt nach einem Lauf bearbeitet, verschiebt sich das Bild daher nicht unter den noch angezeigten Funden.

Hat sich die Kameraauflösung seit dem letzten Lauf geändert, werden die Funde nicht gezeichnet, und ein Hinweis nennt die Größe, zu der das Ergebnis gehört. Führen Sie die Anwendung erneut aus, um es zu erneuern.

## Frühere Releases

**Version 1.0.0** - erstes Release. Zeigt die Bilder, die der Camera Driver und AI Object Matching veröffentlichen.

# LumiScan Cockpit

URL: https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/index.html

|   |   |   |
| --- | --- | --- |
| ![Übersichtsseite mit vier laufenden LumiScan-Apps](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/intro/step-1.svg)<br><br>**Ihre Vision-Apps laufen.** Cockpit zeigt alle kompatiblen Apps auf einer Seite. | ![Kamerabild mit zwei gefundenen Teilen, umrandet und mit Name und Score beschriftet](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/intro/step-2.svg)<br><br>**Sehen, was jede App sieht.** Das Bild mit den Fundstellen der App darüber. | ![Cockpit im Browser und in einem PC-Fenster](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/_images/intro/step-3.svg)<br><br>**Auf ctrlX OS oder am PC.** Im Browser auf ctrlX OS, im eigenen Fenster am PC. |

LumiScan Cockpit ist der Viewer für die LumiScan-Vision-Apps. Es zeigt das Bild, mit dem jede App gearbeitet hat, und zeichnet ein, was sie gefunden hat: Template- und Objekttreffer, erkannte Flächen, gelesene Codes und KI-Erkennungen. Ansichten folgen jedem neuen Bild und laufen live mit, solange eine Kamera streamt. So gehen Inbetriebnahme und Sichtprüfung schnell. Cockpit ändert keine Einstellungen und speichert keine Bilder.

Zur Lizenzierung siehe [Lizenz](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/lumiscan-cockpit/requirements.html#licence). Fragen? Siehe die [FAQ](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/faq.html). Ein Problem oder eine Fehlermeldung? Siehe [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-cockpit-de/1.2.0/troubleshooting.html).
