---
title: "FAQ"
description: "Häufige Fragen zu LumiScan Area Detector - Bildquelle und Pixelformate, Einstellen des Schwellwerts, Lesen des Ergebnisses, das Label-Bild, der Bild-Stream, Statuscodes, Einstellungsdateien und Lizenzierung."
product: "LumiScan Area Detector"
component: "lumiscan-area-detector-de"
version: "1.2.0"
display_version: "1.2.0.6"
latest_version: true
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/faq.html"
---

# FAQ – LumiScan Area Detector

Kurze Antworten auf häufige Fragen zu LumiScan Area Detector. Jeder Eintrag verweist auf die Seite mit den Details.

> [!TIP]
> Jeder Eintrag hat einen festen Anker (zum Beispiel `#faq-pixel-formats`). Probleme, Fehlermeldungen und Statuscodes sind Schritt für Schritt unter [Fehlerbehebung](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html) beschrieben.

## Voraussetzungen und Einrichtung

### Welche Bildquelle braucht der Area Detector? {#faq-image-source}

- **Antwort:** Die Anwendung kommuniziert nicht selbst mit einer Kamera. Sie liest den Bildknoten einer anderen Anwendung, die auf **demselben Gerät** läuft - demselben ctrlX CORE oder ctrlX IPC oder demselben PC (ein Zugriff auf einen entfernten Data Layer wird nicht unterstützt), normalerweise LumiScan Cam Driver, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/output/image`. Jede Anwendung funktioniert, wenn ihr Bildknoten `data` (rohe, unkomprimierte uint8-Pixeldaten), `width`, `height` und `pixel-type` (Name des GenICam-Pixelformats) bereitstellt. Ein Referenzbild ist nicht nötig.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/requirements.html), [Beschreibung](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/description.html)

### Welche Pixelformate werden unterstützt? {#faq-pixel-formats}

- **Antwort:** `Mono8`, `Mono12`, `RGB8`, `RGB12`, `BGR8`, `BGR12`, `BayerGR8`, `BayerGR12`, `BayerRG8` und `BayerRG12`. Bayer-Bilder werden vor der Erkennung in Farbe umgewandelt und 12-Bit-Bilder auf 8 Bit herunterskaliert; ein Schwellwert, der auf einem Format eingestellt wurde, gilt also auch für ein anderes. Jedes andere Pixelformat wird mit Statuscode `-3` abgelehnt.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/requirements.html)

## Erkennen und Messen

### Wie führe ich eine Erkennung aus und lese das Ergebnis? {#faq-first-run}

- **Antwort:** Setzen Sie `<module>/detect-area/input/input-image-address`, schreiben Sie auf `<module>/detect-area/execute` (ein blockierender Aufruf) und prüfen Sie, dass `output/status-code` `1` ist. Lesen Sie dann `output/result`: `blobs` ist nach Fläche sortiert, `blobs[0]` ist also die größte Region; jeder Blob hat seinen Mittelpunkt `x`, `y`, seine `area` in Pixeln (gezählt, nie aus einer angepassten Form abgeleitet), sein `label` und ein umschließendes Rechteck. `blob_count` gibt die Anzahl der Regionen an und `total_area` die Summe, die bei Bedeckungs-, Verunreinigungs- und Füllstandsprüfungen meist die Zahl ist, auf die Sie reagieren.
- **Mehr:** [Flächen erkennen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/detecting-areas.html), [Anleitung: Teilefläche aus einem Kamerabild messen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/how-tos/measure-part-area-from-a-camera-image.html)

### Wie finde ich den richtigen Schwellwert? {#faq-commission-level}

- **Antwort:** Messen Sie das Bild, statt zu raten. `FIXED` ist in dieser Version das einzige `input/method`; alles andere wird abgelehnt.
  - Setzen Sie `system/analyse-scene/input/input-image-address` und schreiben Sie auf `system/analyse-scene/execute`.
  - Lesen Sie `output/recommended-settings`: `node=value`-Zeilen relativ zum `detect-area/input/` eines Moduls, mit dem Schwellwert, der Angabe, welche Seite das Teil ist, und ob Löcher gefüllt werden sollen. Nichts wird für Sie geschrieben.
  - Prüfen Sie den Rat mit `output/histogram`: Der Schwellwert sollte im Tal zwischen dem Buckel des Teils und dem des Hintergrunds liegen. Ein Buckel bedeutet, dass kein Schwellwert funktionieren wird und die Beleuchtung korrigiert werden muss.
  - Setzen Sie `<module>/detect-area/input/method-specific/fixed/level` (0-255, Standard `128`).
- **Mehr:** [Eine Szene analysieren](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/analysing-a-scene.html), [Die Erkennung abstimmen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/tuning-the-detection.html)

### Welche Vorverarbeitungsfilter gibt es, und was brauchen sie? {#faq-preprocessing}

- **Antwort:** `input/preprocess/method` wendet vor der Erkennung einen Filter an: `NONE` (Standard), `LOG` (Laplacian of Gaussian), `DOG` (Difference of Gaussians; `sigma-first` muss sich von `sigma-second` unterscheiden) oder `DOH` (Determinant of Hessian; `kernel-size` muss 1, 3, 5 oder 7 sein). Nur die Parameter der gewählten Methode werden gelesen und geprüft. Alle drei normalisieren ihre Ausgabe, der Schwellwert muss nach dem Einschalten eines Filters also eventuell neu gesetzt werden.
- **Mehr:** [Flächen erkennen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/detecting-areas.html), [Die Erkennung abstimmen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/tuning-the-detection.html)

### Wie finde ich die Pixel, die zu einer gemeldeten Region gehören? {#faq-label-image}

- **Antwort:** Jeder Durchlauf veröffentlicht `output/blob-labels`, einen gewöhnlichen Bildknoten (`data`, `width`, `height`, `pixel-type`) in `Mono16`, mit einer Regionsnummer pro Pixel und `0` für Hintergrund. Die Nummern sind die `blobs[].label`-Werte in `output/result`; alle Pixel, die das Label eines Blobs enthalten, sind also diese Region; eine Binärmaske ist `labels > 0`. Das Bild umfasst den ganzen Frame in der Größe des Eingabebildes, und Labels werden nicht neu nummeriert. Es wird geleert, wenn der nächste Durchlauf beginnt.
- **Mehr:** [Das Label-Bild](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/the-label-image.html)

### Wie schränke ich die Suche ein oder mache sie schneller? {#faq-crop-speed}

- **Antwort:** Setzen Sie `input/crop/` (`startX`, `startY`, `width`, `height`); eine Breite oder Höhe von null reicht bis zum rechten bzw. unteren Rand, lauter Nullen durchsuchen also das ganze Bild. Eine Region, die über einen Rand hinausreicht, wird abgelehnt und nicht beschnitten; die Meldung nennt die Eingabe und die Grenze, die sie verletzt hat. Für mehr Geschwindigkeit schränken Sie zuerst den Bereich ein und erhöhen dann den Schwellwert, damit Rauschen und Staub den Schwellwert nicht mehr überschreiten.
- **Mehr:** [Flächen erkennen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/detecting-areas.html), [Die Erkennung abstimmen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/tuning-the-detection.html)

### Wie erkenne ich Flächen auf jedem Frame eines Kamera-Streams? {#faq-stream}

- **Antwort:** Lassen Sie ein Modul den Stream des Cam Driver abonnieren (experimentell): Schreiben Sie den Stream-Ordner der Kamera, zum Beispiel `hdvisionsystems/lumiscan-cam-driver/camera1/control/publish/output/stream`, auf `<module>/control/subscribe/input/address`, setzen Sie `control/subscribe/input/enable` auf `true` und schreiben Sie auf `control/subscribe/execute`. Jeder Frame wird mit den Eingaben von `detect-area` durchsucht, und ein Ergebnis pro Frame wird auf `control/subscribe/output/stream/result` veröffentlicht. Das Label-Bild wird nicht gestreamt. Um das neueste Ergebnis als einfaches `detect-area/output/result` zu lesen, setzen Sie `control/subscribe/input/keep-latest-output` auf `true`.
- **Mehr:** [Flächen auf einem Bild-Stream erkennen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/processing-an-image-stream.html), [Streams](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/streams.html)

## Statuscodes und Fehler

### Wie erkenne ich, ob eine Erkennung erfolgreich war, und wo steht der Grund für einen Fehlschlag? {#faq-status-codes}

- **Antwort:** Prüfen Sie das Vorzeichen von `output/status-code`: Größer als 0 ist Erfolg, `0` bedeutet, dass die Operation seit dem Start der Anwendung nicht ausgeführt wurde, kleiner als 0 bedeutet, dass sie fehlgeschlagen ist und nichts erzeugt hat; verwenden Sie das Ergebnis dann nicht. Der Grund steht auf `output/status-text`. Ein fehlgeschlagener Schreibvorgang auf `execute` antwortet nur mit einem Statuscode (über REST mit einem bloßen `400`), lesen Sie also anschließend `output/status-text`; der Text steht auch im Protokoll der Anwendung: auf ctrlX OS im ctrlX Logbook oder `journalctl`, auf einem PC in der Konsolenausgabe der Anwendung.
- **Mehr:** [Eine Methode ausführen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/execute-a-method.html), [Ausführungsstatus](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/execution-status.html)

## Fehlerbehebung {#troubleshooting}

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

- [Statuscode `-1` (belegt)](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#faq-status-minus-1)
- [Statuscode `-2` (ungültige Eingabe)](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#ts-status-minus-2)
- [Statuscode `-3` (Bild konnte nicht gelesen werden)](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#faq-status-minus-3)
- [Die Ausschnittsregion passt nicht in das Bild](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#ts-crop-does-not-fit)
- [Statuscode `-6` (Schreiben fehlgeschlagen)](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#ts-status-minus-6)
- [Nichts wird gefunden, oder das Ergebnis ist leer](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#faq-nothing-found)
- [Die gemessene Fläche ist größer oder kleiner als das Teil](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#faq-area-wrong)
- [Viele winzige Regionen werden gemeldet](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#faq-tiny-regions)
- [Ein Teil wird als mehrere Regionen gemeldet](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#faq-part-split)
- [Der Messwert driftet mit der Beleuchtung, oder kein Schwellwert funktioniert](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#faq-reading-drifts)
- [`output/result` ist leer, obwohl die Erkennung gerade eben funktioniert hat](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#faq-result-empty-next-run)
- [Der Bild-Stream liefert keine Ergebnisse](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#ts-stream-no-results)
- [Meine Einstellungen oder Module sind nach einem Neustart weg](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#faq-settings-lost)
- [Die Anwendung beendet sich kurz nach dem Start](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#ts-app-stops-after-start)
- [Statuscode `-11` (Lizenz nicht verfügbar)](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/troubleshooting.html#ts-licence-unavailable)

## Module, Lizenzierung und Support

### Wo liegen die Einstellungsdateien? {#faq-settings-files}

- **Antwort:** Im Konfigurationsverzeichnis der Anwendung, `lumiscan-area-detector/`: die Anwendungs-Einstellungsdatei `lumiscan-area-detector.json` und eine `<module-id>.json` pro gespeichertem Modul.
  - Auf ctrlX OS: in der aktiven Solution, `/var/snap/rexroth-solutions/common/solutions/activeConfiguration/lumiscan-area-detector`.
  - Auf einem PC (Windows): `%APP_RESOURCE_DIR%\etc\lumiscan-area-detector`; ohne `APP_RESOURCE_DIR` `C:\ProgramData\HD Vision Systems GmbH\LumiScan Vision Suite\lumiscan-areadetect\etc\lumiscan-area-detector`.
  - Auf einem PC schreibt `lumiscan-areadetect --generate-settings <folder>` ein Beispiel beider Dateien, mit ihren JSON-Schemas, in einen Ordner Ihrer Wahl.
- **Mehr:** [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/datalayer-reference.html#configuration-file), [Wo die Dateien liegen](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html#files)

### Welche Lizenz brauche ich, und wie viele Module deckt sie ab? {#faq-licence}

- **Antwort:** Eine Lizenz deckt zehn Module ab; das elfte Modul belegt eine zweite Lizenz desselben Schlüssels, und ein Modul wird mit Status `-11` abgelehnt, wenn keine Lizenz auf dem Gerät es abdeckt. Bezugswege:
  - Bei HD Vision Systems gekauft: Die Lizenz liegt auf einem LumiScan Key (Windows 11 oder Ubuntu 24.04). Pro Gerät, auf dem die Software gleichzeitig läuft, wird ein LumiScan Key benötigt; Keys können zwischen Geräten getauscht werden.
  - Im ctrlX Store für Windows 11 gekauft: ctrlX WORKS plus ein LumiScan Key.
  - Im ctrlX Store für ctrlX OS (ctrlX CORE oder IPC) gekauft: eine ctrlX-Lizenz, kein Key.
- **Mehr:** [Voraussetzungen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/requirements.html#licence), [Modulverwaltung](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/module-management.html), [FAQ zur Lizenzierung](https://docs.hdvisionsystems.com/de/lumiscan-licensing-de/1.0.4/faq.html)

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

- **Antwort:** Siehe die [LumiScan-FAQ](https://docs.hdvisionsystems.com/de/faq.html) der gesamten Dokumentation. 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)