ToolGroup Items¶
Grundlagen¶
Name und ID¶
ToolGroup Items können beliebig benannt werden. Da Namen aber auch als Dateinamen zum Speichern der Daten verwendet werden, sollten keine Zeichen verwendet werden, die in Dateinamen ungültig sind.
Dem Namen eines ToolGroup Items kann eine ID vorangestellt werden, in der Form ID_Name, ID-Name oder ID.Name.
Die ID ist dabei eine Job-weit eindeutige Nummer zwischen -32768 und +32767 (16 Bit Zahl mit Vorzeichen).
Diese ID kann dann bspw. beim Trigger verwendet werden, um automatisch zwischen den ToolGroup Items eines Jobs umzuschalten.
Bildquellenliste¶
Eingabebilder erhält eine Toolgroup in der Regel durch Zuordnung der Quellen aus der Bildquellenliste zu Terminals des ImagesToolBlock. Alternativ kann ein Bildeinzug im Ablauf mittels GImgSrcItfTool erfolgen, welches wiederum Quellen aus der Bildquellenliste nutzt.
Jedes Toolgroup Item definiert eine eigene Bildquellenliste, in der eigene Bildquellen konfiguriert werden können. Alternativ zur Definition einer eigenen Liste kann auch die übergeordnete Bildquellenliste des Job verwendet werden. Die Bearbeitung der Bildquellenliste erfolgt im Toolgroup Item Editor.
Hinweis
Die Reihenfolge der Bildquellen in der Liste ist zum Beispiel ausschlaggebend für die Zuordnung gespeicherter Bilder im RunFromDir oder die Zuordnung der Quellen-IDs von Bildquellen-Selektoren.
Bildquellen-Selektoren¶
Die Quellen von Referenz-Bildquelle eines ToolgroupItem können bei Triggerung anhand von GInOut Variablen dynamisch umgeschalten werden. Auf diese Weise kann beispielsweise für verschiedene Bauteilvarianten die Beleuchtungsfarbe und Belichtungszeit angepasst werden.
Basierend auf den Werten einer Auswahl von GInOut Variablen werden die Referenz-IDs der Referenzbildquellen in der Bildquellenliste vor dem Bildeinzug gesetzt. Die Auswahl kann auf zwei Arten erfolgen:
Selektor: Auflistung der möglichen Werte-Kombinationen der Variablen und der jeweiligen Quellen-IDs
Condition: Aussagenlogische Bedingungen über die GInOut-Variablenwerte und jeweilige Quellen-IDs
Die Einstellung erfolgt im Toolgroup Item Editor im Bildquellen-Tab.
Lichtsituation des Toolgroup Items¶
Zu jedem Toolgroup Item kann eine eigene Lichtsituation eingestellt werden, oder auch eine global vordefinierte Lichsituation zugeordnet werden. Währen der Bildaufnahmen beim Auführen des Toolgroup Items wird diese Lichtsituation aktiviert.
Lichtsituation auswählen: In dieser Auswahl-Box können vordefinierte Lichtsituationen zugeordnet oder eine „Benutzerdefinierte“ erstellt werden.
Lichtsituation einstellen: Öffnen eines Dialoges zum Bearbeiten der ausgewählten Lichtsituation.
Liste der vordefinierten Lichtsituationen: Öffnen eines Dialoges zum Erstellen / Bearbeiten der vordefinierten Lichtsituationen.
Hinweis
Falls einem Toolgroup Item eine Lichsituation zugeordnet ist, dürfen die Bildquellen des Toolgroup Items keine Lichtsituationen enthalten.
ToolGroup Item Typen¶
Der Typ eines Toolgroup-Items wird bei dessen Erstellung festgelegt und im Job Editor angezeigt. Die verschiedenen Typen implementieren Sonderfunktionen im Rahmen der Globale Kalibrierungen.
Standard TG Item¶
Standard ToolGroup-Items implementieren übliche Bildverarbeitungs-Abläufe zum Beispiel zur Bauteil-Inspektion. Bei der Ausführung werden entsprechend der Zuordnung von Kalibrierungen die Globale Kalibrierungen angewandt.
Kalibrier TG Item¶
Kalibrier TG Items erfüllen im Rahmen der Globale Kalibrierungen die Funktion der Berechnung, Prüfung und Speicherung der Kamerakalibrierungen. Je nach Anwendung werden Toolgroups zur Inbetriebnahme, Wartung oder in regelmäßigen Abständen ausgeführt um die Kameraparameter zu prüfen und anzupassen. In der Regel zeigen diese Toolgroups nach der Ausführung einen Benutzerdialog an um die neue Kalibrierung zu bestätigen oder zu verwerfen.
Kalibrier TG Items fügen dem Standard TG Item einen Erweiterungs-Tab hinzu. Dort erfolgt die Verknüpfung abzuspeichernder Kalibrierung mit den berechnenden Tools und die Konfiguration des Benutzerdialoges.
Warnung
Abzuspeichernde Kalibrierungen in einem Kalibrier TG Item dürfen nicht über die Zuordnung von Kalibrierungen des Standard TG Item verknüpft werden.
TG Item Templates¶
Der Ablauf neuer ToolgroupItems wird bei deren Erstellung als Kopie einer Vorlage initialisiert. Benutzer können die Standard-Vorlagen für ein Projekt überschreiben. Dazu muss dazu der jeweilige Standard-Ablauf als toolgroup_tgitem.vpp im Standard-Daten-Verzeichnis abgelegt werden. Der Verzeichnispfad ist in der Projektkonfiguration des Vision-Plugins als defaultDataDirectory eingetragen.