---
title: "Voraussetzungen"
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/lumiscan-area-detector/requirements.html"
---

# Voraussetzungen – LumiScan Area Detector

## Lizenz {#licence}

Wie LumiScan Area Detector 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-AxxDETECTxHDVSx-V1NN`, eine Lizenz pro zehn Module.<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 Area Detector 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.

## Eine Plattform und ihr Data Layer

| Plattform | Data Layer |
| --- | --- |
| ctrlX OS (ctrlX CORE oder ctrlX IPC) | ctrlX Data Layer, bereitgestellt von ctrlX OS |
| ein PC mit Windows 11 oder Ubuntu 24.04 | LumiScan Keryx, der Data Layer von HD Vision Systems für PCs |

Auf ctrlX OS ist für den Data Layer nichts zu installieren.

Auf einem PC startet die Anwendung den LumiScan-Keryx-Broker, wenn keiner läuft; Installation und Einrichtung von LumiScan Keryx sind in [LumiScan Keryx auf einem PC](https://docs.hdvisionsystems.com/de/lumiscan-keryx-de/1.0.0/keryx.html) beschrieben.

## Eine Bildquelle auf demselben Gerät

Die Anwendung liest ihre Bilder vom Data-Layer-Bildknoten einer anderen Anwendung. Diese Anwendung muss auf **demselben Gerät** laufen wie der Area Detector - demselben ctrlX CORE oder ctrlX IPC oder demselben PC. Ein Zugriff auf einen entfernten Data Layer wird nicht unterstützt.

In der Praxis ist das LumiScan Cam Driver, aber jede Anwendung funktioniert, solange ihr Bildknoten diese vier Kindknoten bereitstellt:

| Knoten | Typ | Beschreibung |
| --- | --- | --- |
| `data` | Array aus uint8 | Rohe, unkomprimierte Pixeldaten |
| `width` | uint64 | Bildbreite in Pixeln |
| `height` | uint64 | Bildhöhe in Pixeln |
| `pixel-type` | string | Name des GenICam-Pixelformats |

### Unterstützte Pixelformate

`Mono8`, `Mono12`, `RGB8`, `RGB12`, `BGR8`, `BGR12`, `BayerGR8`, `BayerGR12`, `BayerRG8`, `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.

## Speicher

Die Anwendung speichert nichts außer ihrer Modulliste und deren Einstellungen - einige Kilobyte JSON im Konfigurationsverzeichnis der Anwendung. Auf ctrlX OS ist dieses Verzeichnis Teil der aktiven Solution. Wo es auf jeder Plattform liegt, steht unter [Konfigurationsdatei](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/datalayer-reference.html#configuration-file). Es gibt kein Referenzbild, das aufbewahrt werden müsste, also ist auch kein Speicherplatz einzuplanen.

Der Bild-Stream (experimentell) legt daneben einen Ordner an, `settings-history/`: eine kleine JSON-Datei für jeden Einstellungs-Hash, den ein Modul veröffentlicht, nie gelöscht. Siehe [Einen Bild-Stream verarbeiten](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/processing-an-image-stream.html).

## Zeitverhalten

Die Erkennung ist **synchron**: Der Aufruf von `execute` kehrt zurück, wenn die Suche abgeschlossen ist. Wie lange das dauert, hängt von der Bildgröße und vom Modus ab. Das Messen (`input/method`) besteht aus einem Schwellwert und einem Durchlauf der Zusammenhangskomponenten-Analyse und skaliert daher mit dem Bild. Das Schätzen wiederholt die Erkennung einmal pro Schwellwertstufe und skaliert daher mit dem Bild **und** mit der Anzahl der Stufen, die `method-specific/circle/threshold/step` erzeugt - deshalb ist `method-specific/circle/threshold/step` die Einstellung, die Sie zuerst vergrößern sollten, wenn ein Zyklus zu langsam ist.

Siehe [Die Erkennung abstimmen](https://docs.hdvisionsystems.com/de/lumiscan-area-detector-de/1.2.0/lumiscan-area-detector/tuning-the-detection.html).