Custom Functions

In diesem Kapitel finden Sie allgemeine Informationen zur Bedienung der Custom Functions im Workflow der evoVIU-Kamera.

Einleitung

Die Custom Functions befinden sich im My Workflow Tab zwischen den Bereichen Components und Enums.

Verwaltung von Custom Functions

Anlegen einer Custom Function

Im Bereich "Functions" kann über das Plus-Symbol eine neue Custom Function erstellt werden. Grundsätzlich ist es möglich, beliebig viele Custom Functions anzulegen. Zur Unterscheidung dient das jeweils vergebene Label. Dieses kann frei gewählt werden, muss jedoch innerhalb der Custom Functions eindeutig sein.

Entfernen einer Custom Function

Sobald Sie sich mit der Maus über einem Eintrag einer Custom Function befinden, wird Ihnen das Mülleimer-Icon zum Entfernen der Custom Function angezeigt. Hierfür können Sie außerdem die Tastenkombination ALT + Shift + Delete nutzen, sofern Sie eine Custom Function ausgewählt haben. Anschließend öffnet sich ein Dialog, in dem Sie den Vorgang zum Entfernen der Custom Function bestätigen müssen.

Das Entfernen der Custom Function ist jedoch nur möglich, wenn Sie diese nicht im Event Graph des Workflows verwenden. Ist dies der Fall, so müssen Sie zuvor die Custom Function aus dem Event Graph des Workflows entfernen.

Verschieben einer Custom Function

Damit Sie sich eine bessere Übersicht über Ihre Funktionen verschaffen können, können Sie die Einträge beliebig sortieren. Dafür müssen Sie lediglich als aktiver Editor sicherstellen, dass der Workflow nicht aktiv ist. Ist das gegeben, können Sie anhand des Buttons mit den zwei waagrechten Strichen vor der Bezeichnung Ihrer Custom Function diese per Drag & Drop im zugehörigen Bereich verschieben. Sobald Sie loslassen, wird die Custom Function an der Stelle platziert, an der Sie sich gerade befinden.

Parameter einer Custom Function

Anlegen von Parametern

Wenn Sie eine Custom Function ausgewählt haben, können Sie im zugehörigen Details Tab die eingehenden Parameter definieren. Parameter sind Daten, die sie aus dem Event Graph des Workflows in die Custom Function hineingeben und dort weiterverarbeiten können. Neben einem Label können Sie auch eine Typisierung vornehmen, was Ihnen vermutlich bereits durch das Konfigurieren von Variablen im Workflow geläufig ist. Auch hier können Sie eine beliebige Anzahl an Parametern anlegen, aber stellen Sie sicher, dass jeder Parameter eine eindeutige Bezeichnung besitzt.

Entfernen von Parametern

Sobald Sie sich mit der Maus über einem Eintrag eines Parameters befinden, wird Ihnen das Mülleimer-Icon zum Entfernen des Parameters angezeigt. Hierfür können Sie außerdem die Tastenkombination ALT + Shift + Delete nutzen, sofern Sie einen Parameter ausgewählt haben. Anschließend öffnet sich ein Dialog, in dem Sie den Vorgang zum Entfernen des Parameters bestätigen müssen.

Verschieben von Parametern

Analog zu den Custom Functions können Sie auch die zugehörigen Parameter innerhalb der Custom Function verschieben. Nutzen Sie hierzu den Button mit den zwei waagrechten Strichen vor der Bezeichnung des Parameters und ziehen Sie den Eintrag an die gewünschte Position. Sobald Sie loslassen wird der ausgewählte Parameter an die entsprechende Stelle verschoben.

Rückgabewerte einer Custom Function

Anlegen von Rückgabewerten

Analog zu den Parametern können Sie im Details Tab auch die Rückgabewerte definieren. Mit den Return Values können Sie Daten aus der Custom Function an den Event Graph des Workflows zurückleiten, damit diese dort weiterverarbeitet werden können. Return Values müssen ebenfalls über eindeutige Bezeichnungen verfügen und können typisiert werden.

Entfernen von Rückgabewerten

Das Entfernen von Rückgabewerten ist ebenfalls möglich. Das Mülleimer-Icon zum Entfernen des Return Values wird Ihnen angezeigt, sobald Sie sich mit der Maus über einem Eintrag befinden. Die Nutzung der Tastenkombination ALT + Shift + Delete ist ebenfalls möglich, um den Dialog zu öffnen, in dem Sie den Löschvorgang bestätigen müssen.

Verschieben von Rückgabewerten

Zur Sortierung von Rückgabewerten können Sie auf den gleichen Mechanismus wie bei den Parametern innerhalb der Custom Function zurückgreifen. Nutzen Sie hierzu den Button mit den zwei waagrechten Strichen vor der Bezeichnung des Rückgabewerts und ziehen Sie den Eintrag an die gewünschte Position. Sobald Sie loslassen wird der ausgewählte Rückgabewert an die entsprechende Stelle verschoben.

Konfiguration einer Custom Function

Auswahl einer Custom Function

Um eine Custom Function in Form eines Graphen mit Nodes befüllen zu können, müssen Sie den Tab New Tab 1 auswählen. Im Zentrum des Tabs wird zunächst keine Custom Function ausgewählt sein. Über das Dropdown können Sie die Auswahl vornehmen und anschließend die Konfiguration starten.

Sobald Sie die Auswahl vorgenommen haben, ändert sich auch die Bezeichnung des Tabs und passt sich dem Titel Ihrer Custom Function an. Der Tab besitzt neben dem Label zudem einen Button, der in Form eines X Ihnen die Auswahl einer anderen Custom Function ermöglicht.

Einbinden einer Custom Function im Workflow

Im Tab Event Graph befindet sich am unteren Ende eine Leiste mit einem gelben Button, der das Hinzufügen von Knoten ermöglicht. Auch mit einem Rechtsklick können Sie das Menü zum Hinzufügen von Knoten öffnen. Dort können Sie in der Suchleiste die Bezeichnung Ihrer Custom Function eingeben und diese anschließend per Klick auswählen. Die Custom Function wird nun im Graphen Ihres Workflows hinzugefügt.

Sobald Sie die Custom Function als Knoten Ihrem Workflow hinzugefügt haben, erscheint im Tab My Workflow auch ein Hinweis über die Verwendung der Custom Function. Wenn Sie auf das Icon klicken, können Sie anschließend im Dialog nachvollziehen, wo die Custom Function verwendet wird. An dieser Stelle greift nun auch ein Sicherheitsmechanismus: Sobald Ihre Custom Function im Workflow verwendet wird, können Sie diese nicht mehr löschen. Hierfür müssen Sie vorab den Knoten im Workflow entfernen, damit keine Usage mehr vorliegt.

Hinzufügen notwendiger Knoten

Der Tab zur Konfiguration der Custom Function ist initial leer. Es empfiehlt sich zu Beginn die Eingangs- und Ausgangsknoten hinzuzufügen. Diese sind mit Entry bzw. Return benannt und erforderlich für die Ausführung des gesamten Workflows. Sie können die Knoten über Rechtsklick innerhalb des Tabs oder über den gelben, rechts ausgerichteten Plus-Button in der unteren Leiste hinzufügen, indem Sie anschließend im sich öffnenden Menü die jeweiligen Knoten auswählen. Diese Vorgehensweise gleicht der Konfiguration des allgemeinen Workflows.

Konfigurieren einer Custom Function anhand eines Graphen

Zwischen den Knoten Entry und Return besitzen Sie nun allerlei Gestaltungsfreiheit. Ihnen stehen innerhalb der Custom Functions alle Werkzeuge zur Verfügung, die sich auch aus dem Tab Event Graph und dem zugehörigen Menü kennen.