---
title: "Beschreibung"
product: "LumiScan Template Finder"
component: "lumiscan-template-finder-de"
version: "1.1.0"
display_version: "1.1.0.7"
latest_version: true
language: "de"
url: "https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/description.html"
---

# Beschreibung – LumiScan Template Finder

LumiScan Template Finder lokalisiert ein bekanntes Teil in einem Kamerabild. Sie geben der Anwendung ein kleines Bild des Teils - die **Vorlage** - und sie meldet, wo dieses Teil in einem größeren Bild erscheint, wie sicher der Treffer ist und bei welcher Skalierung und Drehung er gefunden wurde.

Typische Anwendungen sind Anwesenheitsprüfungen, Positionsrückmeldungen für einen Robotergriff und Orientierungsprüfungen vor einem Montageschritt.

Die Anwendung läuft auf ctrlX OS (ctrlX CORE oder ctrlX IPC), wo sie den ctrlX Data Layer verwendet, und auf einem PC mit Windows 11 oder Ubuntu 24.04, wo sie LumiScan Keryx verwendet. Ihre Knoten und die Art, wie sie aufgerufen werden, sind auf beiden gleich. Siehe [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/datalayer-reference.html).

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 Template Finder ist; seine eigenen Knoten sind in der [Data-Layer-Referenz](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/datalayer-reference.html) aufgeführt.

## Was die Anwendung tut

Die Anwendung bietet zwei Operationen.

**Eine Vorlage erstellen** schneidet eine rechteckige Region aus einem Live-Kamerabild aus und speichert sie als PNG im Konfigurationsverzeichnis der Anwendung. So erzeugen Sie eine Vorlage von der echten Kamera, bei der echten Beleuchtung und im echten Arbeitsabstand - ohne Dateiübertragung und ohne Bildbearbeitungsprogramm. Siehe [Eine Vorlage erstellen](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/creating-a-template.html).

**Eine Vorlage finden** durchsucht ein Live-Kamerabild nach dieser Vorlage und meldet jedes gefundene Vorkommen. Siehe [Eine Vorlage finden](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/finding-a-template.html).

Beide Operationen lesen das Bild im Moment ihres Aufrufs vom Data-Layer-Bildknoten einer anderen Anwendung - normalerweise LumiScan Cam Driver -, sodass sie immer mit dem aktuellen Bild arbeiten. Ein Modul kann auch jedes Bild durchsuchen, das eine Kamera streamt, siehe [Vorlagen in einem Bild-Stream finden (experimentell)](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/processing-an-image-stream.html).

## Woher die Bilder kommen

Die Anwendung spricht nicht selbst mit einer Kamera. Sie erhält die **Adresse** eines Bildknotens, den eine andere Anwendung veröffentlicht:

```
hdvisionsystems/lumiscan-cam-driver/camera1/output/image
```

Das trennt die beiden Aufgaben: Die Kameraanwendung ist für Triggerung und Belichtung zuständig, diese Anwendung für das Matching. Außerdem kann dasselbe Bild von mehreren Anwendungen gleichzeitig verwendet werden, und Sie können den Template Finder auf eine andere Kamera richten, indem Sie einen einzigen String ändern.

## Module

Eine Konfiguration der Anwendung ist ein **Modul**, mit eigener Vorlage, eigenen Suchparametern und eigenen Ergebnissen unter einer eigenen Adresse:

```
hdvisionsystems/lumiscan-template-finder/module-1/
```

Eine neue Installation stellt ein Modul bereit, `module-1`; weitere Module können im laufenden Betrieb angelegt werden, sodass eine Installation mehrere Kamerakonfigurationen gleichzeitig bedienen kann.

> [!IMPORTANT]
> **Auf ctrlX OS deckt eine Lizenz zehn Module ab.** Das elfte belegt eine zweite Lizenz desselben Schlüssels.

Module sind unabhängig voneinander, abgesehen davon, dass sie sich ein Vorlagenverzeichnis teilen - eine von einem Modul erstellte Vorlage kann also von allen verwendet werden. Ihre Einstellungen und die Modulliste selbst können gespeichert werden, damit sie nach einem Neustart wieder da sind. Siehe [Modulverwaltung](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/module-management.html).

## Was ein Ergebnis enthält

Eine erfolgreiche Suche meldet für jedes gefundene Vorkommen:

- die **orientierte Bounding Box** - Mittelpunkt, Breite, Höhe und Winkel im Bild
- die **Konfidenz**, zwischen 0 und 1
- die **Skalierung** und **Drehung**, bei der der Treffer gefunden wurde

Die Ergebnisse sind nach Konfidenz sortiert, sodass der beste Treffer immer der erste Eintrag ist. Jede Operation meldet außerdem einen numerischen Statuscode und eine Statusmeldung; damit prüft eine SPS, ob der Durchlauf erfolgreich war - siehe [Ausführungsstatus](https://docs.hdvisionsystems.com/de/lumiscan-template-finder-de/1.1.0/lumiscan-template-finder/execution-status.html).