FAQ

Auf ctrlX OS (ctrlX CORE oder ctrlX IPC) verwendet er den ctrlX Data Layer; auf einem PC mit Windows 11 oder Ubuntu 24.04 verwendet er LumiScan Keryx, den Data Layer von HD Vision Systems für PCs. Die Knotenadressen, Typen und die Art, wie die Methoden aufgerufen werden, sind auf beiden gleich; ein Programm, das für den einen geschrieben wurde, funktioniert auch mit dem anderen. Nur die Namen der Ergebnisse eines Methodenaufrufs unterscheiden sich, zum Beispiel DL_TOO_MANY_OPERATIONS auf dem ctrlX Data Layer und TooManyOperations bei LumiScan Keryx.

Data-Layer-Referenz, ctrlX Data Layer und LumiScan Keryx

Die Anwendung spricht nicht selbst mit einer Kamera. Sie liest den Bildknoten einer anderen Anwendung, die auf demselben Gerät läuft - derselben ctrlX CORE oder demselben 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 ist geeignet, deren Bildknoten data (rohe, unkomprimierte uint8-Pixeldaten), width, height und pixel-type (Name des GenICam-Pixelformats) bereitstellt. Eine Adresse innerhalb des Template Finder selbst wird mit Statuscode -2 abgelehnt.

Voraussetzungen, Data-Layer-Referenz

Mono8, Mono12, RGB8, RGB12, BGR8, BGR12, BayerGR8, BayerGR12, BayerRG8 und BayerRG12. Bayer-Bilder werden vor dem Matching in Farbe umgewandelt und 12-Bit-Bilder auf 8 Bit herunterskaliert, sodass Vorlagen aus einem Format auch in Bildern eines anderen Formats gefunden werden. Jedes andere Pixelformat wird mit Statuscode -3 abgelehnt.

Voraussetzungen

Verwenden Sie system/create-template. Die Methode gilt für die gesamte Anwendung: Sie schneidet eine Region aus dem aktuellen Bild aus und speichert sie als PNG, das jedes Modul verwenden kann:

Eine Vorlage erstellen, Anleitung: Ein Teil in einem Kamerabild finden

Vorlagen sind PNG-Dateien im Ordner templates des Konfigurationsverzeichnisses der Anwendung, der beim ersten Start angelegt wird. Eine von Hand hinzugefügte Vorlage wird bei der nächsten Suche gelesen, ohne Neustart.

Speicherung der Vorlagen

Setzen Sie find-template/input/input-image-address und find-template/input/template-name (wie auf system/templates aufgeführt), schreiben Sie auf find-template/execute und lesen Sie find-template/output/status-code. Der Schreibvorgang blockiert und kehrt zurück, wenn die Suche abgeschlossen ist. Bei 1 lesen Sie output/result: matches ist nach Konfidenz sortiert, sodass matches[0] und best_score den besten Treffer liefern. Jeder Treffer hat eine oriented_bounding_box (center_x, center_y, width, height in Pixeln, angle in Grad), confidence, scale und rotation. Eine leere Liste matches mit Status 1 ist ein normales Ergebnis: Das Teil wurde nicht gefunden.

Eine Vorlage finden

Die Suche abstimmen, Voraussetzungen

Setzen Sie find-template/input/crop/ (startX, startY, width, height). Eine Breite oder Höhe von null reicht bis zum rechten bzw. unteren Rand; mit lauter Nullen wird also das ganze Bild durchsucht. Eine Region, die über einen Rand hinausreicht, wird abgelehnt und nicht beschnitten, mit einer Meldung wie crop/startX + crop/width (100 + 541 = 641) exceeds the image width 640. input/result-coordinate bestimmt das Koordinatensystem der Positionen: IMAGE (Standard, das ganze Bild, direkt für einen Robotergriff verwendbar) oder CROP (die durchsuchte Region, obere linke Ecke (0,0)).

Eine Vorlage finden

Ja, als experimentelle Funktion. Ein Modul abonniert den Stream einer Kamera und durchsucht jedes Bild mit den Eingaben von find-template (alle außer input/input-image-address); es veröffentlicht ein Ergebnis pro Bild auf <module-id>/control/subscribe/output/stream/result:

Vorlagen in einem Bild-Stream finden (experimentell), Streams (experimentell)

Prüfen Sie das Vorzeichen von output/status-code: Größer als 0 bedeutet 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. Der Grund steht auf output/status-text, der mit ok: oder error: beginnt. Ein fehlgeschlagener Schreibvorgang auf execute selbst antwortet nur mit einem Statuscode (über REST ein bloßes 400); lesen Sie danach output/status-text. Derselbe Text wird in das Protokoll der Anwendung geschrieben: auf ctrlX OS in das ctrlX Logbook oder mit journalctl, auf einem PC in die Konsolenausgabe der Anwendung. -1 (belegt) bedeutet, dass eine andere Operation desselben Moduls noch lief; es wurde nichts getan, versuchen Sie es also erneut, sobald sie abgeschlossen ist.

Eine Methode ausführen, Ausführungsstatus

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:

Voraussetzungen, Modulverwaltung, FAQ zur Lizenzierung

Siehe die LumiScan-FAQ der gesamten Dokumentation. Wenden Sie sich an den Customer Success von HD Vision Systems unter customer.success@hdvisionsystems.com oder +49 6221 6721905; für Lizenzen an licenses@hdvisionsystems.com. Bevor Sie ein Problem für einen Support-Bericht reproduzieren, setzen Sie logLevel im Block system von lumiscan-template-finder.json auf TRACE und starten Sie die Anwendung neu.

Speicherung der Vorlagen, FAQ zur Lizenzierung