---
version: "8.6.0"
language: "de"
---
# Product Documentation

## [Allgemeines über evoVIU](https://doku.evoviu.de/de/product-documentation/8.6.0/allgemeines-uber-evoviu.md)

*

  ### [Erste Schritte mit evoVIU](https://doku.evoviu.de/de/product-documentation/8.6.0/erste-schritte-mit-evoviu.md)

### [VIUx: Hardware](https://doku.evoviu.de/de/product-documentation/8.6.0/viux-iot-edge-kamera-hardware.md)

### [VISIONWEB](https://doku.evoviu.de/de/product-documentation/8.6.0/viu-sw-die-software-der-evoviu.md)

*

  ### [VISIONAPI](https://doku.evoviu.de/de/product-documentation/8.6.0/visionapi.md)

---
version: "8.6.0"
language: "de"
---
# Ablaufsteuerung

## For Each Loop

Dieser Knoten ermöglicht es Ihnen, ein Array zu durchlaufen und die Werte an jedem Index abzurufen.

Ein Array ist eine Datenstruktur, die eine Sequenz von Elementen fester Länge desselben Typs speichert. Jedes Element kann über seinen Index, beginnend bei null, angesprochen werden.

### Flow

![Screenshot 2026-01-13 145614.png](https://doku.evoviu.de/__attachments/a_856f7a36afea7cf77d3578e0a4c4746526afe8935322a7be2bbbbaf5b57d6f44/Screenshot%202026-01-13%20145614.png?cb=3cf5840df30b0b86e8873a034ef50ef5)

### Parameterset

| **Parameter** |                                              **Beschreibung**                                              |
|---------------|------------------------------------------------------------------------------------------------------------|
| Array         | Ein Array vom Typ Wildcard. Beinhaltet einen Datensatz, der durchlaufen werden soll.                       |
| Break         | Das Ereignis, welches den Durchlauf der Schleife abbricht.                                                 |
| Body          | Das Ereignis, welches nach jeder Iteration durchgeführt wird.                                              |
| Element       | Attribut vom Typ Wildcard. Gibt den Inhalt des Elements der aktuellen Position des Schleifendurchlaufs an. |
| Index         | Attribut vom Typ Int32. Gib an, an welcher Position sich der Schleifendurchlauf gerade befindet.           |
| Complete      | Das Ereignis, welches nach Beendigung des Schleifendurchlaufs ausgeführt wird.                             |

## For Loop

Dieser Knoten ermöglicht es Ihnen, eine For-Schleife zu erstellen, die sich perfekt für Situationen eignet, in denen Sie Aktionen im Arbeitsablauf eine bestimmte Anzahl von Malen wiederholen müssen.

### Flow

![Screenshot 2026-01-13 144951.png](https://doku.evoviu.de/__attachments/a_dc84ba7e12dc61b6dae918471b4bcc9a4993db91cd6dc29b240c649e482602e1/Screenshot%202026-01-13%20144951.png?cb=ee5c32d06862a9288f34d4043188c713)

### Parameterset

| **Parameter** |                                         **Beschreibung**                                         |
|---------------|--------------------------------------------------------------------------------------------------|
| First Index   | Attribut vom Typ Int32. Gibt an, an welcher Position der Schleifendurchlauf beginnen soll.       |
| Last Index    | Attribut vom Typ Int32. Gibt an, an welcher Position der Schleifendurchlauf enden soll.          |
| Break         | Das Ereignis, welches den Durchlauf der Schleife abbricht.                                       |
| Body          | Das Ereignis, welches nach jeder Iteration durchgeführt wird.                                    |
| Index         | Attribut vom Typ Int32. Gib an, an welcher Position sich der Schleifendurchlauf gerade befindet. |
| Complete      | Das Ereignis, welches nach Beendigung des Schleifendurchlaufs ausgeführt wird.                   |

## While Loop

Dieser Knoten ermöglicht die Erstellung einer While-Schleife, in der eine nachfolgende Aktion so lange ausgeführt wird, bis das Break-Ereignis eintritt.  
Wichtig: Achten Sie darauf, keine Endlosschleife zu erstellen, in der das Break-Ereignis nie eintritt.

### Flow

![Screenshot 2026-01-13 145844.png](https://doku.evoviu.de/__attachments/a_ecc10616201f1cdffd6ee65c60d2cde1b1657592ecf9e6dac34c721515e18e35/Screenshot%202026-01-13%20145844.png?cb=100661d1443f07fb2f51607884e51831)

### Parameterset

| **Parameter** |                                **Beschreibung**                                |
|---------------|--------------------------------------------------------------------------------|
| Break         | Das Ereignis, welches den Durchlauf der Schleife abbricht.                     |
| Body          | Das Ereignis, welches nach jeder Iteration durchgeführt wird.                  |
| Complete      | Das Ereignis, welches nach Beendigung des Schleifendurchlaufs ausgeführt wird. |

## Branch

Dieser Knoten funktioniert wie eine Wenn-Dann-Bedingung. Wenn die Eingangsbedingung wahr ist, wird ein Ausführungspfad ausgeführt; andernfalls wird der andere Pfad gewählt.

### Flow

![Screenshot 2026-01-13 144146.png](https://doku.evoviu.de/__attachments/a_b3e71b047a62cc925762f2a93cb7d70130050b7a175201ca2086fd2e63bf8d8a/Screenshot%202026-01-13%20144146.png?cb=76de254ab0b6481ecbd7e1f7ff533050)

### Parameterset

| **Parameter** |                                                            **Beschreibung**                                                            |
|---------------|----------------------------------------------------------------------------------------------------------------------------------------|
| Condition     | Ein Boolean, welches die Prüfbedingung darstellt. Der Wert dieses Attributs entscheidet, ob der Output Then oder Else ausgeführt wird. |
| Then          | Wird ausgeführt, wenn das Attribut Condition dem Wert true entspricht.                                                                 |
| Else          | Wird ausgeführt, wenn das Attribut Condition dem Wert false entspricht.                                                                |

## Sequence By Index

Der Knoten „Sequence By Index" ermöglicht einen klaren und strukturierten Ausführungsablauf, bei dem jeder definierte Teilprozess in der Reihenfolge seiner Eingabe als Index ausgeführt wird. Dies ist besonders nützlich für die Organisation von Arbeitsabläufen, die eine schrittweise Verarbeitung von Aufgaben oder Aktionen erfordern. Beachten Sie, dass die Indizierung bei 0 beginnt, was in der Programmierung üblich ist.

### Flow

![Screenshot 2026-01-13 143919.png](https://doku.evoviu.de/__attachments/a_9965e1fd38b6ae5fe764f8818e37adc0e9b8e2cffb1ee8376b1b3b005ae95eb8/Screenshot%202026-01-13%20143919.png?cb=43d2f3502c9335fe0f349b1b33494aad)

### Parameterset

| **Parameter** |                                                       **Beschreibung**                                                        |
|---------------|-------------------------------------------------------------------------------------------------------------------------------|
| Input         | Eine beliebige Anzahl an Ereignissen, die nacheinander abgearbeitet werden und vom Nutzer individuell bestimmt werden können. |
| Indices       | Ein Array vom Typ Int32. Gibt an, in welcher Reihenfolge die Sequenzen abgearbeitet werden sollen.                            |
| Then          | Wird nach dem Try- oder Catch-Block ausgeführt.                                                                               |

## Sequence

Der Sequence Node ermöglicht einen klaren und strukturierten Ausführungsablauf, bei dem jeder definierte Teilprozess der Reihe nach ausgeführt wird. Dies ist besonders nützlich für die Organisation von Arbeitsabläufen, die eine schrittweise Verarbeitung von Aufgaben oder Aktionen erfordern.

### Flow

![Screenshot 2026-01-13 143555.png](https://doku.evoviu.de/__attachments/a_ed1ac3252920cfef5670831ab4aaf9d60a423cda2f27532fb28966864aa11d4a/Screenshot%202026-01-13%20143555.png?cb=7d1beb4d88ac75a42c39953b0fad2137)

### Parameterset

| **Parameter** |                                                       **Beschreibung**                                                        |
|---------------|-------------------------------------------------------------------------------------------------------------------------------|
| Then          | Eine beliebige Anzahl an Ereignissen, die nacheinander abgearbeitet werden und vom Nutzer individuell bestimmt werden können. |

## Try Catch

Mit diesem Knoten können Sie potenziell fehlerhafte Ausführungspfade Ihres Workflows absichern und im Fehlerfall individuelle Logik implementieren.

### Flow

![Screenshot 2025-11-03 115815.png](https://doku.evoviu.de/__attachments/a_262da1bea9ba569b7e6f0a7a72373ce8fa5481397a97a2b00cc6e97d6643da9b/Screenshot%202025-11-03%20115815.png?cb=083e067bca305b4972e268c742c3de71)

### Parameterset

| **Parameter** |                                         **Beschreibung**                                          |
|---------------|---------------------------------------------------------------------------------------------------|
| Try           | Das Programm wird ausgeführt; tritt eine Ausnahme auf, springt die Ausführung in den catch-Block. |
| Catch         | Wird ausgeführt, nachdem bei der try-Ausführung eine Ausnahme aufgetreten ist.                    |
| Then          | Wird nach dem Try- oder Catch-Block ausgeführt.                                                   |

## Change Variant

Mit diesem Knoten können Sie die während Ihres laufenden Workflows verwendete Variante ändern. Er ähnelt dem Dashboard-Widget, bei dem Sie ebenfalls die Variante ändern können. Die neuen Einstellungen werden ab dem nächsten Durchlauf angewendet.  
Wie Sie Varianten erstellen und konfigurieren können, erfahren Sie unter [working Variablen](https://doku.evoviu.de/de/product-documentation/8.6.0/variablen.md#Verwendung-als-Variantenparameter).

### Flow

![Screenshot 2026-02-25 091450.png](https://doku.evoviu.de/__attachments/a_3c57fe41b9c5b9621bf817b2f6871241cc35527ecbe927c07b47ef460a0ade11/Screenshot%202026-02-25%20091450.png?cb=686e5c9268b57c197eba8a95d8ce6d7a)

### Parameterset

| **Parameter** |                                                                                                     **Beschreibung**                                                                                                     |
|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Variant       | Geben Sie an, welche Variante Sie verwenden möchten. Die Details zu den jeweiligen Varianten finden Sie im Workflow auf der Seite "Variants", zu welcher Sie über die Leiste am oberen Bildschirmrand navigieren können. |

---
version: "8.6.0"
language: "de"
---
# Adobe AEM

Der Adobe Experience Manager (AEM) bietet eine zentrale, leistungsstarke Plattform zur Verwaltung und Bereitstellung digitaler Inhalte -- insbesondere großer Mengen an Bildern, Videos und Dokumenten. Über den integrierten Digital Asset Manager (DAM) können Medieninhalte effizient organisiert, versioniert und zielgerichtet bereitgestellt werden. Der Zugriff auf Assets lässt sich über Benutzerrollen und Workflows gezielt steuern, wodurch eine sichere und kontrollierte Nutzung möglich ist -- auch ohne direkten Zugriff auf das Backend-System. AEM eignet sich ideal für Unternehmen, die konsistente Inhalte über verschiedene Kanäle hinweg zentral verwalten möchten. Dank umfassender Integrationsmöglichkeiten lässt sich AEM flexibel in bestehende Systemlandschaften einbinden. Diese Anleitung zeigt Schritt für Schritt, wie Sie Medien im AEM hochladen, verwalten und für verschiedene Anwendungen bereitstellen.  
Seit Juni 2025 ist die derzeit verwendete Übertragungsmethode des AEM von Adobe veraltet. Bei Bedarf passen wir bei neueren Methoden die Verbindungsmöglichkeit an.

## Authentifizierung

Bisher wird für den AEM Upload Knoten ein Bearer-Token verwendet. Dieser muss vor dem Upload eines Assets korrekt erzeugt werden. Dazu wird eine **.json-Datei**genutzt, welche folgende Form besitzt:
JSON

    {
      "ok": true,
      "integration": {
        "imsEndpoint": "<IMS_ENDPOINT>",
        "metascopes": "<METASCOPES>",
        "technicalAccount": {
          "clientId": "<CLIENT_ID>",
          "clientSecret": "<CLIENT_SECRET>"
        },
        "email": "<EMAIL>",
        "id": "<ID>",
        "org": "<ORG>",
        "privateKey": "-----BEGIN RSA PRIVATE KEY-----\r\n<KEY>\r\n-----END RSA PRIVATE KEY-----\r\n",
        "publicKey": "-----BEGIN CERTIFICATE-----\r\n<KEY>\r\n-----END CERTIFICATE-----\r\n",
        "certificateExpirationDate": "<EXPIRATION_DATE>"
      },
      "statusCode": 200
    }

Referenz:

<https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/implementing/developing/generating-access-tokens-for-server-side-apis>

Dokumentation Adobe:

<https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/assets/admin/developer-reference-material-apis>

## Metadaten

Dokumentation:

<https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/assets/manage/metadata-schemas#edit-metadata-schema-forms>

(möglicherweise in privatem Fenster öffnen aufgrund von Login)

Für die Metadaten müssen die zugrunde liegenden **JCR (Java Content Repository)** Key-Value-Paare als Metadata Items dem Upload Knoten bereitgestellt werden. Die Metadaten können auch **benutzerdefinierte Werte** besitzen - es kommt also immer darauf an, wie das AEM System aufgesetzt wurde und welches Metadaten-Schema verwendet wird.

Es gibt auch Standard-Felder wie z.B.:

* **dc:title** für den Titel

  * "MyTitle"

* **dc:subject** für eine Beschreibung oder Thema

  * "MySubject"

## Verbindungsparameter

|      **Parameter**       |         **Type**          | **Einheit** |                                                                                                                                                                                                                                                                       **Erklärung**                                                                                                                                                                                                                                                                        |                                                                               **Beispiel**                                                                               |
|--------------------------|---------------------------|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Address                  | String                    |             | Definiert die URL bzw. den Endpunkt des AEM-Servers (z. B. `https://author-<AUTHOR-ID>.adobeaemcloud.com`). Darüber wird die Verbindung zur Instanz aufgebaut und der Zugriff auf Assets oder APIs ermöglicht.                                                                                                                                                                                                                                                                                                                                             | https://author-\<AUTHOR-ID\>.adobeaemcloud.com                                                                                                                           |
| **Jwt Credentials File** | JSON-File FileStorageItem |             | Die **.json-Datei** , welche die **Service Credentials** enthält. Kann als Admin **aus dem AEM System erzeugt werden** und muss im Workflow für die Erzeugung eines **Bearer Token** zur Authentifizierung bereitgestellt werden.                                                                                                                                                                                                                                                                                                                          | siehe [https://evopro.atlassian.net/wiki/spaces/DVIU/pages/79921500/working+Adobe+AEM#Authentifizierung](https://doku.evoviu.de/de/product-documentation/8.6.0/adobe-aem.md#Authentifizierung) |
| Target Folder            | String                    |             | Gibt den Pfad an, unter dem Dateien im AEM abgelegt werden. Die Angabe kann ohne den Prefix `/content/dam/` erfolgen -- dieser wird intern automatisch ergänzt und validiert.                                                                                                                                                                                                                                                                                                                                                                              | MeinUnterordner                                                                                                                                                          |
| File Name                | String                    |             | Der Name des Files, so wie er im AEM angezeigt werden soll. Hier muss auf die **Dateiendung**geachtet werden! Je nachdem, welche Dateiendung (.txt, .jpg, .bmp, ...) genutzt wird, wird die Datei im AEM System interpretiert und dementsprechend angezeigt. Beispiel: Der Upload eines `.bmp`-Bildes mit dem File Name "testupload**.txt**" führt dazu, dass ein PDF mit kryptischen Zeichen im AEM System abgelegt wird.                                                                                                                                 | 20250731_meinBild.jpg                                                                                                                                                    |
| **Payload**              | Byte Array                |             | Enthält die digitalen Inhalte (z. B. Bilder, PDFs oder Videos), die in den AEM-DAM hochgeladen werden sollen. Die Daten werden als Byte-Array übertragen und verarbeitet.                                                                                                                                                                                                                                                                                                                                                                                  | Image über "Image to JPG"-Knoten                                                                                                                                         |
| **Metadata Items**       | Metdata Items             |             | Die Metadaten eines AEM Assets werden gesondert erzeugt. Dazu kann über den **Generate Metadata Items (Adobe) Node**ein Array von Key-Value-Paaren erzeugt werden, welches als Input im Upload Node verwendet wird. Einzelne, leere Metadata Items sind nicht zulässig und führen zu einem Fehler bei der Ausführung. Insgesamt müssen aber nicht zwingend Metadata Items definiert werden. Dokumentation: <https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/assets/manage/metadata-schemas#edit-metadata-schema-forms> | Key: dc:title Value: MyTitle                                                                                                                                             |
| Publish                  | Boolean                   |             | Gibt an, ob ein hochgeladenes Asset nach dem Upload automatisch veröffentlicht werden soll. Bei Aktivierung wird das Asset im AEM sofort für die Auslieferung bereitgestellt. Somit werden Daten von der Author-Instanz auf die Public-Instanz weitergeleitet.                                                                                                                                                                                                                                                                                             |                                                                                                                                                                          |

## Workflow Setup

### Anlegen einer AEM Connection

1. Gehen Sie in Workflows unter Components auf ➕.

2. Suchen Sie nach der Komponente "AEM Connection (Adobe)" und wählen Sie diesen Eintrag aus.

3. Es erscheint eine neue Komponente mit dem Namen "AEM Connection (Adobe)". Sie können diese Komponente jederzeit umbenennen, indem Sie einen Doppelklick auf dem Namen der Komponente vornehmen.

4. Tragen Sie hier die Verbindungsparameter ein. Laden Sie im [working File System](https://doku.evoviu.de/de/product-documentation/8.6.0/file-system.md) die entsprechende JSON-Datei zur Authentifizierung hoch und verlinken Sie diese mit dem Jwt Credentials File. Hinterlegen Sie außerdem den passenden Port für den Verbindungsaufbau.

Die Angabe des Ports ist optional. Für die AEM-Instanz kann bspw. der Port 4502 gewählt werden. Falls Ihre Adresse bereits einen Port besitzt, können Sie diesen über den Port-Parameter überschrieben.  
![Screenshot 2026-05-13 104419.png](https://doku.evoviu.de/__attachments/a_c93d8a4dc2f6324bbc39864a7952c0b0a689b86e281052fd7bedd033a6746c4c/Screenshot%202026-05-13%20104419.png?cb=6d43b37d530044651ba708cc5578b863)

5. Öffnen Sie im Event Graph per Rechtsklick das Context-Menü, suchen Sie nach "Get AEM Connection (Adobe)" und wählen Sie diesen Eintrag aus.

Herzlichen Glückwünsch - Sie haben die Komponente für AEM Connection (Adobe) erfolgreich angelegt.

6. Suchen Sie im Context-Menü des Workflows ebenfalls nach "AEM Upload (Adobe)" und wählen Sie diesen Eintrag zum Hinzufügen des Knotens aus.

![c2ad878d-ffca-4463-b35f-90ba62c84ce2#media-blob-url=true&id=31711649-92fd-4aa4-bbf3-8147bd681ed3&contextId=34911936&collection=contentId-34911936](https://doku.evoviu.de/__attachments/a_b339be427b99ad8f8edf3c5f15b8b73a9f34b03197eb4e1d3e68b44e09f6aa55/c2ad878d-ffca-4463-b35f-90ba62c84ce2%23media-blob-url=true&id=31711649-92fd-4aa4-bbf3-8147bd681ed3&contextId=34911936&collection=contentId-34911936?cb=32775b60955c57f3cbad92bdb542fc47)

7. Tragen Sie den Zielordner (Target Folder) und den Dateinamen (File Name) ein.

8. Falls "Metadata Items" benötigt werden, können diese zusätzlich übertragen werden.

![Screenshot 2026-05-13 104252.png](https://doku.evoviu.de/__attachments/a_47ab9ba51393ec73aa072ee475b0e21731df34c6c46fb9c05b1da090bfc2c9d8/Screenshot%202026-05-13%20104252.png?cb=022df999132471f7cae53b033d0421c8)

---
version: "8.6.0"
language: "de"
---
# Alert Widget

## Alert Widget

Damit Sie die zuvor von Ihnen konfigurierten Varianten auch im Workflow nutzen können, müssen Sie dem Graphen einen Get Variable Knoten hinzufügen und den Ausgang mit dem Eingang eines anderen Knotens verbinden, welcher die Werte der Variante nutzen soll. Beachten Sie dabei, dass Sie einen Knoten hinzufügen, dessen Variable für die Varianten markiert wurde.  
![Screenshot 2024-10-24 153622.png](https://doku.evoviu.de/__attachments/a_be5bb77dfebc22bc69f2855786f39e51b01b34b4eb1f2c44556d6412478265f5/Screenshot%202024-10-24%20153622.png?cb=adb8772de5fdb884b9ed1dd864787d84)

Das Alert Widget soll den Fokus verstärkt auf die Anzeige von Ergebnissen setzen. Der Zustand ist schneller erkennbar als durch die ergebnisbezogene Rahmenfarbe. Wenn Sie auf den Button "Add Alert" klicken, erscheint der bereits zuvor erwähnte Dialog mit dem Titel "Link variable with context". Dort werden Ihnen alle Variablen vom Typ boolean angezeigt, wobei Sie exakt einen über eine Checkbox für das Widget aktivieren können. Schließen Sie nach der Auswahl einer Variable den Dialog indem Sie den Button "Confirm" klicken.  
![Screenshot 2024-10-24 151704.png](https://doku.evoviu.de/__attachments/a_0e37248be3b76d3ff4efc6fbf9a48bab7a770285935f2cb60d8f7f4d9cc42a7d/Screenshot%202024-10-24%20151704.png?cb=84e4490737dc37ad030ee4636e3cdbeb)

Sobald Sie Ihrem Widget einen Context zugewiesen haben, ändert sich die Ansicht Ihres Widgets. Sie sehen nicht nur eine geänderte Meldung, sondern statt dem "Add Alert"-Button eine neue Leiste, welche neben der Bezeichnung der ausgewählten Variable auch einen gelben Button mit einem Stift-Icon enthält. Sowohl der Klick auf den Button als auch die Bezeichnung der ausgewählten Variable ermöglicht Ihnen das Bearbeiten Ihrer Auswahl.  
![Screenshot 2024-10-24 151735.png](https://doku.evoviu.de/__attachments/a_414690273fdb5099cbdd3c4d742687dd71d74a2ede11b22d9b1f97babbb38dde/Screenshot%202024-10-24%20151735.png?cb=fc8805e6f2896600c8300156b8d87120)

Da Ihr Alert Widget nun vollständig konfiguriert wurde, können Sie den Workflow starten. Dabei wird der Inhalt des Widgets im Erfolgsfall **grün** gefüllt, im Fehlerfall **rot** . Sollte noch kein Wert vorhanden sein wird eine **gelbe** Füllung gesetzt.  
![Screenshot 2024-10-24 154235.png](https://doku.evoviu.de/__attachments/a_807562e392d0919f3fce3ca5b4337bdbaaeda8b65cf90f2f19f8026e691ff4fc/Screenshot%202024-10-24%20154235.png?cb=d041d9c71fff3e0394b0b4cfc7a0619d)

---
version: "8.6.0"
language: "de"
---
# Allgemeines über evoVIU

In diesem Kapitel finden Sie allgemeine Informationen zu dieser Bedienungsanleitung und zur evoVIU-Kamera.

## Informationen zu dieser Anleitung

* Die folgende Anleitung gilt nur für die Produktserie evoVIU.

* Diese Anleitung ermöglicht einen sicheren Umgang mit dem Produkt.

* Über die Lebensdauer hinweg wird diese Anleitung Teil der Online-Datenbank sein bzw. über die Kamera selbst verfügbar sein. Mit Updates der Kamera wird auch die Dokumentation automatisch aktualisiert. Diese ist ab Version 7.7.0 als PDF im File-Storage zu finden.

* Für die Inbetriebnahme und Nutzung müssen die nationalen Arbeitsschutzbestimmungen sowie die örtlichen Unfallverhütungsvorschriften beachtet werden.

## Symbolerklärung

Die folgenden Signalworte werden in der Produktdokumentation verwendet, um vor Risiko und Gefahren zu warnen.  
**GEFAHR**

kennzeichnet eine unmittelbare Gefährdung mit hohem Risiko, die Tod oder schwere Körperverletzung zur Folge haben wird, wenn sie nicht vermieden wird.  
**WARNUNG**

kennzeichnet eine mögliche Gefährdung mit mittlerem Risiko, die Tod oder (leichte bis schwere) Körperverletzung zur Folge haben kann, wenn sie nicht vermieden wird.  
**HINWEIS**

weist auf die Möglichkeit einer Fehlbedienung hin, bei der das Produkt Schaden nehmen kann.

Diese Signalworte entsprechen der im europäischen Wirtschaftsraum üblichen Definition für zivile Anwendungen. In anderen Wirtschaftsräumen können andere Definitionen existieren. Es ist daher darauf zu achten, dass die hier beschriebenen Signalworte stets nur in Verbindung mit der zugehörigen Produktdokumentation und nur in Verbindung mit dem zugehörigen Produkt verwendet werden. Die Verwendung von Signalworten in Zusammenhang mit nicht zugehörigen Produkten oder nicht zugehörigen Dokumentationen kann zu Fehlinterpretationen und damit zu Personen- oder Sachschäden führen.

## Haftungsbeschränkung

* Das Produkt wurde unter Berücksichtigung des Stands der Technik sowie der geltenden Normen und Richtlinien entwickelt. Technische Änderungen sind vorbehalten.

* Eine Haftung seitens der evopro systems engineering AG (nachfolgend „evopro") ist ausgeschlossen bei:

  * Nichtbeachtung der Anleitung

  * Nicht bestimmungsmäßiger Verwendung des Produktes

  * Einsatz von nicht ausgebildetem Personal

  * Verwendung nicht zugelassener Ersatzteile

  * Nicht genehmigter Modifikation von Produkten

* evopro übernimmt keine Haftung hinsichtlich der mit der Smart Kamera aufgenommenen Bilder. Der Nutzer der Kamera hat Sorge zu tragen, dass die Persönlichkeitsrechte eines jeden durch die Nutzung der Kamera nicht gefährdet werden.

* Diese Betriebsanleitung enthält keine Zusicherung von evopro im Hinblick auf beschriebene Vorgänge oder bestimmte Produkteigenschaften.

* evopro übernimmt keine Haftung hinsichtlich der in dieser Betriebsanleitung enthaltenen Druckfehler oder anderer Ungenauigkeiten, es sei denn, evopro waren die Fehler nachweislich zum Zeitpunkt der Erstellung der Betriebsanleitung bekannt.

## Urheberschutz

* Der Inhalt dieser Anleitung ist urheberrechtlich geschützt.

* Alle Rechte stehen ausschließlich der evopro systems engineering AG zu.

* Ohne die schriftliche Zustimmung von evopro ist die gewerbliche Vervielfältigung oder sonstige gewerbliche Verwendung der bereitgestellten Inhalte und Informationen, insbesondere von Grafiken oder Bildern, nicht gestattet.

---
version: "8.6.0"
language: "de"
---
# Annotations

## Einleitung

Annotations sind Formen, die Sie auf einem Bildbereich einzeichnen, damit diese im Rahmen der weiteren Verarbeitung verwendet werden können. Annotation Sets hingegen gruppieren Ihre Annotationen. Wenn Sie sich bereits intensiver mit den Variablen beschäftigt haben, dann kennen Sie vermutlich bereits die Kategorien. In diesem Fall hier sind die Annotation Sets mit den Kategorien gleichzusetzen.  
**Wichtig:** Unter dem Datentyp Region verstehen wir ein binarisiertes Bild und keinen Bildausschnitt. Die sogenannte Region Of Interest (ROI) kann in Form von Annotationen konfiguriert und an anderen Stellen zum Einsatz kommen.

## Verwaltung von Annotations

Bevor Sie Annotationen anlegen können, muss mindestens ein Annotation Set vorliegen. Dieses muss vorab erstellt werden. Zur Nutzung und Verwaltung von Annotation Sets und Annotations müssen Sie zum einen sicherstellen, dass Sie als aktiver Editor eingeloggt sind, und zum anderen prüfen, dass der Workflow nicht aktiv ist.

### Annotation Sets

#### Hinzufügen von Annotation Sets

In der "My Workflow"-Sektion können Sie Annotation Sets erstellen. Diese Annotation Sets sind eine Sammlung für von Ihnen ausgewählte Annotationen. Wenn Sie auf das Plus-Icon klicken, müssen Sie im Menü Add Annotation Set auswählen, damit Sie anschließend ein Annotation Set erstellen können.

#### Entfernen von Annotation Sets

Wenn Sie mit der Maus über einen Eintrag fahren, taucht auf der rechten Seite ein "Mülleimer"-Icon auf. Mit einem Klick auf dieses wird ein Dialog geöffnet, in dem Sie den Löschvorgang bestätigen müssen.  
**Wichtig:** Annotation Sets können nur entfernt werden, wenn Sie bzw. zugehörige Annotations nicht als Knoten im Workflow verwendet werden. Falls eine Usage vorliegt, so müssen Sie zuerst den Knoten im Workflow entfernen, bevor Sie anschließend auch das Annotation Set entfernen können.

### Annotations

#### Hinzufügen von Annotations

In der "My Workflow"-Sektion können Sie Annotations erstellen. Diese Annotations werden einem Annotation Set zugeordnet. Wenn Sie auf das Plus-Icon klicken, müssen Sie im Menü Add Annotation auswählen, damit Sie anschließend eine Annotation erstellen können. Es öffnet sich ein Dialog, in dem Sie Ihre Annotation einem Annotation Set zuordnen müssen. Außerdem müssen Sie in diesem Dialog angeben um welche Form es sich handeln soll. Dabei stehen folgende "Shapes" zur Verfügung:

* Box

* Circle

* Ellipse

* Line

* Polygon

* Rectangle

Falls Sie Ihr Annotation Set vorab nicht vollständig konfiguriert haben, wird Ihnen ein Warn-Hinweis angezeigt, sobald Sie eine Annotation hinzugefügt haben. Vermutlich fehlt die Auswahl eines Ordners um auf Bilddateien zur Konfiguration zugreifen zu können.  
![Screenshot 2026-05-07 120235.png](https://doku.evoviu.de/__attachments/a_93a4f7bacdcef1902af7939ee72e6b7bb83cb1cc8a0fd5f2a35ef31a95b1004d/Screenshot%202026-05-07%20120235.png?cb=c5a25d86ad90cb25a7c561ead6272395)

Dies können Sie nachträglich erledigen, indem Sie das Annotation Set auswählen und im Tab "Details" auf das Ordner-Symbol beim Attribut "Directory" klicken. Wählen Sie anschließend einen Ordner mit Bilddateien aus und bestätigen Sie den Dialog.

#### Entfernen von Annotations

Wenn Sie mit der Maus über einen Eintrag fahren, taucht auf der rechten Seite ein "Mülleimer"-Icon auf. Mit einem Klick auf dieses wird ein Dialog geöffnet, in dem Sie den Löschvorgang bestätigen müssen.  
**Wichtig:** Annotations können nur entfernt werden, wenn Sie nicht als Knoten im Workflow verwendet werden. Falls eine Usage vorliegt, so müssen Sie zuerst den Knoten im Workflow entfernen, bevor Sie anschließend auch die Annotation entfernen können.

#### Sortieren von Annotations

In der Auflistung der Annotations finden Sie bei jedem Eintrag auf der linken Seite ein Icon mit zwei waagrechten Strichen vor. Wenn Sie darauf klicken und die Taste gedrückt halten, können Sie Einträge innerhalb des Bereichs des Annotation Sets verschieben. Dies ermöglicht Ihnen einen besseren Überblick.

#### Usages von Annotations

Sobald Sie einen Annotation im Event Graph als Knoten hinzufügen, liegt eine Usage vor. Diese erkennen Sie an einem Icon neben der Bezeichnung der Annotation. Wenn Sie auf dieses Icon klicken, öffnet sich ein Dialog in dem die Verwendung der Annotation mit einigen Details aufgelistet wird.

## Nutzung von Annotations im Workflow

Um eine Annotation im Workflow verwenden zu können, fügen Sie den Get-Knoten der jeweiligen Annotation dem Workflow hinzu. Diesen können Sie anschließend mit anderen Knoten verbinden, sofern die zulässigen Verbindungstypen übereinstimmen.

Gängige Knoten, die eine Shape entgegennehmen und verarbeiten sind:

* Crop By Shape

* Draw Shape

* Reduce Domain To Shape

---
version: "8.6.0"
language: "de"
---
# Applikationen

Mit VISIONWEB können Sie zahlreiche Applikationen durchführen. Verschiedenste Bildverarbeitungsaufgaben, vom Auslesen von Texten und Codes über die Erkennung von Konturen bis hin zur Lokalisierung bestimmter Merkmale oder der Segmentierung anhand von Schwellwerten - all das ist möglich innerhalb des Workflows. Zusätzlich hält die VIU2 weitere spezifische Anwendungsfälle bereit wie die Dashcam-Funktionen für das industrielle Umfeld oder die Nutzung von YOLO-Netzen in Kombination mit ONNX und NPU.  

|                                                   **Bereich**                                                   |                                                                                                 **Beschreibung**                                                                                                 |
|-----------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [**Bildverarbeitungstools VisionTools**](https://doku.evoviu.de/de/product-documentation/8.6.0/bildverarbeitungstools-visiontools.md) |                                                                                                                                                                                                                  |
| [Code \& Text](https://doku.evoviu.de/de/product-documentation/8.6.0/code-text.md)                                                    | Lesen Sie 2D-Codes, Data Matrix Codes oder Texte in englischer oder deutscher Sprache aus.                                                                                                                       |
| [Contour](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md)                                                           | Nutzen Sie Operatoren wie Sobel, Laplacian oder Werkzeuge wie Find Pattern um Konturen hervorzuheben oder gar ganze Muster zu identifizieren.                                                                    |
| [Filter](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md)                                                             | Mit arithmetischen Operationen wie Emphasize oder Pow können Kontrast, Helligkeit und Schärfe angepasst werden. Des Weiteren sind Transformationen wie das Spiegeln oder die Korrektur von Verzerrungen möglich. |
| [Image](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md)                                                               | Verwenden Sie zahlreiche Werkzeuge zur Bearbeitung Ihrer Bilder. Schneiden Sie diese zurecht, zeichnen Sie diverse Formen ein und führen Sie Histogramm-Berechnungen durch.                                      |
| [Locate](https://doku.evoviu.de/de/product-documentation/8.6.0/locate.md)                                                             | Ermitteln Sie Schnittpunkte, identifizieren Sie Kanten und entdecken Sie unterschiedliche Kreise innerhalb einer Region.                                                                                         |
| [Measure](https://doku.evoviu.de/de/product-documentation/8.6.0/measure.md)                                                           | Berechnen und ermitteln Sie Winkel oder Abstände in den unterschiedlichsten Kombinationen.                                                                                                                       |
| [Region](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md)                                                             | Führen Sie Operationen wie das Zählen oder Invertieren von Pixeln anhand Binärbilder durch.                                                                                                                      |
| [Segmentation](https://doku.evoviu.de/de/product-documentation/8.6.0/segmentation.md)                                                 | Nehmen Sie die Berechnung von Schwellwerten anhand unterschiedlicher Methoden wie Adaptive, Binary oder Color vor.                                                                                               |
| **VIU2-spezifische Applikationen**                                                                              |                                                                                                                                                                                                                  |
| [Industrial Dashcam](https://doku.evoviu.de/de/product-documentation/8.6.0/industrial-dashcam.md)                                     | Analysieren Sie Störungen und die Nachverfolgung von Problemen im Produktionsumfeld anhand einer kontinuierlichen Aufzeichnung.                                                                                  |
| [ONNX](https://doku.evoviu.de/de/product-documentation/8.6.0/onnx.md)                                                                 | Führen Sie Bildklassifizierungen oder Objekterkennungen mithilfe eines Modells im ONNX-Format durch.                                                                                                             |
| [NPU](https://doku.evoviu.de/de/product-documentation/8.6.0/npu.md)                                                                   | Identifizieren Sie Objekte indem Sie die Rechenoperation direkt auf einer neuronalen Verarbeitungseinheit ausführen.                                                                                             |

---
version: "8.6.0"
language: "de"
---
# Array-Operationen

## Clear Array

Mit diesem Knoten können Sie ein Array eines beliebigen Typs leeren. Das ursprüngliche Array bleibt unverändert - stattdessen wir ein neues, leeres Array zurückgegeben.

### Flow

![Screenshot 2026-01-14 154236.png](https://doku.evoviu.de/__attachments/a_852cde6f23351708e4f3191d9bf4d96fda71eaa40f893779686537b1a42856f5/Screenshot%202026-01-14%20154236.png?cb=3a9f1fdb3720d3a1ef2fe24d4a0d7180)

### Parameterset

| **Parameter** |      **Typ**      |                      **Beschreibung**                      |
|---------------|-------------------|------------------------------------------------------------|
| Array         | Wildcard\<Array\> | Ein Array von beliebigem Typ, welches geleert werden soll. |
| Return        | Wildcard\<Array\> | Ein neues, leeres Array von beliebigem Typ.                |

---
version: "8.6.0"
language: "de"
---
# Autofokus

In diesem Kapitel finden Sie allgemeine Informationen zur Bedienung des Autofokus.

Mit dem Autofokus soll es möglich sein innerhalb weniger Sekunden sofort die benötigten Werte für eine scharfe Bildaufnahme zu ermitteln. Dieser Wert wird automatisch gesetzt und bei jeder weiteren Bildaufnahme mit dieser Bildquelle verwendet.  
Aber: Wenn sich das Objekt oder der Abstand verändern, dann muss auch der Autofokus neu konfiguriert werden um weiterhin die optimale Bildaufnahme gewährleisten zu können.

Damit der Autofokus ermittelt werden kann, muss immer eine Konfiguration der Image Source aktiv sein, sowohl zur Konfiguration als auch für die Ausführung und Berechnungen.

## Konfigurationsbetrieb

### Konfigurieren einer Region

#### Bottom App Bar

Wenn sie einen bestimmten Bildbereich fokussieren möchten, können sie den Konfigurationsmodus in der Bottom App Bar der Bildquelle aktivieren. Sobald dieser aktiv ist, wird auf dem zuletzt aufgenommenen Bild eine Region dargestellt. Diese kann hinsichtlich ihrer Größe und ihrer Position angepasst werden. In der linken oberen Ecke über dem Bild können Sie die exakten Koordinaten und Abmessungen Ihrer Region einsehen, diese aber auch bearbeiten.  
![Screenshot 2025-12-04 102451.png](https://doku.evoviu.de/__attachments/a_d761d66a4ddbeeed6fdd4ef8ef53345691b5731e8da500beaa752bcc8d98f3e0/Screenshot%202025-12-04%20102451.png?cb=b20541c792cb731fb9ea10002c5a64f8)

#### Image Source / Focus

In der Image Source können sie in der rechten Leiste sämtliche Einstellungsmöglichkeiten vornehmen. Im Bereich Focus können Sie die eingestellte Fokuslänge, die Focus length, einsehen. Über den manuellen Fokus kann diese händisch angepasst werden. Falls sie den Autofokus verwenden, wird, sobald die Berechnung abgeschlossen ist, die Focus length automatisch angepasst.

## Live Betrieb

### Starten des Autofokus

#### Bottom App Bar

Zum Starten der Berechnung des Autofokus können Sie neben dem Button zur manuellen Bildaufnahme den Start-Button benutzen. Sobald Sie diesen angeklickt haben, erscheint ein Dialog in dem Sie bestätigen müssen, dass Sie den Prozess starten möchten.  
![Screenshot 2025-11-06 095221.png](https://doku.evoviu.de/__attachments/a_99f7ae63cafe6628eede46f18d26733415edd7f7d52e5693bdda0cbcd7167ebb/Screenshot%202025-11-06%20095221.png?cb=708be8ced3567fcd6c1dd7d201bda96b)  
![Screenshot 2025-12-04 102533.png](https://doku.evoviu.de/__attachments/a_69299e554ec339696f98dd597e0df8f12ada42af79956f350feb9ecb6ca00b9b/Screenshot%202025-12-04%20102533.png?cb=d346289d932c7e0a965b6d8e3491a222)

Nachdem Sie den Start des Autofokus bestätigt haben, wechselt der Start-Button sein Aussehen und bietet Ihnen die Stopp-Funktion zum Beenden der Berechnung an. Während der Berechnung des Autofokus ist es nicht möglich Transformationen am Bild durchzuführen. Es ist ebenfalls nicht möglich Bilder abzuspeichern.  
![Screenshot 2025-12-04 102554.png](https://doku.evoviu.de/__attachments/a_30473f73ff597fec0e577f3ce2689af8c4315f39b793362b18ce945d772cac40/Screenshot%202025-12-04%20102554.png?cb=ae300dc0fd22d46cde1f7563599ee335)

#### Navigation / Navigation Rail

Falls Sie gerne mit einer ausgeklappten, detaillierten Navigation arbeiten, kennen Sie möglicherweise bereits den Bereich Active Process am linken, unteren Bildschirmrand. Hier können Sie Informationen über den zurzeit aktiven Prozess auslesen und diesen steuern. Sobald der Autofokus gestartet wurde, wechselt der Process Type von Image Source zu Autofocus. Über diese Anzeige können Sie jederzeit zur Konfiguration wechseln oder den aktiven Prozess stoppen.

### Stoppen des Autofokus

In der Bottom App Bar neben dem Button zur manuellen Bildaufnahme befindet sich die Schaltfläche zum vorzeitigen Beenden des Autofokus. Über einen Dialog werden Sie zunächst aufgefordert Ihre Entscheidung zum Stoppen der Berechnung des Autofokus zu Bestätigen. Anschließend wird die Berechnung gestoppt, während zugleich der zuletzt vorhandene Wert beibehalten wird.

Wenn die Berechnung des Autofokus jedoch über den natürlichen Wege zum Ende findet, wird der Autofokus automatisch beendet, der ermittelt Wert unter Focus length gesetzt und der Button zum Stoppen verschwindet bzw. wechselt wieder zum Start-Button.

### Ergebnisse des Autofokus

Sobald der Fokuswert ermittelt wurde, können Sie auch die detaillierten Ergebnisse einsehen. Neben der Dauer, dem Ergebnis sowie dem besten Fokuswert können Sie auch die Details der Berechnung samt Bilder nachvollziehen. In der Leiste am unteren Bildschirmbereich werden Ihnen diese Informationen links neben den Buttons zur Steuerung des Autofokus angezeigt. Zusätzlich existiert eine erweiterte Detailanzeige in Form eines Overlays, welche Sie über den Button **Show More** öffnen können.  
![Screenshot 2025-12-04 102941.png](https://doku.evoviu.de/__attachments/a_24eb1e93066a214b5265f9677fde4c880d1305f291724b7173e678d77c207768/Screenshot%202025-12-04%20102941.png?cb=d8cff2ba89f842e30bf2d9d06bfb07e4)

---
version: "8.6.0"
language: "de"
---
# AWS

Der Amazon S3 (Simple Storage Service) von AWS bietet eine leistungsstarke und flexible Möglichkeit, große Mengen unstrukturierter Daten -- wie Bilder, Videos oder Dokumente -- sicher in der Cloud zu speichern. Über sogenannte Zugriffsschlüssel und vordefinierte Berechtigungsrichtlinien (IAM-Rollen oder signierte URLs) kann der Zugriff auf die gespeicherten Inhalte präzise gesteuert und individuell freigegeben werden. So lassen sich Daten ortsunabhängig hochladen, abrufen und verarbeiten -- ohne direkte Interaktion mit der AWS-Konsole. Amazon S3 eignet sich ideal für Anwendungen, die eine zentrale, skalierbare und hochverfügbare Datenablage erfordern. Darüber hinaus unterstützt der Dienst verschiedene Speicherklassen, Zugriffsebenen und Integrationen, wodurch er sich nahtlos in bestehende Workflows und Applikationen einfügt. Diese Anleitung zeigt Schritt für Schritt, wie Sie Amazon S3 konfigurieren, Daten hochladen und sicher verwalten.

## Verbindungsparameter

|   **Parameter**   |    **Type**     | **Einheit** |                                                                                                                                 **Erklärung**                                                                                                                                 |                              **Beispiel**                              |
|-------------------|-----------------|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------|
| Payload           | Byte Array      |             | Das Byte Array enthält die zu übertragenden Daten der Nachricht. Es kann verschiedene Dateiformate umfassen, z. B. Bilder, Videos oder andere Dateien, die hochgeladen werden sollen.                                                                                         | Image aus "Image to JPG"-Knoten                                        |
| Region            | String          |             | Definiert die AWS-Region, in der der S3-Bucket angelegt ist. Sie beeinflusst Latenz, Verfügbarkeit und gesetzliche Anforderungen an die Datenspeicherung. Die Region kann nicht beliebig gewählt werden, sondern steht schon bei der Anlage von AWS bzw. des S3 Storage fest. | [Liste von AWS](https://docs.aws.amazon.com/general/latest/gr/s3.html) |
| Bucket            | String          |             | Bezeichnet den Namen des S3-Buckets, in dem Dateien gespeichert werden. Der Name muss global eindeutig sein und wird beim Hochladen und Abrufen von Dateien verwendet.                                                                                                        | pictures                                                               |
| Access Key Id     | String          |             | Ein öffentlicher Identifikator für die AWS-Zugangsdaten. Er wird zusammen mit dem Secret Key verwendet, um authentifizierte Zugriffe auf den S3-Dienst zu ermöglichen.                                                                                                        | `AKIAIOSFODNN7EXAMPLE`                                                 |
| Secret Access Key | String - Secret |             | Der private Teil der AWS-Zugangsdaten. Er wird zur Authentifizierung benötigt und sollte niemals öffentlich gespeichert oder übertragen werden.                                                                                                                               | `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY`                             |
| Directory         | String          |             | Gibt einen Unterordner im Bucket an. Existiert dieser bereits, werden Daten dort gespeichert. Andernfalls wird er automatisch erstellt. Ohne Angabe erfolgt die Speicherung direkt im Bucket.                                                                                 | meinUnterordner                                                        |
| Filename          | String          |             | Definiert den Namen der zu übertragenden Datei. Der Dateiname kann dynamisch generiert werden und wird gemeinsam mit der Datei gespeichert, um eine eindeutige Identifikation zu ermöglichen.                                                                                 | 20250731_112200_bild1.jpg                                              |
| Timeout           | Integer         | ms          | Bestimmt die maximale Zeit für die Datenübertragung. Sobald das zeitliche Limit erreicht ist, wird der Vorgang abgebrochen und der Workflow mit einem entsprechenden Hinweis fortgesetzt.                                                                                     | 5000                                                                   |

## Workflow Setup

### Upload Files an AWS

1. Öffnen Sie mit einem Rechtsklick das Context-Menü und suchen Sie dort nach dem Knoten "Upload (AWS S3 Storage)".

![image-20250805-211941.png](https://doku.evoviu.de/__attachments/a_95cab8e32a1973c31fb72c9135bdb94cde98d512405fca9fc0b96b14550628f5/image-20250805-211941.png?cb=3c87166733d5b9530547cea7b003e360)

2. Geben Sie nun Ihre Verbindungsparameter für den Upload ein:

   1. Region: eu-central-1 für Frankfurt, siehe [Liste von AWS](https://docs.aws.amazon.com/general/latest/gr/s3.html)

   2. Access Key Id: `AKIAIOSFODNN7EXAMPLE`

   3. Secret Access Key hinterlegen

   4. Bucket: pictures

![image-20250805-212458.png](https://doku.evoviu.de/__attachments/a_0f3d9eef3d75eebc7723b3e7a05c799d1d2d1b28e212429775bb1089be05b792/image-20250805-212458.png?cb=71ab3dc3d7f0560078f3e431618cf2d1)

3. Verbinden Sie die anderen Parameter dynamisch oder hinterlegen Sie feste Werte.

Im gezeigten Beispiel werden Dateiname und Ordnername dynamisch erzeugt. Der Ordner wird für jeden Tag neu angelegt und mit den Bildern befüllt, die an genau diesem Tag aufgenommen werden. Die Bilder erhalten Dateinamen die auf einer Kombination aus Datum und Zeitstempel basieren.  
![image-20250805-212732.png](https://doku.evoviu.de/__attachments/a_8a1699f5a37fb65859d9b73df3f9a18e5f0017e13cf69468891f87e2ece27401/image-20250805-212732.png?cb=07286cb1e4676ff8a9e15abbcd15fd83)  
Herzlichen Glückwunsch! Sie können nun erfolgreich Daten in die Cloud hochladen.  
Falls es zu Problemen kommt: Prüfen Sie bitte, ob Ihre IT die Firewall für das System freigegeben hat.

4. Über die Outputs "Success" und "Message" erhalten Sie Rückmeldungen über den Sendestatus und ggf. mögliche Fehlerhinweise.

![image-20250805-212814.png](https://doku.evoviu.de/__attachments/a_a987f20194f009b47b2f46998b29d279efa420266668383ba04aa6c71f3b54d3/image-20250805-212814.png?cb=cc6505cfc1188ce3857c0c68fa47e4b5)

## Fun Fact

Mit dem nachfolgenden Flow können Sie übrigens ganz schnell Bilder von Azure zu AWS kopieren. Zur Anlage der Azure Storage Blob Camera verwenden Sie die Anleitung [working Azure](https://doku.evoviu.de/de/product-documentation/8.6.0/azure.md)  
![image-20250805-213127.png](https://doku.evoviu.de/__attachments/a_671b391f3ef91ff8d804f4ce396519e2aa6defb86d52b0a910819c6397fcc561/image-20250805-213127.png?cb=1d986ad5b4526620d47acd5f48b28e0a)

*** ** * ** ***

## Upload File (AWS)

Statt einem Byte Array, können Sie auch direkt auf Dateien aus dem File System der Kamera zurückgreifen und diese Uploaden.

Mit diesem Knoten können Sie Dateien in Ihren Amazon S3-Speicher (Bucket) hochladen. Die erforderlichen Parameter erhalten Sie entweder durch die Einrichtung eines Speichers in AWS oder von Ihrem IT-Administrator. Amazon S3 (Simple Storage Service) ist ein skalierbarer, schneller, webbasierter Cloud-Speicherdienst für die Online-Datenspeicherung und den Datenabruf von überall. S3 wird häufig für Datensicherung, Content-Distribution, Big-Data-Analysen und als Speicher für Anwendungen verwendet, die in AWS gehostet werden.  
Wichtig:

Der direkte Zugriff auf die AWS-Cloud aus einem Produktionsnetzwerk ist möglicherweise nicht sofort möglich, da hierfür spezielle Zugriffsrechte erforderlich sind, die von Ihrem Systemadministrator konfiguriert werden müssen.

### Flow

![Screenshot 2026-03-18 082227.png](https://doku.evoviu.de/__attachments/a_b168e9663bb7aa45b4e91d9c2fdc28cfd36a355f685750ec7c4bb5b9e2b5089b/Screenshot%202026-03-18%20082227.png?cb=b98cb67fa8923eafb5ef39d430416cf6)

**Parameterset**  

|   **Parameter**   |    **Type**     | **Einheit** |                                                                                                                                 **Erklärung**                                                                                                                                 |                              **Beispiel**                              |
|-------------------|-----------------|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------|
| Payload           | File Store Item |             | Die Daten sollen als Dateispeicherelement hochgeladen werden.                                                                                                                                                                                                                 |                                                                        |
| Region            | String          |             | Definiert die AWS-Region, in der der S3-Bucket angelegt ist. Sie beeinflusst Latenz, Verfügbarkeit und gesetzliche Anforderungen an die Datenspeicherung. Die Region kann nicht beliebig gewählt werden, sondern steht schon bei der Anlage von AWS bzw. des S3 Storage fest. | [Liste von AWS](https://docs.aws.amazon.com/general/latest/gr/s3.html) |
| Bucket            | String          |             | Bezeichnet den Namen des S3-Buckets, in dem Dateien gespeichert werden. Der Name muss global eindeutig sein und wird beim Hochladen und Abrufen von Dateien verwendet.                                                                                                        | pictures                                                               |
| Access Key Id     | String          |             | Ein öffentlicher Identifikator für die AWS-Zugangsdaten. Er wird zusammen mit dem Secret Key verwendet, um authentifizierte Zugriffe auf den S3-Dienst zu ermöglichen.                                                                                                        | `AKIAIOSFODNN7EXAMPLE`                                                 |
| Secret Access Key | String - Secret |             | Der private Teil der AWS-Zugangsdaten. Er wird zur Authentifizierung benötigt und sollte niemals öffentlich gespeichert oder übertragen werden.                                                                                                                               | `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY`                             |
| Directory         | String          |             | Gibt einen Unterordner im Bucket an. Existiert dieser bereits, werden Daten dort gespeichert. Andernfalls wird er automatisch erstellt. Ohne Angabe erfolgt die Speicherung direkt im Bucket.                                                                                 | meinUnterordner                                                        |
| Filename          | String          |             | Definiert den Namen der zu übertragenden Datei. Der Dateiname kann dynamisch generiert werden und wird gemeinsam mit der Datei gespeichert, um eine eindeutige Identifikation zu ermöglichen.                                                                                 | 20250731_112200_bild1.jpg                                              |
| Timeout           | Integer         | ms          | Bestimmt die maximale Zeit für die Datenübertragung. Sobald das zeitliche Limit erreicht ist, wird der Vorgang abgebrochen und der Workflow mit einem entsprechenden Hinweis fortgesetzt.                                                                                     | 5000                                                                   |

---
version: "8.6.0"
language: "de"
---
# Azure

Der **Blob Storage** von **Microsoft Azure** bietet eine leistungsstarke und flexible Möglichkeit, Daten -- insbesondere große Mengen unstrukturierter Daten wie Bilder, Videos oder Dokumente -- sicher in der Cloud zu speichern. Über sogenannte **SAS-Schlüssel (Shared Access Signatures)** kann der Zugriff auf die gespeicherten Inhalte kontrolliert und individuell freigegeben werden. Dies ermöglicht es, Daten ortsunabhängig hochzuladen, zu teilen und weiterzuverarbeiten -- ohne dass eine direkte Verbindung zum Azure-Portal erforderlich ist. Azure Blob Storage eignet sich ideal für Anwendungen, bei denen eine zentrale, skalierbare und hochverfügbare Datenablage benötigt wird. Zusätzlich unterstützt die Plattform verschiedene Zugriffsebenen und Integrationen, wodurch sie sich hervorragend in bestehende Workflows oder Applikationen einbinden lässt. Diese Anleitung zeigt Schritt für Schritt, wie Sie den Blob Storage einrichten, Daten hochladen und sicher verwalten.

Bei evoVIU gibt es derzeit zwei Möglichkeiten das Azure Blob Storage zu verwenden:

1. Upload (Azure Storage Blob): Ermöglicht das Hochladen von Bildern in den Blob Storage.

2. Azure Storage Blob Camera: Ermöglicht Nutzern das Herunterladen von Bildern aus einem Storage, was sich besonders gut zum Testen eines Workflows mit vorher hinterlegten Bildern eignet.

## Zugang \& SAS-Schlüssel erzeugen

Für die Verbindung zum Azure Storage wird ein **Token** benötigt, der über einen Microsoft Azure Account erzeugt werden kann. ([Mehr Infos auf Microsoft Azure](https://azure.microsoft.com/de-de/pricing/purchase-options/azure-account))

Bei "Alle Ressourcen" kann ein neuer Container angelegt werden, welcher wie ein Art Speicherbereich zu verstehen ist und der mit Unterverzeichnissen aufgefüllt werden kann. ([Mehr Infos auf Microsoft Azure](https://learn.microsoft.com/de-de/azure/storage/common/storage-account-create?tabs=azure-portal))

Nach erfolgreicher Erstellung kann der Blob Storage eingesehen werden:

**Home/Alle Ressourcen/\<DeinBlobStorage\> → Speicherbrowser → Blobcontainer**  
![image-20250805-195149.png](https://doku.evoviu.de/__attachments/a_a8c7ba6fceee854f3c6663da9e0ec0bc04cf1cd8e32ad7de8e0bd9302ddc4c79/image-20250805-195149.png?cb=c36403f9a491c812ca8f4c79fcbe7a6a)

Für eine Verbindung ist ein **Token** notwendig, der über das **Dreipunkt-Menü → SAS generieren** erzeugt werden kann. Dafür sollte ein passender Blobcontainer genutzt bzw. angelegt werden.  
![image-20250805-200558.png](https://doku.evoviu.de/__attachments/a_14dc452c3ae585e3a22b53e8fd4d3aa91957afa450ed8014ca6081a659541ef2/image-20250805-200558.png?cb=bb51ec9c96ff26a143a600deed72be5e)

Beim Erstellen einer neuen SAS sollte darauf geachtet werden, dass der **gültige Zeitraum nicht länger als zwei Jahre** beträgt! Generell ist dies aber eine freie Entscheidung und nur eine Empfehlung unsererseits. Außerdem kann es vorkommen, dass Sie angeben müssen, ob nur **HTTPS** oder auch **HTTP**benötigt wird.  
Wir empfehlen die Verbindung über HTTPS !  
![Screenshot 2024-12-02 100703.png](https://doku.evoviu.de/__attachments/a_0ac0a142cec20f587c556cb36ed76cacb0fc81b6528c661222df2bda2427c50d/Screenshot%202024-12-02%20100703.png?cb=42947ab0163bc2aa556b1f3a7c713471)

Ebenfalls müssen die erforderlichen Berechtigungen zur Verfügung stehen, um Ordner erstellen und Daten speichern zu können. Bitte überlegen Sie gut, welche Rechte ausreichend sind und welche besser nicht zur Verfügung stehen sollten.  
In den meisten Fälle sind folgende Rechte ausreichend:

* Read

* Add

* Create

* Write

* Delete

![image-20250805-200924.png](https://doku.evoviu.de/__attachments/a_92e1a160ed76fe748385c3a42801f48ce019443e6a50f151c61e9604489d9245/image-20250805-200924.png?cb=3c435cb8703b20467dcc5f71198a7815)

Nachdem die Konfiguration vorgenommen und eine SAS erstellt wurde, erhält man einen **Token** und eine **URL** . Diese können dazu verwendet werden, um im Workflow mit dem **Upload (Azure Storage Blob)**Knoten in einem Azure Blobcontainer Daten abzulegen.

Die URL setzt sich so zusammen:

    <Adresse>/<Blobcontainer>?<Token>

Am Beispiel einer Beispielumgebung:

    https://evoviudocumentation.blob.core.windows.net/pictures?<Token>

Herzlichen Glückwunsch! Sie haben gerade erfolgreich einen eigenen Blob Storage auf Microsoft Azure erstellt.

## Upload Azure Storage Blob

### Verbindungsparameter

#### 1. Upload - Parameter

| **Parameter** |    **Type**     | **Einheit** |                                                                                            **Erklärung**                                                                                            |                      **Beispiel**                      |                                                                        **Upload**                                                                         |                                                                     **Azure Camera**                                                                      |
|---------------|-----------------|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
| Payload       | Byte Array      |             | Das Byte Array enthält die zu übertragenden Daten der Nachricht. Es kann verschiedene Dateiformate umfassen, z. B. Bilder, Videos oder andere Dateien, die hochgeladen werden sollen.               | Image aus "Image to JPG"-Knoten                        | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) |                                                                                                                                                           |
| Address       | String          |             | Die Zieladresse definiert den Endpunkt in der Cloud, an den Daten gesendet werden. Sie wird meist von der IT bereitgestellt oder direkt über Microsoft Azure ermittelt.                             | [https://evoviudocumentation.blob.core.windows.net](#) | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) |
| Token         | String - Secret |             | Der Token wird bei der Erstellung des SAS-Schlüssels generiert. Er dient zur Authentifizierung und kann ausschließlich als geheimes Element (Secret) im System hinterlegt werden.                   | \<DeinToken\>                                          | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) |
| Container     | String          |             | In Azure ist der Container der definierte Speicherbereich für Daten. Er wird je nach Anwendungsfall erstellt und kann über die evoVIU gezielt mit Unterordnern befüllt werden.                      | pictures                                               | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) |
| Directory     | String          |             | Gibt einen Unterordner im Container an. Existiert dieser bereits, werden Daten dort gespeichert. Andernfalls wird er automatisch erstellt. Ohne Angabe erfolgt die Speicherung direkt im Container. | myUnterordner                                          | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) |                                                                                                                                                           |
| Filename      | String          |             | Definiert den Namen der zu übertragenden Datei. Der Dateiname kann dynamisch generiert werden und wird gemeinsam mit der Datei gespeichert, um eine eindeutige Identifikation zu ermöglichen.       | 20250731_112200_meinbild.jpg                           | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) |                                                                                                                                                           |
| Timeout       | Integer         | ms          | Legt die maximale Dauer für die Datenübertragung fest. Wird diese Zeit überschritten, wird der Vorgang abgebrochen und der Workflow mit entsprechendem Hinweis fortgesetzt.                         | 5000                                                   | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) |                                                                                                                                                           |
| Cycle Images  | Boolean         |             | Steuert das Bildauswahlverhalten beim Download. Es wird entweder stets das erste Bild verwendet oder es werden verschiedene Bilder nacheinander abgerufen, je nach Einstellung.                     | True                                                   |                                                                                                                                                           | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) |
| Is Lazy       | Boolean         |             | Aktiviert den Lazy-Load-Modus. Bilder werden nicht gleichzeitig, sondern nacheinander heruntergeladen, was Ressourcen spart und die Ladezeit optimieren kann.                                       | True                                                   |                                                                                                                                                           | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) |
| Color         | Dropdown        |             | Bestimmt das Farbformat der heruntergeladenen Bilder. Je nach Einstellung werden die Bilder z. B. in Farbe, Graustufen oder anderen Formaten konvertiert und gespeichert.                           | Color                                                  |                                                                                                                                                           | ![check mark](https://doku.evoviu.de/__attachments/a_ef45c4ef3461f165f8b218e576eeaa365d9d20f4631b40ee3a6dfcf297fb3d14/atlassian-check_mark?cb=a10212e1c1021c5194f7535b6843f955) |

### Workflow Setup

#### Upload Files to Azure

1. Öffnen Sie mit einem Rechtsklick das Context-Menü und suchen Sie nach dem Knoten "Upload (Azure Storage Blob)".

![image-20250805-202457.png](https://doku.evoviu.de/__attachments/a_1940cf9bc7bd3166f14273990c7556c77d6ac4e11da1114a1eca0d6647518f34/image-20250805-202457.png?cb=1a1671a73d2de535869f68fbf392bec2)

2. Geben Sie nun Ihre Verbindungsparameter für den Upload-Knoten ein:

   1. Address: [https://evoviudocumentation.blob.core.windows.net](https://evoviutest.blob.core.windows.net/)

   2. Token: Dein Token aus SAS

   3. Container: pictures

![image-20250805-203226.png](https://doku.evoviu.de/__attachments/a_f65a7c4f728902b6c41d269ee6fccb6dda19ff8002758d0257d3703a66f0bd6b/image-20250805-203226.png?cb=02f8b99bdf815063cb2787832b1bce63)

3. Verbinden Sie die anderen Parameter dynamisch oder hinterlegen Sie feste Werte.

Im gezeigten Beispiel werden Dateiname und Ordnername dynamisch erzeugt. Der Ordner wird für jeden Tag neu angelegt und mit den Bildern befüllt, die an genau diesem Tag aufgenommen werden. Die Bilder erhalten Dateinamen die auf einer Kombination aus Datum und Zeitstempel basieren.  
![image-20250805-203320.png](https://doku.evoviu.de/__attachments/a_945fa0e7fc3769983d9769ece56d65a90cf069dad504bcd88147c5d7106e6185/image-20250805-203320.png?cb=d545d568dcbff24c04efe1fbc194791d)
Dynamische Erzeugung von Filename und Directory

Alternativ kann man Dateiname und Ordnername fest hinterlegen, jedoch wird dann diese Datei immer wieder überschrieben.  
![image-20250805-203554.png](https://doku.evoviu.de/__attachments/a_e706117ddc006d2d7a8533a1511d14b49098d1448b4ab8103437d731b7481687/image-20250805-203554.png?cb=4037f05efbb8564a2006bd5254420307)
Beispiel für feste Dateinamen- und Ordnerbeschreibung  
Herzlichen Glückwunsch! Sie können nun erfolgreich Daten in die Cloud hochladen.  
Falls es zu Problemen kommt: Prüfen Sie bitte, ob Ihre IT die Firewall für das System freigegeben hat.

4. Über die Outputs "Success", "Status Code" und "Message" erhalten Sie Rückmeldungen über den Sendestatus und ggf. mögliche Fehlerhinweise.

![image-20250805-204526.png](https://doku.evoviu.de/__attachments/a_bff328c0200db4307d1af777fa5878df3991187c456aee02d559201b17bf8006/image-20250805-204526.png?cb=ed8f4dadf6ca46b2df8db82c73958f48)
Beispiel zur Ausgabe der Rückgabewerte nach dem Sendeversuch

#### Azure Blob Storage Camera

1. Gehen Sie in Workflows unter Components auf ➕.

2. Suchen Sie im Menü nach der Komponente "Azure Blob Storage Camera".

![image-20250805-205053.png](https://doku.evoviu.de/__attachments/a_b952d17f5463c4d97af2a1569e79549a930ec10be81f29f7d5038e832fda2c67/image-20250805-205053.png?cb=f0946eeb510ff628fce4e5a3bb3a3c58)

3. Es erscheint eine neue Komponente mit dem Namen "Azure Blob Storage Camera". Sie können diese Komponente jederzeit umbenennen, indem Sie einen Doppelklick auf das Label vornehmen.

4. Tragen Sie die Verbindungsparameter ein und entscheiden Sie, ob die Bilder nacheinander kommen und nacheinander geladen werden sollen. Entscheiden Sie auch, ob die Bilder in Farbe konvertiert werden soll.

![image-20250805-205308.png](https://doku.evoviu.de/__attachments/a_88c832ce7de7a9c61175bced0a93c5225113f1699e8636b7e4c49c3efa9f10c1/image-20250805-205308.png?cb=46c8f6b498211f668a6e512054a3daa2)  
In der derzeitigen Version ist der Token der Kamera nicht als Secret hinterlegt. Dies wird zeitnah angepasst.

5. Öffnen Sie im Event Graph per Rechtsklick das Context-Menü, suchen Sie nach "Get Azure Storage Blob Camera" und wählen Sie diesen Eintrag aus.

Herzlichen Glückwünsch - Sie haben die Komponente für die Azure Blob Storage Camera erfolgreich angelegt!

6. Suchen Sie im Context-Menü des Workflows ebenfalls nach "Grab Image" und wählen Sie diesen Eintrag aus. Verbinden Sie diesen Knoten mit dem Knoten "Get Azure Storage Blob Camera".

![image-20250805-205642.png](https://doku.evoviu.de/__attachments/a_7359bf3bd3c465440e4e29e8315171bf696543313639389c0ffe6b1bbc8602b9/image-20250805-205642.png?cb=ba812bca2086474bceb756565542d22b)  
Herzlichen Glückwünsch - Sie können nun je Iteration Bilder aus der Cloud herunterladen und verarbeiten.

## Upload CSV (Azure Table)

Azure Table ist eine skalierbare Cloud-Speicherlösung zum Speichern von Daten in Tabellen. Die Daten werden mithilfe von Partitionsschlüsseln sowie Zeilen- und Spaltenschlüsseln gespeichert, um einen einfachen Zugriff ähnlich einem Datenblatt zu ermöglichen.  
Wichtig:

Der direkte Zugriff auf die Azure-Cloud aus einem Produktionsnetzwerk ist möglicherweise nicht sofort möglich, da hierfür spezielle Zugriffsrechte Ihres Systemadministrators erforderlich sein können. Die verwendete Tabelle muss bereits vorhanden sein, bevor dieser Knoten verwendet werden kann.  
![Leeres Tabellen Fenster.png](https://doku.evoviu.de/__attachments/a_6a948893761ef0c65907c8a40fd185d0c7243640dc47d9c550f4081fe75e2b84/Leeres%20Tabellen%20Fenster.png?cb=2850fa10bde27e9c23a465beb007fe98)

Wählen Sie zum Hinzufügen einer Tabelle in Ihrem Storage den Eintrag "Tabelle" aus. Vermutlich werden zunächst keine Elemente gefunden, dies ist jedoch nicht weiter schlimm. Im nächsten Schritt erzeugen wir eine Tabelle. Klicken Sie hierzu auf "Tabelle hinzufügen".  
![Erstellen einer Tabelle.png](https://doku.evoviu.de/__attachments/a_b6458d1d0169a2dd1507c40fb8ffe434bba9f4978843d535c9aa6e278637c49f/Erstellen%20einer%20Tabelle.png?cb=e13ca72e7e7200a6bdb0613ed35ce5f8)

Sobald Sie den Dialog mit Inhalt befüllt und die Eingabe bestätigt haben wird Ihnen unter Tabellen der erste Eintrag, in diesem Fall "Test", angezeigt. In der Übersicht werden der Name sowie die zugehörige URL aufgelistet.  
![Tabellen Fenster mit Test Tabelle und geöffnenten Untermenu.png](https://doku.evoviu.de/__attachments/a_4174113c225a72ae467d0b7f5837ee2be769daff73b59911b4ec92cddb56f4bf/Tabellen%20Fenster%20mit%20Test%20Tabelle%20und%20ge%C3%B6ffnenten%20Untermenu.png?cb=33f40c54166aefa5b5e95536c01727bd)

Wenn ein Eintrag erstellt wird, können Sie dort u.a. den Partition Key angeben.  
![Leere Tabelle Test.png](https://doku.evoviu.de/__attachments/a_f6af891bb9e7807308c2f5f947379dc000d82fbbaeb409adea92a3d6c2d42b66/Leere%20Tabelle%20Test.png?cb=bd9ac34a8bc9b991308dc635fd76dac9)

### Verbindungsparameter

| **Parameter** |    **Type**     | **Einheit** |                                                                                   **Erklärung**                                                                                   |                      **Beispiel**                      |
|---------------|-----------------|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------|
| CSV           | CSV             |             | Die in die Tabelle hochzuladenden Daten.                                                                                                                                          | Image aus "Image to JPG"-Knoten                        |
| Address       | String          |             | Die Zieladresse definiert den Endpunkt in der Cloud, an den Daten gesendet werden. Sie wird meist von der IT bereitgestellt oder direkt über Microsoft Azure ermittelt.           | [https://evoviudocumentation.blob.core.windows.net](#) |
| Table Name    | String          |             | Name der Tabelle in Azure                                                                                                                                                         | Test                                                   |
| Partition Key | String          |             | Der Partitionsschlüssel ist ein eindeutiger Bezeichner für die Partition innerhalb einer gegebenen Tabelle.                                                                       |                                                        |
| Token         | String - Secret |             | Der Token wird bei der Erstellung des SAS-Schlüssels generiert. Er dient zur Authentifizierung und kann ausschließlich als geheimes Element (Secret) im System hinterlegt werden. | \<DeinToken\>                                          |
| Timeout       | Integer         | ms          | Legt die maximale Dauer für die Datenübertragung fest. Wird diese Zeit überschritten, wird der Vorgang abgebrochen und der Workflow mit entsprechendem Hinweis fortgesetzt.       | 5000                                                   |
| Row Keys      | Header Row      |             | Weist jeder Zeile der CSV-Datei einen Schlüssel zu. Falls ein Schlüssel fehlt, wird die Zeile automatisch fortlaufend ab 0 nummeriert.                                            | Row                                                    |
| Column Keys   | Header Row      |             | Weist jeder Spalte der CSV-Datei einen Schlüssel zu. Falls ein Schlüssel fehlt, wird die Spalte automatisch fortlaufend ab 0 nummeriert.                                          | Column                                                 |

### Workflow Setup

#### Upload CSV To Azure

1. Öffnen Sie mit einem Rechtsklick das Context-Menü und suchen Sie nach dem Knoten "Upload CSV (Azure Table)".

![Screenshot 2025-12-10 124402.png](https://doku.evoviu.de/__attachments/a_b1d66eac5b8dce8824487bea329ceab8a1363f479efa6a8e60678bed17967ed2/Screenshot%202025-12-10%20124402.png?cb=ff3590c6b779ebef89cd43a766227371)

2. Geben Sie nun Ihre Verbindungsparameter für den Upload-Knoten ein:

   1. Address: [https://evoviudocumentation.blob.core.windows.net](https://evoviutest.blob.core.windows.net/)

   2. Table Name: Deine Bezeichnung der Tabelle aus Azure

   3. Partition Key: Dein Partition Key der Tabelle aus Azure

   4. Token: Dein Token aus SAS

   5. Timeout: 5000

   6. Row Keys: Row

   7. Column Keys: Colum

![Screenshot 2025-12-10 125607.png](https://doku.evoviu.de/__attachments/a_159af69222a4d0a62dd900ec9f7c5b580dcd0a231e674094cb579c31b09a9cc2/Screenshot%202025-12-10%20125607.png?cb=de7d57b21c43c1b908da0775e8e67a8c)

3. Verbinden Sie die anderen Parameter dynamisch oder hinterlegen Sie feste Werte.

Herzlichen Glückwunsch! Sie können nun erfolgreich Daten in die Cloud hochladen.  
Falls es zu Problemen kommt: Prüfen Sie bitte, ob Ihre IT die Firewall für das System freigegeben hat.

4. Über die Outputs "Success", "Status Code" und "Message" erhalten Sie Rückmeldungen über den Sendestatus und ggf. mögliche Fehlerhinweise.

![Screenshot 2025-12-10 125423.png](https://doku.evoviu.de/__attachments/a_b590a000909f6bfe9113099e612d8f0319160a67099be4c35ab22ce5793e1b70/Screenshot%202025-12-10%20125423.png?cb=98b2f93c9b143a3e5f81f03d1142392d)  
Herzlichen Glückwünsch - Sie können nun je Informationen in Ihre Azure Table schreiben.

*** ** * ** ***

## Upload File (Azure Blob)

Statt einem Byte Array, können Sie auch direkt auf Dateien aus dem File System der Kamera zurückgreifen und diese Uploaden.

Mit diesem Knoten können Sie Daten als Datei in einen Azure Storage Blob hochladen. Die erforderlichen Parameter erhalten Sie entweder durch die Erstellung eines Blob-Speichers in Azure oder von Ihrem IT-Administrator. Azure Storage Blob ist eine skalierbare Cloud-Speicherlösung zum Speichern unstrukturierter Daten wie Text- oder Binärdaten in Form von „Blobs" (Binary Large Objects). Sie wird häufig zum Speichern von Dateien, Backups, Mediendateien und großen Datensätzen verwendet und bietet Optionen für sicheren Zugriff, Redundanz und die Integration mit anderen Azure-Diensten.  
Wichtig:

Der direkte Zugriff auf die Azure-Cloud aus einem Produktionsnetzwerk ist möglicherweise nicht sofort möglich, da hierfür spezielle Zugriffsrechte erforderlich sind, die von Ihrem Systemadministrator konfiguriert werden müssen.

### Flow

![Screenshot 2026-03-18 081124.png](https://doku.evoviu.de/__attachments/a_193a3f2065e15ae6476683b0b82157eba8e60879a353efb408304d1e1662c029/Screenshot%202026-03-18%20081124.png?cb=c7e3c010b473cc973a61e8030c44f64c)

### Parameterset

| **Parameter** |    **Type**     | **Einheit** |                                                                                   **Erklärung**                                                                                   |                      **Beispiel**                      |
|---------------|-----------------|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------|
| Payload       | File Store Item |             | Gibt das Dateielement an, das Sie an Azure senden möchten.                                                                                                                        | Image aus dem File System                              |
| Address       | String          |             | Die Zieladresse definiert den Endpunkt in der Cloud, an den Daten gesendet werden. Sie wird meist von der IT bereitgestellt oder direkt über Microsoft Azure ermittelt.           | [https://evoviudocumentation.blob.core.windows.net](#) |
| Token         | String - Secret |             | Der Token wird bei der Erstellung des SAS-Schlüssels generiert. Er dient zur Authentifizierung und kann ausschließlich als geheimes Element (Secret) im System hinterlegt werden. | \<DeinToken\>                                          |
| Container     | String          |             | Der Container, in den Sie Dateien hochladen können.                                                                                                                               | evoVIU                                                 |
| Directory     | String          |             | Das Verzeichnis der Datei.                                                                                                                                                        | evoVIU Blob Storage                                    |
| Filename      | String          |             | Der Dateiname, den die hochgeladenen Daten im Azure-Speicher erhalten sollen.                                                                                                     | my-file                                                |
| Timeout       | Integer         | ms          | Legt die maximale Dauer für die Datenübertragung fest. Wird diese Zeit überschritten, wird der Vorgang abgebrochen und der Workflow mit entsprechendem Hinweis fortgesetzt.       | 5000                                                   |

---
version: "8.6.0"
language: "de"
---
# Bild-Editor

Mit dem Bild-Editor soll es möglich sein, den Prozessablauf und die Bildverarbeitung auf der evoVIU mit nur einem einzigen Workflow zu optimieren. Dabei sollen die zur Prüfung notwendigen Informationen auf einem realitätsnahen Referenzbild eingezeichnet und über verschiedene Knoten im Workflow genutzt werden können.

## Konfigurationsbetrieb

### Hinterlegen von Referenzbildern

Für die Nutzung des Bild-Editors werden Referenzbilder für die erstmalige Konfiguration benötigt. Idealerweise wird zu Beginn über eine Image Source die Bildaufnahme bestmöglich eingestellt. Die dort getätigten Probeaufnahmen können in den Bereich Files zur weiteren Verwendung abgespeichert werden.

Wenn Sie den Workflow mit all seinen Tabs geöffnet haben, entdecken Sie mit Sicherheit auch den Tab "**Image** ". Neben einigen Toolbars befindet sich dort am unteren Rand auch eine Leiste, welche zunächst leer ist und nur eine Nachricht mit dem Inhalt "**Select an Image Annotation**" enthält. Hier müssen Sie im Tab My Workflow im Bereich Annotations ein Set auswählen. Im Details Tab des Sets können Sie ein Verzeichnis hinterlegen. In diesem Verzeichnis befinden sich idealerweise Bilddateien, die den Aufnahmen im späteren Produktivbetrieb entsprechen. Sobald Sie ein Verzeichnis ausgewählt haben, können Sie die Annotation konfigurieren. Diese Konfiguration findet nun wieder im Tab Image statt. Das Bild bzw. initial das erste Bild des Ordners wird Ihnen dort nun angezeigt.  
![Screenshot 2025-11-03 091018.png](https://doku.evoviu.de/__attachments/a_a67ef1bf9b76d1f1bbe1a79bcdce86a96eca87717028ec898fa1ce1632a6ffef/Screenshot%202025-11-03%20091018.png?cb=3cb30fff7b9963142275b47d16ffe194)

Bitte beachten Sie, dass Sie als aktiver Bearbeiter auf der Kamera eingeloggt sein müssen, damit Sie all diese Konfigurationsschritte durchführen können.

### Verwalten von Annotationen

Damit wir Bildausschnitte markieren können, müssen wir vorab Sets und Annotationen anlegen. Da jede Annotation einem Set zugewiesen werden muss, beginnen wir mit dem Erstellen eines Image Annotation Sets.

#### Anlegen von Sets

Im Tab "**My Workflow** " befindet sich der Bereich "**Regions \& Annotations**", in dem Sie ein neues Set erstellen können. Das Set wird ohne zusätzlichen Einstellungen zunächst als leeres Set ohne Annotationen angelegt und automatisch in der Liste angezeigt. Klicken Sie in der Bereichsüberschrift auf den Plus-Button zum Erstellen eines Annotation Sets.

Wie zuvor bereits erwähnt: Wenn Sie ein Set ausgewählt haben, können Sie im Details Tab einen Ordner aus dem File System hinterlegen. Die darin enthaltenen Bilder können Sie anschließend zur Konfiguration der im Set enthaltenen Annotationen verwenden. Initial wird das erste Bild des Ordners automatisch ausgewählt.

#### Anlegen von Annotationen

Sobald mindestens ein Image Annotation Set vorhanden ist, kann über den gleichen Ablauf auf Ebene des Sets über den Plus-Button eine Annotation erstellt werden. Im Menü müssen Sie eine Form auswählen, damit klar ist, wie die Darstellung erfolgen soll und welche Funktionen zur Konfiguration bereitgestellt werden müssen.

#### Annotationstypen

Zur Konfiguration von Annotation können Sie aus einer Reihe von unterschiedlichen Formen auswählen. Aktuell stehen Ihnen folgende Annotationstypen zur Verfügung:

* Box

* Circle

* Ellipse

* Line

* Polygon

* Rectangle

![Screenshot 2025-11-03 091250.png](https://doku.evoviu.de/__attachments/a_1b771783dc0893042809910e37e5799e2446682201f4f20d294e51ac7e60ba8f/Screenshot%202025-11-03%20091250.png?cb=68dbd10c57a6e95beac5be6f5d6fc1d5)

#### Editieren

In dieser Liste können Sie die erstellten Sets und Annotation anschließend auch bearbeiten. Durch einen Doppelklick auf den Listeneintrag können Sie die vorhandenen Einträge bearbeiten. Sobald der Fokus nicht mehr auf dem Eingabefeld liegt, werden die Änderungen übernommen.

#### Entfernen

Wenn Sie eine Annotation nicht mehr benötigen, dann können Sie diese Löschen indem Sie mit der Maus über den Eintrag fahren und das Mülleimer-Icon am rechten Seitenrand des Tabs klicken. In einem Dialog müssen Sie anschließend bestätigen, dass Sie die Annotation wirklich entfernen möchten. Es muss lediglich sichergestellt sein, dass die aufgelisteten Einträge nicht als Knoten im Workflow verwendet werden.

Bei Sets hat das Entfernen weitreichendere Auswirkungen. Auf der einen Seite muss sichergestellt sein, dass die im Set enthaltenen Annotationen nicht im Workflow als Knoten verwendet werden. Andererseits müssen Sie sich als Nutzer bewusst sein, dass das Entfernen eines Sets automatisch auch die ihm zugeordneten Annotationen entfernt. Unabhängig der durchgeführten Aktionen können Sie nach dem Entfernen eines Eintrags den Tabelleneintrag nicht mehr einsehen und natürlich auch nicht mehr nutzen.

#### Verschieben

Sowohl Sets als auch Annotationen können über das Drag-Handle Icon vor der Bezeichnung des Elements per Drag \& Drop verschoben werden. Annotationen können jedoch immer nur innerhalb des Sets verschoben werden.

#### Verwendung von Annotationen (Usages)

![Screenshot 2025-11-03 133845.png](https://doku.evoviu.de/__attachments/a_58141ff840adfa20aee49612b7566d73548f60cb3aa80bb7d82d246695ca9d3f/Screenshot%202025-11-03%20133845.png?cb=ccc9ae7f4dad3104294273f43b0f8ca8)

Im Bereich Regions \& Annotations werden Ihre erstellten Annotationen aufgelistet. Sobald ein Workflow mit einem Knoten, der eine Annotation abbildet, befüllt wird, liegt zur Annotation eine Usage vor. Die Verwendung der Annotation hat zur Folge, dass sie nicht gelöscht werden kann. Das Löschen ist nur dann möglich, wenn im Workflow der Knoten entfernt wurde.

### Konfigurieren von Annotationen

#### Image Toolbar

Zur Konfiguration von Annotationen benötigen Sie neben angelegten Annotationen vor allem den Tab "**Image**" im Workflow. Zuvor haben wir bereits beim Punkt "Hinterlegen von Referenzbildern" angerissen, was für die Nutzung des Bild-Editors benötigt wird. Zum Befüllen und Konfigurieren des Bild-Editors benötigen Sie die Image Toolbar, welche im Tab "Image" am unteren Ende als schmale Leiste zu finden ist.

Da wir die Annotation so konfigurieren wollen, dass es für den späteren Betrieb die richtigen Daten und Ausschnitte vorhanden sind, empfehlen wir Ihnen zur Vorbereitung folgendes Vorgehen:

* Starten Sie die Bildquelle, welche Sie später im Workflow nutzen wollen

* Stellen Sie sich, dass die Einstellungen des Streams (Scaling und Quality) auf 100% gesetzt sind

* Nehmen Sie ein paar Bilder auf und optimieren Sie die Einstellungen Ihrer Bildquelle

* Speichern Sie die Bilder, welche Ihren Erwartungen und Ihrem Qualitätsstandard entsprechen, ab

Wenn Sie Bilder in einem Ordner abgelegt haben und das Annotation Set bereits dementsprechend konfiguriert haben, dann können Sie diese in der unteren Leiste bereits mindestens ein Bild sehen.  
![Screenshot 2025-11-03 134940.png](https://doku.evoviu.de/__attachments/a_a24a449784438f8963e88079ea462321a2ed4375a1a3b9c1b275c25e012941de/Screenshot%202025-11-03%20134940.png?cb=822414042f2ebaddbca50f47c541acdf)

##### Anzeige-Eigenschaften eines Bilds zum Konfigurieren einer Annotation

Wählen Sie nun ein Bild aus dieser Leiste aus indem Sie es anklicken. Das Bild erhält nun einen gelben Rahmen und wird in der Mitte des "**Image**"-Tabs groß visualisiert. Ihre Auswahl ist allerdings nie endgültig. Sie können jederzeit auch ein anderes Bild aus der Liste auswählen oder sogar das Verzeichnis wechseln um Zugriff auf andere Bilder zu erhalten.

Über einen Button in der linken, unteren Ecke (über der Image Toolbar) können Sie die Skalierung des angezeigten Bilds individuell an Ihre Bedürfnisse anpassen. Wir empfehlen Ihnen die Option "**Scale To Fit**", da das Bild so komplett und im richtigen Bildverhältnis ohne Verzerrung dargestellt wird. So haben Sie stets alles im Blick.

Mit der Option "**Original size**" wird das Bild in seiner tatsächlichen Größe dargestellt, was bei zu geringer Bildschirmgröße dazu führen kann, dass Teile des Bilds nicht sofort sichtbar, aber über Scrollbars erreichbar sind. Wenn Sie sehr genau arbeiten müssen wird diese Darstellungsoption bevorzugt.

##### Fortgeschrittene Nutzung der Image Toolbar

Damit eine noch realistischere Konfiguration möglich ist, können Sie nach der initialen Konfiguration auch Ihren Workflow starten. Stellen Sie zuvor allerdings sicher, dass Sie die über den Knoten Grab Image aufgenommenen Bilder auch an eine Variable vom Typ "**Image**" weitergeben und diese veröffentlicht ist. Dies erlaubt Ihnen das Abspeichern des zuletzt, vom Workflow aufgenommenen Bilds über den Speicher-Button in der Image Toolbar, egal ob zur Lauf- oder zur Konfigurationszeit.

#### Konfigurieren der Position einer Annotation

![Screenshot 2025-10-30 164340.png](https://doku.evoviu.de/__attachments/a_3b8035fab9374ef861f7808e2fb1b036881bb0f07f367ef57a5dfcf2719358b3/Screenshot%202025-10-30%20164340.png?cb=6f7c55bf18ca47ea8066c0b9a6b1e67c)

Wenn wir davon ausgehen, dass Sie ein Bild ausgewählt haben, können Sie zur Konfiguration einer Annotation nun im Tab "**My Workflow**" eine zuvor angelegte Annotation auswählen und anklicken. Im Tab "Image" wird nun auf dem ausgewählten Bild eine Form eingezeichnet. Die Position und Größe dieser Form können Sie nun beliebig bearbeiten. Sobald Sie den Fokus anderweitig setzen, werden die vorgenommenen Einstellungen, in diesem Fall die Koordinaten, übernommen. Mit diesen Daten können Sie im Workflow weiterarbeiten.  
![Screenshot 2025-11-03 143838.png](https://doku.evoviu.de/__attachments/a_e900871b0dac19f24ae086d1d9f583a7364ac9159a3f8468375bd4fe9081fb4a/Screenshot%202025-11-03%20143838.png?cb=10d989b4631b0645828325a4916d89ae)

Die Größe und Position Ihrer Annotation können Sie im Details Tab einsehen und konfigurieren, sofern Sie die Annotation ausgewählt haben.

#### Image Tool Selector

Für ausgewählte Werkzeuge stehen oberhalb der Image Toolbar zusätzliche Informationen und Einstellungsmöglichkeiten zur Verfügung. Diese werden in Abhängigkeit des ausgewählten Werkzeugs individuell angezeigt und sind nur in dieser Konstellation sichtbar.

##### Auswahl und Transformation

Sofern eine Annotation und dieses Werkzeug ausgewählt ist, können Sie die Größe und Position Ihrer Annotation konfigurieren.  
![Screenshot 2025-11-03 135944.png](https://doku.evoviu.de/__attachments/a_0d2ca35fbec15982a6e7eab4ae6dcd1c5169627dddf531e155bcf90ccc2e2060/Screenshot%202025-11-03%20135944.png?cb=1830134b4fabcb3de752dca8bdcef00b)

##### Pfad-Werkzeug

Wenn Sie eine Annotation vom Typ Polygon ausgewählt haben, dann können Sie auch das Pfad-Werkzeug nutzen. Damit ist es möglich einzelne Punkte zu selektieren, neu zu positionieren und weitere Punkte an beliebigen Stellen hinzuzufügen. Um weitere Punkte hinzufügen zu können, müssen Sie auf einer Linien einen Doppelklick durchführen. Anschließend wird der neue Punkt hinzugefügt. Falls Sie einen Punkt ausgewählt haben, sehen Sie in der unteren Leiste bspw. die tatsächlichen Koordinaten.  
![Screenshot 2025-11-03 140223.png](https://doku.evoviu.de/__attachments/a_4ad2327222adf7283bd5014ea7e09adbe04bebc68206faa759c11097629e0cf3/Screenshot%202025-11-03%20140223.png?cb=d2a8d0cb04477e444d9d86a74991dace)

##### Referenzpunkte

Mit dem Werkzeug zur Auswahl von Referenzpunkten können Sie Live-Informationen zu bestimmten Bildbestandteilen in Form von Positions- und Farbwerten erhalten. Sobald Sie sich in diesem Modus befinden, werden Ihnen Pixelausschnitte vergrößert in Form einer Lupe angeboten. Diese Informationen können Sie zum Setzen von Referenzpunkten verwenden.  
![Screenshot 2025-11-03 142608.png](https://doku.evoviu.de/__attachments/a_f1bfb6fd3e9409665604a0b72075dbb7a1229c36c3e7e2c5bf0f2bbd8ef02f3e/Screenshot%202025-11-03%20142608.png?cb=62c1f983ed59f931291248c31f94e4e6)

Wenn Sie ein Merkmal oder eine Position auf einem Bild ausgemacht haben, können Sie per Klick einen Marker setzen. In der unteren Leiste werden Ihnen die Positions- und Farbwerte zu diesem Referenzpunkt angezeigt. Diese Informationen können Sie nun für weitere Vergleiche nutzen.  
![Screenshot 2025-11-03 142655.png](https://doku.evoviu.de/__attachments/a_41e04b41747bd21726fbd3b9b3132fa1710e3576f3e18a42d329c0d53d977adc/Screenshot%202025-11-03%20142655.png?cb=a48e9025e64d61d4b1d2bc23ee6028bb)

Es besteht zudem die Möglichkeit einen zweiten Referenzpunkt zu setzen. Dies erleichtert den Vergleich. Alle weiteren Klicks überschreiben die bereits bestehenden Referenzpunkte. Bitte beachten Sie, dass die Referenzpunkte nach dem erneuten Laden der Seite nicht mehr vorhanden sind und erneut gesetzt werden müssen, da es sich um ein Werkzeug mit temporären Werten handelt. Wenn Sie einen Referenzpunkt entfernen möchten, so wählen Sie diesen aus und nutzen die Entfernen-Funktion im Image Tool Selector.  
![Screenshot 2025-11-03 142720.png](https://doku.evoviu.de/__attachments/a_75378d0d92d06b4367474497e46930923c732a3f784e16ac3c047c2a19ba3999/Screenshot%202025-11-03%20142720.png?cb=02c0aec2d553b10a67d6a9360363ac21)

##### Duplizieren

Ein weiteres nützliches Feature stellt unsere Duplizier-Funktion dar. Wenn gewisse Parameter einer Annotation für Sie bei einer weiteren Annotation relevant sind, dann bietet sich das Duplizieren der bereits vorhandenen Annotation an. Es ermöglicht Ihnen jedoch auch generell ein schnelleres Hinzufügen von Annotationen.

##### Entfernen

Selbstverständlich ist es auch möglich eine Annotation wieder zu entfernen.

##### Sichtbarkeit

Sollten Sie mal aufgrund einer Vielzahl an Annotationen im Bild-Editor den Überblick verlieren, dann können Sie die aktuell ausgewählte Annotation auch ausblenden. Damit die ausgeblendete Annotation wieder eingeblendet werden kann, müssen Sie diese im Tab "**My Workflow** " im Bereich "**Annotations**" selektieren.

##### Fixierung

Sobald Sie mit der Konfiguration hinsichtlich der Positionierung Ihrer Annotation zufrieden sind, können Sie diese auch fixieren. So vermeiden Sie Fehlkonfigurationen, falls Sie in einem unachtsamen Moment die Annotation doch nochmal bearbeiten.

#### Konfigurieren von Anzeige-Eigenschaften einer Annotation

Im Tab "**Image**" befinden sich im unteren Teil des Image Tool Selectors weitere Funktionen mit denen die ausgewählte Annotation bezüglich ihrer optischen Darstellung angepasst werden kann. Sie dient hauptsächlich dazu den Überblick zu behalten und ermöglicht Ihnen eine bessere Unterscheidung und Sichtbarkeit der Annotationen.

##### Rahmenstärke

Um die Annotation deutlich kenntlich zu machen, können unterschiedliche Linienstärken gesetzt werden. Diese reichen von einem Pixel bis hin zu 16 Pixeln.  
![Screenshot 2025-11-03 142057.png](https://doku.evoviu.de/__attachments/a_55ca97c0564015906f39973f7f7e31f6a614fd862edfc3fb02a6c63066efaeba/Screenshot%202025-11-03%20142057.png?cb=609a99af643486fd2a24e10be75737d6)

##### Rahmen

Oftmals ist es nützlich, wenn die Rahmen von Annotationen in unterschiedlichen Farben dargestellt werden. So fällt die Zuordnung von Annotation in der Regel leichter. Es kann aber auch sehr wichtig sein, wenn die Farben des Bildes und die initiale Rahmenfarbe hinsichtlich des Kontrast zu ähnlich sind. So kann eine bessere Sichtbarkeit ermöglicht werden.  
![Screenshot 2025-11-03 142252.png](https://doku.evoviu.de/__attachments/a_b4cac60bdf3f9c12900831bfdcfe20a8fa3a6a025e0bb54b09fd86a1d30ce7ef/Screenshot%202025-11-03%20142252.png?cb=c699fb81d1855af493fc4e1ef30706ba)

##### Füllung

Vielleicht wollen Sie Ihre Annotation auch mit einer Füllung kennzeichnen. Die Konfiguration bzw. die Farbauswahl ist auch über die Eingabe von HTML-Farbcodes möglich. Das Zurücksetzen der ausgewählten Farbe ist ebenfalls möglich. Statt der Füllung wird der Inhalt der Annotation transparent dargestellt. Initial wird die Deckkraft einer Füllung auf 50% gesetzt.  
![Screenshot 2025-11-03 142409.png](https://doku.evoviu.de/__attachments/a_de2d64b73790d728722ea43e992a09fb20050a06bb5cb374da9521ca72c88ea2/Screenshot%202025-11-03%20142409.png?cb=1840ae1a29376cbe0fe5de444c63bab7)

##### Deckkraft

Um den Kontrast und die Sichtbarkeit einzelnen Annotationen zu verbessern, kann auch die Einstellung der Deckkraft einer Annotation eine nützliche Alternative darstellen. Sie können hier zwischen 0 und 100% wählen.  
![Screenshot 2025-11-03 142440.png](https://doku.evoviu.de/__attachments/a_3f41162dff610c2d381e0715bd9a6eaebf4629bc90e9bb3c72200f31a5f9c5f2/Screenshot%202025-11-03%20142440.png?cb=78937e05f15fefee2e9035891380a15c)

#### Nutzung des Ebenen-Modells

Es gibt mitunter Konstellationen in denen mehrere Annotationen in Bezug auf Ihre Position und Koordinaten eine Schnittmenge besitzen. Wenn Sie nun eine bestimmte Annotation weiter bearbeiten wollen, diese jedoch von einer anderen Annotation überdeckt wird, wird das Ebenen-Modell relevant.  
![Screenshot 2024-05-15 160126.png](https://doku.evoviu.de/__attachments/a_5688ec48cd7dd75dd971c9a887e4d1fb45d4346920b402555a7972a7ed72e8d8/Screenshot%202024-05-15%20160126.png?cb=30786a453a7285b168e433463e8f5a70)

Dieses Ebenen-Modell legt die Annotation in aufsteigender Reihenfolge übereinander. Wenn Sie also eine neue Annotation erstellen, wird diese am unteren Ende der Liste in Ihrem Set eingereiht, vom Ebenen-Modell ab an die erste, demnach oberste, Position gesetzt. Über den Drag-Handle der Annotation in der Auflistung der im Set enthaltenen Annotationen können Sie die Anordnung ändern.

### Einbinden von Annotationen im Workflow

Doch wie können Sie nun dieser Annotationen in Ihrem Workflow nutzen? Stellen Sie sich einfach vor Sie möchten aus Performance-Gründen zur Verarbeitung bestimmter Daten nur einen bestimmten Teil des Bildes betrachten. Dieser bestimmte Teil des Bildes entspricht letztendlich Ihrer Annotation. Nutzen Sie für diesen Fall einen "**Crop By Shape**" Knoten.  
![Screenshot 2025-05-26 104652.png](https://doku.evoviu.de/__attachments/a_e8fb4dbccfbb5601f058e7f9d1633b117a46e1122faefa6b90f47cc28cf4e664/Screenshot%202025-05-26%20104652.png?cb=0deb66712ae76ce0e4c5058a3897dd21)

Dieser Knoten benötigt eingehende Daten vom Typ "**Shape** ". Dies kann bspw. im Detail eine Annotation vom Typ **"Rectangle"** sein. Die konfigurierte Annotation kann als Knoten dem Workflow hinzugefügt werden und kann die benötigten Daten vom Typ "**Rectangle**" bereitstellen. So kann die vorgenommene Annotation effektiv für die Verarbeitung von Daten eingesetzt werden.  
Alle von Ihnen angelegten Annotationen werden im Context-Menü des Workflows aufgelistet und können darüber Ihrem Graphen hinzugefügt werden.

## Live-Betrieb

Die Nutzung des Bild-Editors unterscheidet sich im Live-Betrieb in einigen wesentlichen Punkten von der Nutzung im Konfigurationsbetrieb.

### Anlegen von Bild-Variablen

Für die Nutzung des Bild-Editors im Live-Betrieb werden Variablen benötigt, welche dem Typ "Image" entsprechen. Sie müssen vorab im Konfigurationsbetrieb angelegt werden. Außerdem ist es wichtig im zugehörigen Details-Tab den Wert der Variable zu abonnieren, indem Sie den Wert des Attributs **"Publish Value"** auf **"true"** setzen.  
![Screenshot 2025-05-26 111204.png](https://doku.evoviu.de/__attachments/a_ba0321ac653de64121ac281b103aefab34badb98826bb02ba879e9e4d4f2549d/Screenshot%202025-05-26%20111204.png?cb=36bfac5010c71a99aabd67197c70409e)

Abonnieren Sie den Wert von mindestens einer Variable, damit die Variable als Knoten im Workflow hinzugefügt werden kann. Der zugehörige Wert dieser Variable kann anschließend im Live-Betrieb im Tab "Image" eingesehen werden. Dazu müssen Sie in der unteren Leiste die als Bild in Miniaturansicht dargestellte Variable auswählen.

### Anzeige von Annotationen zur Laufzeit

Selbstverständlich können Sie auch Annotationen zur Laufzeit anzeigen. Sie müssen lediglich sicherstellen, dass ein Bild und eine Annotation ausgewählt sind. Aber beachten Sie bitte, dass eine Bearbeitung von Annotationen zur Laufzeit aktuell nicht möglich ist.

Wie bereits zuvor erwähnt können Sie auch reale Bildaufnahmen zur Optimierung Ihrer Konfiguration nutzen, indem Sie ein zur Laufzeit aufgenommenes Bild auswählen und den Speicher-Button in der Image Toolbar nutzen. Anschließend öffnet sich ein Dialog, in dem Sie einen Ordner zur Ablage des zu speichernden Bilds auswählen können.

---
version: "8.6.0"
language: "de"
---
# Bildaufnahme

Die Bildaufnahme über **VISIONWEB**bildet den zentralen Ausgangspunkt für die Arbeit mit der evoVIU-Plattform. Mit VISIONWEB lassen sich Kameramodule sowohl lokal als auch remote ansprechen, konfigurieren und flexibel in Workflows einbinden. Dabei werden nicht nur reine Kameradaten erfasst, sondern auch zusätzliche Funktionen wie Lichtsteuerung, Optikeinstellungen und Blitzkontrolle ermöglicht. So entsteht eine einheitliche Oberfläche, über die sämtliche Schritte -- von der Auswahl der Bildquelle bis zur finalen Aufnahme -- komfortabel gesteuert werden können.

Für die Aufnahme stehen unterschiedliche **Bildquellen** zur Verfügung. Neben der internen Kamera der evoVIU lassen sich externe Kameramodule der evoVIU sowie zukünftig GENICAM-Kameras einbinden, ebenso wie Bildsequenzen, die auf Netzwerkspeichern (NAS) oder Cloud-Servern abgelegt sind. Auf diese Weise können Live-Bilder und gespeicherte Datenquellen parallel genutzt und im Workflow verarbeitet werden. Darüber hinaus erlaubt die **Remote Camera**, Bilder von einer anderen evoVIU zu beziehen und nahtlos in den eigenen Workflow einzubinden. Die Zuordnung erfolgt dabei über die eindeutige UUID der jeweiligen Quelle, sodass eine klare und sichere Identifikation gewährleistet ist.

Ein wesentlicher Vorteil von VISIONWEB ist die Möglichkeit, neben der eigentlichen Bildaufnahme auch **Licht und Optik** gezielt zu steuern. Über die *Image Source*-Komponente können Belichtungszeit, Verstärkung (Gain), Blitzmodule oder Linsenparameter individuell angepasst werden. Dies ermöglicht es, die Bildqualität optimal auf den jeweiligen Anwendungsfall abzustimmen -- sei es bei wechselnden Lichtverhältnissen, schnellen Produktionsprozessen oder detaillierten Inspektionsaufgaben.

Damit vereint VISIONWEB alle notwendigen Funktionen in einer Plattform: Bildquellen auswählen, Kameras konfigurieren, Licht steuern und Optik anpassen. Auf diese Weise wird die Bildaufnahme nicht nur flexibel, sondern auch effizient und präzise in den Workflow integriert.

---
version: "8.6.0"
language: "de"
---
# Bildverarbeitungstools VisionTools

|                          **Kategorie**                          |                                                **Tool**                                                |                                                                                                      |                                                                                          **Beschreibung**                                                                                          |
|-----------------------------------------------------------------|--------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Code \& Text](https://doku.evoviu.de/de/product-documentation/8.6.0/code-text.md)    |                                                                                                        |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 | [Read Single 1D/2D Code](https://doku.evoviu.de/de/product-documentation/8.6.0/code-text.md#Read-Single-1D/2D-Code)          |                                                                                                      | Liest einen einzelnen 1D/2D-Code aus dem Bild -- unterstützt u.a. UPC, EAN, Code 39, QR und weitere Formate.                                                                                       |
|                                                                 | [Read Data Matrix Code](https://doku.evoviu.de/de/product-documentation/8.6.0/code-text.md#Read-Data-Matrix-Code)            |                                                                                                      | Liest einen Data-Matrix-Code aus dem Bild -- zweidimensionaler Code aus schwarz-weißen Quadraten in Rasterform.                                                                                    |
|                                                                 | [Read Text](https://doku.evoviu.de/de/product-documentation/8.6.0/code-text.md#Read-Text)                                    |                                                                                                      | Erkennt und liest Text im Bild -- Optical Character Recognition (OCR) zur Textextraktion.                                                                                                          |
| [Contour](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md)           |                                                                                                        |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 | [Filter](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Filter)                                            |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 |                                                                                                        | [Sobel](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Sobel)                                            | Wendet den Sobel-Operator an -- berechnet Gradientenbetrag und hebt Kanten sowie Intensitätsänderungen hervor.                                                                                     |
|                                                                 |                                                                                                        | [Canny](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Canny)                                            | Wendet den Canny-Kantendetektionsalgorithmus an -- erkennt Kanten anhand von Intensitätsgradienten im Bild.                                                                                        |
|                                                                 |                                                                                                        | [Laplacian](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Laplacian)                                    | Wendet den Laplace-Operator an -- berechnet zweite Ableitung und verstärkt Bereiche mit schnellen Intensitätsänderungen.                                                                           |
|                                                                 | [Find Contours Basic](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Find-Contours-Basic)                  |                                                                                                      | Erkennt und umrandet Konturen (weiße Bereiche) in einem Binärbild -- Ausgabe nach Größe sortiert (groß bis klein).                                                                                 |
|                                                                 | [Find Contours Advanced](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Find-Contour-Advanced)             |                                                                                                      | Erkennt und umrandet Konturen (weiße Bereiche) in Binärbildern -- benötigt weiße Objekte, Ausgabe sortiert von groß nach klein.                                                                    |
|                                                                 | [Draw Contours](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Draw-Contour)                               |                                                                                                      | Zeigt Konturen auf einem Bild an -- erleichtert das Erkennen von Objekt- oder Regionsumrissen. Voraussetzung: vorherige Konturensuche mit „Find Contours".                                         |
|                                                                 | [Get Contour By Index](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Get-Contour-By-Index)                |                                                                                                      | Ruft Konturen aus einem Polylinien-Array anhand eines Indexbereichs ab -- Index basiert auf Abstand zum Bildursprung (0,0). Voraussetzung: vorherige Konturensuche mit „Find Contours".            |
|                                                                 | [Get Contour By Area](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Get-Contour-By-Area)                  |                                                                                                      | Filtert Konturen nach Fläche -- sortiert von größter zu kleinster Fläche. Voraussetzung: vorherige Konturensuche mit „Find Contours".                                                              |
|                                                                 | [Contours To Region](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Contours-to-Region)                    |                                                                                                      | Wandelt Konturen in ein Binärbild (Region) um -- nutzbar als Maske für weitere Verarbeitung. Voraussetzung: vorherige Konturensuche mit „Find Contours".                                           |
|                                                                 | [Enclosing Box (Contour)](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Enclosing-Box-(Contour))          |                                                                                                      | Schließt eine Kontur in einer einzelnen Box ein.                                                                                                                                                   |
|                                                                 | [Enclosing Circle (Contour)](https://doku.evoviu.de/de/product-documentation/8.6.0/contour.md#Enclosing-Circle-(Contour))    |                                                                                                      | Schließt eine Kontur in einem einzelnen Kreis ein.                                                                                                                                                 |
| [Draw](https://doku.evoviu.de/de/product-documentation/8.6.0/draw.md)                 |                                                                                                        |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 | [Get Text Size](https://doku.evoviu.de/de/product-documentation/8.6.0/draw.md#Get-Text-Size)                                 |                                                                                                      | Berechnet die Breite und Höhe eines Textes für eine bestimmte Schriftart sowie Skalierung und Linienstärke.                                                                                        |
| [Filter](https://evopro.atlassian.net/wiki/x/CQBOBg)            |                                                                                                        |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 | [Arithmetic](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Arithmetic)                                     |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 |                                                                                                        | [Deviation](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Deviation)                                     | Ermittelt Abweichungen vom Sollwert im Bild -- hebt Bereiche hervor, die vom erwarteten Muster abweichen.                                                                                          |
|                                                                 |                                                                                                        | [Emphaszie](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Emphaszie)                                     | Passt Kontrast und Helligkeit eines Bildes an -- verbessert Darstellung und Sichtbarkeit von Details.                                                                                              |
|                                                                 |                                                                                                        | [Sharpening](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Sharpening)                                   | Schärft ein Bild durch Erhöhung des Kontrasts zwischen benachbarten Pixeln -- verbessert Details und Klarheit.                                                                                     |
|                                                                 |                                                                                                        | [Gamma Correction](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Gamma-Correction)                       | Passt den Gammawert des Bildes an -- steuert Helligkeit und Kontrast für eine optimierte Darstellung.                                                                                              |
|                                                                 |                                                                                                        | [Substract](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Substract)                                     | Subtrahiert Pixelwerte eines Bildes von einem anderen -- hebt Unterschiede zwischen beiden Bildern hervor.                                                                                         |
|                                                                 |                                                                                                        | [Pow](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Pow)                                                 | Hebt Pixelwerte auf eine Potenz -- erhöht oder verringert Helligkeit zur Kontraststeigerung oder Detailbetonung.                                                                                   |
|                                                                 | [Smoothing](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Smoothing)                                       |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 |                                                                                                        | [Average](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Average)                                         | Wendet einen Mittelwertfilter an -- glättet das Bild und reduziert Bildrauschen bzw. körnige Strukturen.                                                                                           |
|                                                                 |                                                                                                        | [Bilateral](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Bilateral)                                     | Wendet einen bilateralen Filter an -- glättet das Bild, erhält jedoch Kanten durch Berücksichtigung von Abstand und Intensitätsunterschieden.                                                      |
|                                                                 |                                                                                                        | [Gauss](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Gauss)                                             | Wendet einen Gauß-Filter an -- glättet das Bild durch Mittelung der Pixelwerte innerhalb einer Gauß-Kernelgröße.                                                                                   |
|                                                                 |                                                                                                        | [Median](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Median)                                           | Wendet einen Medianfilter an -- reduziert Rauschen, indem jeder Pixel durch den Median seiner Nachbarschaft ersetzt wird.                                                                          |
|                                                                 | [Transformation](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Transformation)                             |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 |                                                                                                        | [Anisotropic Scaling](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Anisotropic-Scaling)                 | Skaliert Breite und Höhe eines Bildes mit unterschiedlichen Faktoren -- ermöglicht nicht-proportionale Größenänderung.                                                                             |
|                                                                 |                                                                                                        | [Isotropic Scaling](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Isotropic-Scaling)                     | Skaliert ein Bild gleichmäßig in beide Richtungen -- Seitenverhältnis bleibt dabei erhalten.                                                                                                       |
|                                                                 |                                                                                                        | [Resize](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Resize)                                           | Ändert Bildgröße auf definierte Maße -- Breite und Höhe werden gezielt angepasst.                                                                                                                  |
|                                                                 |                                                                                                        | [Translation](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Translation)                                 | Verschiebt ein Bild horizontal und/oder vertikal -- freigewordene Bereiche werden mit schwarzen Pixeln gefüllt.                                                                                    |
|                                                                 |                                                                                                        | [Flip](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Flip)                                               | Spiegelt ein Bild horizontal oder vertikal -- erzeugt ein Spiegelbild entlang der gewählten Achse.                                                                                                 |
|                                                                 |                                                                                                        | [Rotate Center](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Rotate-Center)                             | Dreht ein Bild um einen angegebenen Winkel -- Rotation erfolgt um den Mittelpunkt.                                                                                                                 |
|                                                                 |                                                                                                        | [Undistort](https://doku.evoviu.de/de/product-documentation/8.6.0/filter.md#Undistort)                                     | Entfernt den sogenannten Fischaugeneffekt aus dem Bild -- korrigiert extreme Weitwinkelverzerrungen.                                                                                               |
| [Image](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md)               |                                                                                                        |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 | [Manipulate](https://evopro.atlassian.net/wiki/x/zwC3Bw)                                               |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 |                                                                                                        | [CLAHE](https://doku.evoviu.de/de/product-documentation/8.6.0/manipulate.md#CLAHE)                                         | Verbessert den lokalen Kontrast, indem das Bild in kleinere Regionen aufgeteilt wird und hierfür Histogramme berechnet werden. Darauf wird eine kontrastbegrenzte Histogramm-Entzerrung angewandt. |
|                                                                 |                                                                                                        | [Compare Histogram](https://doku.evoviu.de/de/product-documentation/8.6.0/manipulate.md#Compare-Histogram)                 | Misst Ähnlichkeiten und Unterschiede zwischen Histogrammen.                                                                                                                                        |
|                                                                 |                                                                                                        | [Equalize Histogram](https://doku.evoviu.de/de/product-documentation/8.6.0/manipulate.md#Equalize-Histogram)               | Verbessert den Kontrast eines Bildes, indem das Histogramm gestreckt wird und die Helligkeitswerte besser ausgenutzt werden.                                                                       |
|                                                                 |                                                                                                        | [Expand Contrast](https://doku.evoviu.de/de/product-documentation/8.6.0/manipulate.md#Expand-Contrast)                     | Erhöht den Kontrast ohne die Bildeigenschaften zu verändern. Ein kontrastarmes Bild wird so auf den gesamten Bereich gestreckt.                                                                    |
|                                                                 |                                                                                                        | [Histogram Back Projection](https://doku.evoviu.de/de/product-documentation/8.6.0/manipulate.md#Histogram-Back-Projection) | Prüft die Verteilung von Pixeln. Findet Zielbild in Region, wo die Farbverteilung im Referenzbild am meisten übereinstimmt.                                                                        |
|                                                                 |                                                                                                        | [Normalize Histogram](https://doku.evoviu.de/de/product-documentation/8.6.0/manipulate.md#Normalize-Histogram)             | Gleichmäßige Verteilung von Pixelwerten über festgelegten Bereich, ohne das Histogramm zu verändern.                                                                                               |
|                                                                 | [Compare Images](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Compare-Images)                              |                                                                                                      | Vergleicht zwei Bilder und hebt Unterschiede hervor -- Abweichungen erscheinen dunkel, Gemeinsamkeiten heller.                                                                                     |
|                                                                 | [Convert to Grayscale](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Convert-to-Grayscale)                  |                                                                                                      | Wandelt ein RGB-Bild in Graustufen um -- basierend auf Helligkeit, vereinfacht farbunabhängige Bildverarbeitung.                                                                                   |
|                                                                 | [Crop By Coordinates](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Crop-By-Coordinates)                    |                                                                                                      | Schneidet ein Bild per Koordinaten zu -- definiert durch obere linke und untere rechte Ecke, extrahiert den gewünschten Bereich.                                                                   |
|                                                                 | [Crop By Shape](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Crop-By-Shape)                                |                                                                                                      | Schneidet ein Bild anhand einer definierten Form zu -- extrahiert gezielt den Bereich innerhalb dieser Form.                                                                                       |
|                                                                 | [Draw Line Variant](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Draw-Line-Variant)                        |                                                                                                      | Zeichnet eine Linie ins Bild -- hilfreich zur Markierung, Hervorhebung oder Annotation in Bildverarbeitungsaufgaben.                                                                               |
|                                                                 | [Draw Shape](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Draw-Shape)                                      |                                                                                                      | Ermöglicht das Zeichnen von Formen im Bild -- ideal zur Hervorhebung oder Markierung bestimmter Bereiche.                                                                                          |
|                                                                 | [Draw Ellipse](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Draw-Ellipse)                                  |                                                                                                      | Zeichnet eine Ellipse ins Bild -- nützlich zur Annotation, Hervorhebung oder Markierung bestimmter Bildbereiche.                                                                                   |
|                                                                 | [Reduce Domain To Shape](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Reduce-Domain-To-Shape)              |                                                                                                      | Begrenzt den Bildbereich auf eine Form, ohne zu beschneiden -- außerhalb liegende Pixel werden schwarz, Koordinaten bleiben erhalten.                                                              |
|                                                                 | [Mean](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Mean)                                                  |                                                                                                      | Berechnet den Mittelwert aller Pixel -- liefert Information über durchschnittliche Helligkeit oder Farbintensität im Bild.                                                                         |
|                                                                 | [Standard Deviation](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Standard-Deviation)                      |                                                                                                      | Berechnet die Standardabweichung der Pixelwerte -- zeigt, wie stark Helligkeit oder Farbe im Bild streuen oder variieren.                                                                          |
|                                                                 | [Minimum](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Minimum)                                            |                                                                                                      | Bestimmt den kleinsten Pixelwert im Bild -- zeigt den dunkelsten oder schwächsten Intensitätsbereich im gesamten Bild.                                                                             |
|                                                                 | [Maximum](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Maximum)                                            |                                                                                                      | Bestimmt den höchsten Pixelwert im Bild -- zeigt den hellsten oder intensivsten Bereich im gesamten Bild.                                                                                          |
|                                                                 | [Plot Text](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Plot-Text)                                        |                                                                                                      | Zeichnet einen Text an definierter Position ins Bild -- nicht darstellbare Zeichen werden durch Fragezeichen ersetzt.                                                                              |
|                                                                 | [Get Image Meta Information](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Get-Image-Meta-Information)      |                                                                                                      | Liefert Metadaten zum Eingabebild -- ermittelt Bildtyp, Breite und Höhe.                                                                                                                           |
|                                                                 | [Split Image (RGB)](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Split-Image-(RGB))                        |                                                                                                      | Ermittelt die RGB-Farbkanäle eines Bildes -- gibt jeweils einen Wert pro Kanal zurück.                                                                                                             |
|                                                                 | [Split Image (HSV)](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Split-Image-(HSV))                        |                                                                                                      | Ermittelt Farbton, Sättigung und Helligkeit eines RGB-Bildes -- durch Umwandlung in HSV-Farbraum und Aufteilung der Kanäle.                                                                        |
|                                                                 | [Combine Image](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Combine-Image)                                |                                                                                                      | Erzeugt ein Farbbild durch Kombination einzelner Bilder für Rot-, Grün- und Blaukanal.                                                                                                             |
|                                                                 | [Calculate Histogram](https://doku.evoviu.de/de/product-documentation/8.6.0/image.md#Calculate-Histogram)                    |                                                                                                      | Berechnet das Histogramm eines Bildes. Unterstützt Graustufen (Mono), RGB- und HSV-Kanäle.                                                                                                         |
| [Locate](https://doku.evoviu.de/de/product-documentation/8.6.0/locate.md)             |                                                                                                        |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 | [Edge Intersection](https://doku.evoviu.de/de/product-documentation/8.6.0/locate.md#Edge-Intersection)                       |                                                                                                      | Bestimmt den Schnittpunkt zweier Segmente im Bild -- optional mit Anzeige des Messergebnisses.                                                                                                     |
|                                                                 | [Find Edges](https://doku.evoviu.de/de/product-documentation/8.6.0/locate.md#Find-Edges)                                     |                                                                                                      | Erkennt Kanten im Bild -- markiert starke Helligkeits- oder Farbwechsel, meist an Objektgrenzen oder markanten Strukturen.                                                                         |
|                                                                 | [Find Circle](https://doku.evoviu.de/de/product-documentation/8.6.0/locate.md#Find-Circle)                                   |                                                                                                      | Detektiert einen Kreis innerhalb einer Region. Hierbei ist der Smallest, Fitting, Mean oder Largest Circle auswählbar.                                                                             |
| [Measure](https://doku.evoviu.de/de/product-documentation/8.6.0/measure.md)           |                                                                                                        |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 | [Measure Segment To Segment](https://doku.evoviu.de/de/product-documentation/8.6.0/measure.md#Measure-Segment-To-Segment)    |                                                                                                      | Misst kürzeste, durchschnittliche und längste Distanz zwischen zwei Segmenten -- nützlich zur Analyse räumlicher Beziehungen.                                                                      |
|                                                                 | [Measure Distance (Segment)](https://doku.evoviu.de/de/product-documentation/8.6.0/measure.md#Measure-Distance-(Segment))    |                                                                                                      | Misst Distanz zwischen Punkt und Liniensegment -- wählbar: kürzeste, zum Start- oder Endpunkt des Segments.                                                                                        |
|                                                                 | [Measure Distance (Line)](https://doku.evoviu.de/de/product-documentation/8.6.0/measure.md#Measure-Distance-(Line))          |                                                                                                      | Misst die Entfernung zwischen einem Punkt und einer Linie -- hilfreich zur präzisen Lagebestimmung relativ zur Linie.                                                                              |
|                                                                 | [Measure Angle (Segment)](https://doku.evoviu.de/de/product-documentation/8.6.0/measure.md#Measure-Angle-(Segment))          |                                                                                                      | Misst den Winkel zwischen zwei Linien -- ausgehend von einer Referenzlinie im Gegenuhrzeigersinn gemessen.                                                                                         |
|                                                                 | [Measure Line To Line](https://doku.evoviu.de/de/product-documentation/8.6.0/measure.md#Measure-Line-To-Line)                |                                                                                                      | Misst die Entfernung zwischen zwei Linien -- nützlich zur Analyse von Parallelität oder Abständen im Bild.                                                                                         |
|                                                                 | [Measure Angle (Line)](https://doku.evoviu.de/de/product-documentation/8.6.0/measure.md#Measure-Angle-(Line))                |                                                                                                      | Misst den Winkel zwischen zwei Linien -- basierend auf einer Referenzlinie, im Gegenuhrzeigersinn gemessen.                                                                                        |
|                                                                 | [Measure Angle (Rectangle)](https://doku.evoviu.de/de/product-documentation/8.6.0/measure.md#Measure-Angle-(Rectangle))      |                                                                                                      | Misst den Winkel zwischen einer Linie und einer Seite eines nicht-quadratischen Rechtecks im Gegenuhrzeigersinn                                                                                    |
|                                                                 | [Calculate Angle](https://doku.evoviu.de/de/product-documentation/8.6.0/measure.md#Calculate-Angle)                          |                                                                                                      | Misst den Winkel zwischen zwei Vektoren -- im Gegenuhrzeigersinn ausgehend vom Referenzvektor gemessen.                                                                                            |
| [Region](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md)             |                                                                                                        |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 | [Morphology](https://doku.evoviu.de/de/product-documentation/8.6.0/morphology.md)                                            |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 |                                                                                                        | [Erode](https://doku.evoviu.de/de/product-documentation/8.6.0/morphology.md#Erode)                                         | Reduziert weiße Bereiche durch Entfernen von Randpixeln -- nützlich zum Trennen verbundener Objekte oder Entfernen kleiner Flecken.                                                                |
|                                                                 |                                                                                                        | [Dilate](https://doku.evoviu.de/de/product-documentation/8.6.0/morphology.md#Dilate)                                       | Erweitert weiße Bereiche, indem Randpixel weiß werden -- füllt Lücken und verbindet unterbrochene Objektteile im Bild.                                                                             |
|                                                                 |                                                                                                        | [Open](https://doku.evoviu.de/de/product-documentation/8.6.0/morphology.md#Open)                                           | Wendet Erosion gefolgt von Dilatation an -- glättet Konturen, entfernt Störungen und trennt überlappende Objekte zuverlässig.                                                                      |
|                                                                 |                                                                                                        | [Close](https://doku.evoviu.de/de/product-documentation/8.6.0/morphology.md#Close)                                         | Wendet Dilatation gefolgt von Erosion an -- schließt Lücken, verbindet Objektteile und glättet weiße Bildbereiche.                                                                                 |
|                                                                 |                                                                                                        | [Gradient](https://doku.evoviu.de/de/product-documentation/8.6.0/morphology.md#Gradient)                                   | Berechnet Differenz aus Dilatation und Erosion -- hebt Objektkonturen hervor und unterstützt bei der Kantenerkennung.                                                                              |
|                                                                 |                                                                                                        | [Top Hat](https://doku.evoviu.de/de/product-documentation/8.6.0/morphology.md#Top-Hat)                                     | Berechnet Differenz zwischen Originalbild und Opening -- hebt kleine helle Details wie feine Strukturen oder Störungen hervor.                                                                     |
|                                                                 |                                                                                                        | [Black Hat](https://doku.evoviu.de/de/product-documentation/8.6.0/morphology.md#Black-Hat)                                 | Berechnet Differenz zwischen Closing und Originalbild -- hebt kleine dunkle Details wie Flecken oder Objekte vor hellem Hintergrund hervor.                                                        |
|                                                                 |                                                                                                        | [Hit Miss](https://doku.evoviu.de/de/product-documentation/8.6.0/morphology.md#Hit-Miss)                                   | Erkennt gezielte Pixelmuster mittels zwei strukturierenden Elementen -- ideal für präzise Form- und Mustererkennung im Bild.                                                                       |
|                                                                 | [Area](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Area)                                                 |                                                                                                      | Berechnet die Fläche jeder weißen Region im Binärbild -- liefert quantitative Größeninformation zu Objekten im Bild.                                                                               |
|                                                                 | [Center](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Center)                                             |                                                                                                      | Erkennt und quantifiziert zusammenhängende Regionen -- Gruppen verbundener Pixel mit gleichem Wert werden als einzelne Objekte betrachtet.                                                         |
|                                                                 | [Count Black Pixels](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Count-Black-Pixels)                     |                                                                                                      | Zählt schwarze Pixel im Bild -- nützlich zur Bestimmung der Größe oder Ausdehnung schwarzer Bereiche.                                                                                              |
|                                                                 | [Count Regions](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Count-Regions)                               |                                                                                                      | Erkennt und zählt einzelne Regionen -- zusammenhängende Pixel mit gleichem Wert werden als eigenständige Objekte erfasst.                                                                          |
|                                                                 | [Count White Pixels](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Count-White-Pixels)                     |                                                                                                      | Zählt weiße Pixel im Bild -- hilfreich zur Bestimmung von Größe oder Ausdehnung weißer Bildbereiche.                                                                                               |
|                                                                 | [Compare Reigons](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Compare-Regions)                           |                                                                                                      | Vereint zwei Regionen zu einer zusammenhängenden -- hilfreich für Objekterkennung, Zusammenführung oder Segmentierungsbewertung.                                                                   |
|                                                                 | [Concat Regions](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Concat-Regions)                             |                                                                                                      | Fügt zwei binäre Regionen per logischem ODER zusammen -- weiße Bereiche beider Bilder werden kombiniert und erhalten.                                                                              |
|                                                                 | [Substract](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Subtract)                                        |                                                                                                      | Subtrahiert eine Region von einer anderen (Region1 -- Region2) -- nützlich zur Isolierung von Unterschieden oder Überlappungen.                                                                    |
|                                                                 | [Intersection](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Intersection)                                 |                                                                                                      | Vergleicht die Schnittmenge zweier Regionen -- hilfreich zur Erkennung gemeinsamer Bereiche oder Merkmale in Segmentierungen.                                                                      |
|                                                                 | [Invert Pixel Region](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Invert-Pixel-Region)                   |                                                                                                      | Invertiert die Pixel einer Region -- typischerweise Weiß zu Schwarz und umgekehrt -- zur Hervorhebung oder Negativerstellung.                                                                      |
|                                                                 | [Region To Image](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Region-To-Image)                           |                                                                                                      | Wandelt eine Region im Binärformat in ein Graustufenbild um.                                                                                                                                       |
|                                                                 | [Select Region](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Select-Region)                               |                                                                                                      | Wählt Regionen basierend auf Fläche, Index, Höhe oder Breite innerhalb eines definierten Wertebereichs aus.                                                                                        |
|                                                                 | [Select Largest Region](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Select-Largest-Region)               |                                                                                                      | Identifiziert die größte zusammenhängende Region -- ideal zur Extraktion dominanter Objekte oder relevanter Bildbereiche.                                                                          |
|                                                                 | [Smallest Circle](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Smallest-Circle)                           |                                                                                                      | Berechnet den kleinsten Kreis, der eine Region vollständig umschließt -- hilfreich zur Formanalyse und Messung.                                                                                    |
|                                                                 | [Smallest Rectangle](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Smallest-Rectangle)                     |                                                                                                      | Berechnet das kleinste Rechteck, das eine Region vollständig umschließt -- nützlich zur Analyse und Messung.                                                                                       |
|                                                                 | [Region Size](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Region-Size)                                   |                                                                                                      | Gibt Breite und Höhe einer Region basierend auf der Eingabe zurück.                                                                                                                                |
|                                                                 | [Sort Region](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Sort-Regions)                                  |                                                                                                      | Sortiert Regionen nach X, Y, Breite, Höhe oder Fläche -- mit spezifischer Sortierrichtung je nach Merkmal.                                                                                         |
|                                                                 | [Sort Contours](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Sort-Contours)                               |                                                                                                      | Sortiert Konturen nach X, Y, Länge oder Fläche; Anzahl der zurückgegebenen Konturen ist begrenzbar.                                                                                                |
|                                                                 | [Sort Edges](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Sort-Edges)                                     |                                                                                                      | Sortiert ein Array von Kanten anhand eines bestimmten Merkmals.                                                                                                                                    |
|                                                                 | [Crop By Shape](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Crop-By-Shape)                               |                                                                                                      | Schneidet eine Region in einer bestimmten Form zu.                                                                                                                                                 |
|                                                                 | [Reduce Domain To Shape](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Reduce-Domain-To-Shape)             |                                                                                                      | Reduziert den Bereich einer Region auf eine bestimmte Form, jedoch ohne dabei die Region abzuschneiden.                                                                                            |
|                                                                 | [Enclosing Circle (Region)](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Enclosing-Circle-(Region))       |                                                                                                      | Schließt einen Bereich in einem einzelnen Kreis ein.                                                                                                                                               |
|                                                                 | [Enclosing Rectangle (Region)](https://doku.evoviu.de/de/product-documentation/8.6.0/region.md#Enclosing-Rectangle-(Region)) |                                                                                                      | Schließt einen Bereich in einem einzelnen Rechteck ein.                                                                                                                                            |
| [Segmentation](https://doku.evoviu.de/de/product-documentation/8.6.0/segmentation.md) |                                                                                                        |                                                                                                      |                                                                                                                                                                                                    |
|                                                                 | [Adaptive Threshold](https://doku.evoviu.de/de/product-documentation/8.6.0/segmentation.md#Adaptive-Threshold)               |                                                                                                      | Adaptive Thresholding passt den Schwellenwert lokal an -- ideal bei ungleichmäßiger Beleuchtung, verbessert die Erkennungsgenauigkeit deutlich.                                                    |
|                                                                 | [Binary Threshold](https://doku.evoviu.de/de/product-documentation/8.6.0/segmentation.md#Binary-Threshold)                   |                                                                                                      | Setzt Pixel unter dem Schwellenwert auf null, darüber auf 255, also weiß.                                                                                                                          |
|                                                                 | [Color Threshold](https://doku.evoviu.de/de/product-documentation/8.6.0/segmentation.md#Color-Threshold)                     |                                                                                                      | Dieser Knoten isoliert gezielt Bildbereiche, deren Pixel in einem definierten Farbbereich liegen.                                                                                                  |
|                                                                 | [To Zero Threshold](https://doku.evoviu.de/de/product-documentation/8.6.0/segmentation.md#To-Zero-Threshold)                 |                                                                                                      | Setzt Pixel unter dem Schwellenwert auf null, andere bleiben unverändert, um Details zu erhalten.                                                                                                  |

---
version: "8.6.0"
language: "de"
---
# Bookmarks

In diesem Kapitel erfahren Sie, wie sie mit Bookmarks umgehen. Bookmarks sind eine Art Platzhalter, denen Sie einen Wert zuweisen und dann immer wieder referenzieren können. Auch wenn sich Werte ändern, bleibt die Referenz die gleiche.

## Einleitung

Wenn Sie bestimmte Werte immer wieder an verschiedenen Stellen der Anwendung hinterlegen müssen, sind die Bookmarks Ihre Rettung. Dank der Bookmarks müssen Sie den Wert nur noch an einer Stelle ändern und können jederzeit auf diesen referenzieren. So müssen Sie kaum noch Änderungen vornehmen, wenn Sie einen Workflow von einer Kamera auf eine andere importieren möchten, da die Einstellungen über Bookmarks gespeichert sind.

Sie gelangen über die Settings zu den Bookmarks. Sobald Sie den Bereich öffnen, wird Ihnen eine vorgefertigte Sammlung an Bookmarks angezeigt, es ist allerdings jederzeit möglich auch eigene, individuelle Bookmarks zu erstellen.  
![Screenshot 2026-03-02 082546.png](https://doku.evoviu.de/__attachments/a_8241a9c19dbc4b08e84e568849816819fefab565158420c60ebd094aef58b80e/Screenshot%202026-03-02%20082546.png?cb=3577f2351df8013ad3a900fd0852eef0)

Sie erkennen Bookmarks in der Anwendung daran, dass sie zwei Sternchen (\*\*) vor und nach dem Label besitzen.

## Default Bookmarks

Folgende vorgefertigten Bookmarks stehen aktuell zur Verfügung:  

|   **Label**   |       **Token**       |      **Beschreibung**      |
|---------------|-----------------------|----------------------------|
| Device name   | \*\*deviceName\*\*    | Name der Kamera            |
| IP address    | \*\*IP\*\*            | Netzwerkadresse der Kamera |
| Serial number | \*\*serialNumber\*\*  | Seriennummer der Kamera    |
| MAC address   | \*\*macAddress\*\*    | MAC-Adresse der Kamera     |
| Camera        | \*\*deviceCamera\*\*  | Kameratyp des Geräts       |
| Docker        | \*\*deviceDocker\*\*  | Dockertyp des Geräts       |
| Focus         | \*\*deviceFocus\*\*   | Fokustyp des Geräts        |
| Lens          | \*\*deviceLens\*\*    | Linsentyp des Geräts       |
| Light         | \*\*deviceLight\*\*   | Lichttyp des Geräts        |
| Wireless      | \*\*wireless\*\*      | WiFi-Typ des Geräts        |
| Display       | \*\*deviceDisplay\*\* | Displaytyp des Geräts      |

Diese Bookmarks können Sie jederzeit an allen Stellen nutzen, die eine Texteingabe erfordern.

## Custom Bookmarks

### Erstellen von Bookmarks

Unter Custom Bookmarks können Sie entweder auf den Create Bookmark Button oder den Add Bookmark Button klicken, um Ihre erste individuelle Bookmark zu erstellen.  
![Screenshot 2026-03-02 082621.png](https://doku.evoviu.de/__attachments/a_7804c6fc4a312489a1b305b5dc81268964f8c83a348c7879117ce6c94032a22c/Screenshot%202026-03-02%20082621.png?cb=70e58aab2e2b946cb9ecc80581c55471)

#### Label

Geben Sie Ihrem Bookmark ein aussagekräftiges Label.

#### Description

Beschreiben Sie, warum Sie dieses Bookmark erstellt haben und welcher Wert sich dahinter verbirgt. Das kann anderen Nutzern der Kamera helfen.

#### Token

Über den Token können Sie Ihr Bookmark referenzieren. Der Token wir immer innerhalb der \*\* dargestellt. Bei den Default Bookmarks entspricht der Token stets dem Label.

#### Value

Hier geben Sie den Wert an, der über das Bookmark aufgelöst wird. Hierfür liegt keine Beschränkung hinsichtlich einer Mindestlänge vor, allerdings darf das Feld nicht leer sein.

### Verwalten von Bookmarks

![Screenshot 2026-03-02 082707.png](https://doku.evoviu.de/__attachments/a_93cdecdd9ec6d7431b9630ffc8deb89fafe86852a4dacf318289bc4e9da99430/Screenshot%202026-03-02%20082707.png?cb=e079d30d241e6810bc49e5d5ff9ae608)

### Editieren von Bookmarks

In der Tabellenübersicht des Custom Bookmarks Tab können Sie über das Menü mit den drei vertikal angeordneten Punkten die Option Edit auswählen. Hier öffnet sich der Dialog, welchen Sie bereits vom Erstellen eines Bookmarks kennen mit dem Unterschied, dass dieser Dialog mit den zuvor angegebenen Informationen vorausgefüllt ist. Dort können Sie die gewünschten Änderungen vornehmen und bestätigen.  
![Screenshot 2026-03-02 082728.png](https://doku.evoviu.de/__attachments/a_fa39f419e7f8d6cdd2799e8cab1849b042c92ad820a5dbfe2998b5312319ecd3/Screenshot%202026-03-02%20082728.png?cb=de9016949c9dfe907e9ec41857f4cc8e)

### Entfernen von Bookmarks

Wenn Sie bereits erstellte Bookmarks nicht mehr benötigen, so können Sie über das mit den drei vertikal angeordneten Punkten dargestellte Menü öffnen und dort die Option Remove auswählen. In einem Dialog werden Sie nochmal dazu aufgefordert, die von Ihnen getätigte Aktion zu bestätigen, damit das Entfernen des Bookmarks final umgesetzt wird. Anschließend erscheint der Eintrag in der Tabellenübersicht des Custom Bookmarks Tab nicht mehr.  
![Screenshot 2026-03-02 082750.png](https://doku.evoviu.de/__attachments/a_1a1f1c0b8799ccbc6e518959d2809c798f38306ef9c8452ad9dc8c1eeb678e79/Screenshot%202026-03-02%20082750.png?cb=0c207c020cd78a539dfdc723fe644d6c)

## Verwenden von Bookmarks

### Indikator für Nutzungsmöglichkeit der Bookmarks

Immer wenn Sie diese Icon-Kombination sehen, können Sie an dieser Stelle Bookmarks verwenden. Mit Klick auf das linke Icon öffnet sich ein Dialog.  
![Screenshot 2025-06-25 180826.png](https://doku.evoviu.de/__attachments/a_8fd823e6f2847b5cf734b2b954ef997598536c7a8ba0a604fa4a97b06df890ab/Screenshot%202025-06-25%20180826.png?cb=044268b1cbd36f2d0399620adcf0cd45)

### Setzen eines Bookmarks

Sobald Sie auf das Input Feld klicken, öffnet sich eine Liste mit allen Default und Custom Bookmarks. Wählen Sie hier Ihr benötigtes Bookmark aus und kombinieren Sie es bei Bedarf mit weiterem Text. Sie haben auch die Möglichkeit, mehrere Bookmarks auszuwählen.  
![Screenshot 2026-03-02 082823.png](https://doku.evoviu.de/__attachments/a_d15d6fbfb8dea8919eb2a3396145a0fcdbdad41701980b4dfeb99b786bdb6692/Screenshot%202026-03-02%20082823.png?cb=d99be36455279c2d1351b4160ad652f8)

### Auflösen von Bookmarks

Sobald das Bookmark-Icon in gelb dargestellt wird, wissen Sie, dass hier ein Bookmark hinterlegt ist. Mit Klick auf das Pfeil Icon können Sie zwischen dem Token und dem aufgelösten Wert hin und her wechseln.  
![Screenshot 2025-06-25 180939.png](https://doku.evoviu.de/__attachments/a_c53ec1445e244db62385cd76368d48de655ab53d88ab420e4912e718356ec9ea/Screenshot%202025-06-25%20180939.png?cb=80df10788bf95983d192d0e39f11f796)  
[4.1_Settings _Bookmarks.mp4](https://doku.evoviu.de/__attachments/a_81f4860e63928f62edb7ca5230bac6830021d5d617ea75990a34f78a45d2c1ec/4.1_Settings%2520_Bookmarks.mp4.md)

---
version: "8.6.0"
language: "de"
---
# Camera

In diesem Kapitel finden Sie allgemeine Informationen zur Konfiguration der Metadaten der evoVIU-Kamera.

## Einleitung

In den Settings finden Sie den Bereich Camera vor. Auf dieser Seite können Sie individuelle Einstellungen für Ihre Kamera treffen, damit Sie diese besser von anderen Geräten unterscheiden können. Über die Vergabe eines spezifischen Namens über Beschreibungen bis hin zu einem Bild können hier individuelle Einstellungen getroffen werden.  
![Screenshot 2026-03-02 083214.png](https://doku.evoviu.de/__attachments/a_630dfd59a2b4f21185fc1343fb84669337efa44a7adda602055d08f3123dcb69/Screenshot%202026-03-02%20083214.png?cb=0b091cb9926a49922e9d41b6d79749ae)

## Konfiguration

### Name of Camera

Geben Sie hier Ihrer Kamera einen Namen oder ändern Sie diesen.

### Description of Camera

Fügen Sie Ihrer Kamera eine Beschreibung hinzu und stellen Sie so sicher, dass Sie wissen um welche Kamera es sich genau handelt.

### Location of Camera

Geben Sie an, wo genau sich Ihre Kamera befindet. Rechts können Sie ein Foto Ihrer Kamera oder des Betrachtungsobjektes hochladen. Falls Sie mehrere Kameras besitzen, können Sie so genau sehen, um welche es sich handelt. Ebenfalls haben Sie die Möglichkeit über die API diese Informationen jederzeit abzurufen.

### Camera image

Das Camera image soll Ihnen dabei helfen einen schnellen Wiedererkennungswert für Ihre Kamera zu schaffen.

#### Hinzufügen eines Kamerabilds

Nutzen Sie den ganz rechts positionierten gelben Button mit dem Upload-Icon zum Hinterlegen eines Kamerabilds. Achten Sie dabei auf ein gängiges, zulässiges Dateiformat. Sie können Ihr Kamerabild jederzeit wechseln.

#### Entfernen eines Kamerabilds

Über den gelben Button mit dem schwarzen Mülleimer-Icon können Sie das hinterlegte Bild wieder entfernen.  
[4.2_Settings_Camera.mp4](https://doku.evoviu.de/__attachments/a_cd57fe431b8dab5be185c52335d0e7dd5fe84c39d3e7ce704fe52d38ddc7ecf6/4.2_Settings_Camera.mp4.md)

---
version: "8.6.0"
language: "de"
---
# Camera Components

## Einleitung

Kaum ein Anwendungsfall kommt ohne Bild aus. Dies ist einer der Gründe warum die Komponenten aus dem Bereich Camera so wichtig sind. In unserem Workflow stehen Ihnen nicht nur die Hardware der evoVIU-Kamera zur Verfügung, sondern auch in interne und externe, simulierende Kameras basierend auf Beispielbildern.

## Beispiel

Die nachfolgenden Komponenten können alle auf Basis eines einfachen Beispiels getestet werden. Alles was hierfür notwendig ist, ist die Konfiguration eines Workflows im Tab Event Graph. Benötigte werden ein Start-Knoten, der Knoten Grab Image (Camera) sowie die vom Nutzer angelegte Komponente, welche in diesem Beispiel mit "My Camera" bezeichnet wurde sowie eine Variable vom Typ Image mit Published Value, im Beispiel als "My Image" deklariert. Der Workflow sieht demnach wiefolgt aus:  
![Screenshot 2025-11-18 110706.png](https://doku.evoviu.de/__attachments/a_b79b3ed0d25f9b41fab8951c9f8bcfeca2bfbd660f0eaf73d2947a0d1c5be323/Screenshot%202025-11-18%20110706.png?cb=da907e5adb3750ab0af1b074a26139f6)  
![Screenshot 2025-11-18 110726.png](https://doku.evoviu.de/__attachments/a_d8b392a3e1faea835c0ed0cb2d151136ba9264c308207aa7f2e245a0d15bc1f5/Screenshot%202025-11-18%20110726.png?cb=22d9ee4a2e0936a97f7a44c686932bc1)  
Die korrekte Funktionsweise dieses Beispiel-Workflows ist nur gegeben, wenn Ihre Komponente vollständig und mit den richtigen Daten konfiguriert ist.

## Azure Storage Blob Camera

Mit der Azure Storage Blob Camera können Sie Bilder direkt aus dem Blob-Speicher in der Azure-Cloud laden. Die erforderlichen Parameter erhalten Sie entweder durch das Erstellen eines Blob-Speichers in Azure oder durch Anfragen an Ihren IT-Administrator.

**Zugehörige Methode:** Get Latest Image File Name [https://evopro.atlassian.net/wiki/spaces/DVIU/pages/143622211/working+Camera+Components#Komponentenmethoden](https://doku.evoviu.de/de/product-documentation/8.6.0/camera-components.md#Komponentenmethoden)  
Wichtig: Der direkte Zugriff auf die Azure-Cloud aus dem Produktionsnetzwerk ist möglicherweise nicht von allen Standorten aus möglich. Hierfür sind in der Regel spezielle Zugriffsrechte erforderlich, die Ihnen Ihr Systemadministrator -- nach einigem Murren -- gerne gewährt. Kontinuität ist entscheidend für den Erfolg Ihres Digitalisierungsprojekts.  

| **Parameter** | **Typ** |                                                                                     **Beschreibung**                                                                                     |                                         **Beispiel**                                          |
|---------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
| Uri           | String  | Speichern Sie die URL zum Blob-Speicher. Sie können in der Cloud mithilfe eines Zugriffstokens darauf zugreifen. Es ist wichtig, dass Sie über Leseberechtigung im Container verfügen.   | [https://evoviudocumentation.blob.core.windows.net](https://doku.evoviu.de/de/product-documentation/8.6.0/azure.md) |
| Token         | Secret  | Es wird ein Passwort bzw. ein Token benötigt, um auf den Blob-Speicher zugreifen zu können. Sie sollten das Token sicher aufbewahren, da es Ihnen Zugriff auf den Blob-Speicher gewährt. | \<DeinToken\>                                                                                 |
| Container     | String  | Dies ist der Ordner, in dem die Bilder gespeichert sind.                                                                                                                                 | pictures                                                                                      |
| Cycle Images  | Boolean | Nutzer können hier entscheiden, ob nach einem vollständigen Durchlauf des Ordners eine erneute Iteration von Beginn an durchgeführt werden soll.                                         | Mögliche Werte: * True * False                                                                |
| Is Lazy       | Boolean | Hierüber werden Bilder erst geladen, wenn sie tatsächlich benötigt werden, wodurch die Auswirkungen auf die Performance reduziert werden kann.                                           | Mögliche Werte: * True * False                                                                |
| Color         | Enum    | Die Anzeige der Bilder kann in Graustufe oder Farbe erfolgen.                                                                                                                            | Mögliche Werte: * Grayscale: Bildanzeige in Graustufe * Color: Bildanzeige in Farbe           |

## Camera

Diese Komponente ermöglicht den Zugriff auf eine zuvor erstellte Bildquelle. Sie können diese Bildquelle in den Kameraeinstellungen auswählen. Der Kameraknoten selbst verwendet jedoch nur die Kameraeinstellungen der Bildquelle. Einstellungen für Flüssiglinse und Licht müssen daher im Workflow selbst konfiguriert werden. Dies bietet den Vorteil, dass Sie diese Einstellungen dynamisch über Knoteneingänge steuern können.

Wählen Sie die Komponente vom Typ Camera aus. Im zugehörigen Details Tab erscheint ein leeres Dropdown. Dort müssen Sie eine Bildquellenkonfiguration auswählen. Falls Sie noch keine Bildquellenkonfiguration besitzen, so müssen Sie zunächst im Bereich Image Source eine Konfiguration erstellen und die Einstellungen zur idealen Bildaufnahme vornehmen.  
![Screenshot 2025-11-18 110741.png](https://doku.evoviu.de/__attachments/a_3fda5c814a6392271af719c403e393ae01e8e351b67e0a80831581b18dd9d65d/Screenshot%202025-11-18%20110741.png?cb=3086afc41e63e5ba5b4dda85ea6a6fd6)

Sobald Sie über das Dropdown eine Auswahl getroffen haben, werden die Einstellungen der jeweiligen Konfiguration angezeigt. Diese können Sie jederzeit bearbeiten, sofern der ausgewählte Workflow nicht aktiv ist.  
![Screenshot 2025-11-18 110758.png](https://doku.evoviu.de/__attachments/a_08c84d52152cc80481132c1d8f6636978b7ac521c9d5f9f7739efd0cd0429261/Screenshot%202025-11-18%20110758.png?cb=bf2956dc218acda7152b371b0a49ef92)

## File Camera

Eine File Camera greift nicht direkt auf die aktuell aufgenommenen Bildquellen zu. Stattdessen können Sie einen Pfad zu zuvor gespeicherten Bildern angeben. Wählen Sie dazu den Speicherort der gespeicherten Bilder unter „Directory" aus.

**Zugehörige Methode:** Get Latest Image File Name [https://evopro.atlassian.net/wiki/spaces/DVIU/pages/143622211/working+Camera+Components#Komponentenmethoden](https://doku.evoviu.de/de/product-documentation/8.6.0/camera-components.md#Komponentenmethoden)  

|   **Parameter**    |      **Typ**       |                                                                  **Beschreibung**                                                                  |                                                                                          **Beispiel**                                                                                           |
|--------------------|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Is Lazy            | Boolean            | Hierüber werden Bilder erst geladen, wenn sie tatsächlich benötigt werden, wodurch die Auswirkungen auf die Performance reduziert werden kann.     | Mögliche Werte: * True * False                                                                                                                                                                  |
| Directory          | FileStoreDirectory | Wählen Sie ein Verzeichnis aus dem File System aus, welches mit realitätsnahen Beispielbildern bestückt ist oder erstellen Sie einen neuen Ordner. | ![Screenshot 2025-11-18 112945.png](https://doku.evoviu.de/__attachments/a_e79b7334a739c86f79d41256f290cea19f5f0d15d427a474d5f08bded66a3785/Screenshot%202025-11-18%20112945.png?cb=faafd235e3c334ca091498b071ed19d4) |
| Include Subfolders | Boolean            | Geben Sie an, ob Sie Unterordner, falls vorhanden, ebenfalls verwenden wollen.                                                                     | Mögliche Werte: * True * False                                                                                                                                                                  |
| Cycle Images       | Boolean            | Nutzer können hier entscheiden, ob nach einem vollständigen Durchlauf des Ordners eine erneute Iteration von Beginn an durchgeführt werden soll.   | Mögliche Werte: * True * False                                                                                                                                                                  |
| Color              | Enum               | Die Anzeige der Bilder kann in Graustufe oder Farbe erfolgen.                                                                                      | Mögliche Werte: * Grayscale: Bildanzeige in Graustufe * Color: Bildanzeige in Farbe                                                                                                             |

## Image Source

Diese Komponente ermöglicht den Zugriff auf eine zuvor erstellte Bildquelle. Sie können diese Bildquelle in den Kameraeinstellungen auswählen. Im Gegensatz zur Kamerakomponente, die lediglich die Konfiguration von Bereichen wie Bildformat, Aufnahme, Farbeinstellungen und Automatikfunktionen erlaubt, bietet diese Komponente die vollständige Kontrolle über die Bildquelle innerhalb des Workflows.

Wählen Sie die Komponente vom Typ Image Source aus. Im zugehörigen Details Tab erscheint ein leeres Dropdown. Dort müssen Sie eine Bildquellenkonfiguration auswählen. Falls Sie noch keine Bildquellenkonfiguration besitzen, so müssen Sie zunächst im Bereich Image Source eine Konfiguration erstellen und die Einstellungen zur idealen Bildaufnahme vornehmen.  
![Screenshot 2025-11-18 110741.png](https://doku.evoviu.de/__attachments/a_3fda5c814a6392271af719c403e393ae01e8e351b67e0a80831581b18dd9d65d/Screenshot%202025-11-18%20110741.png?cb=3086afc41e63e5ba5b4dda85ea6a6fd6)

Sobald Sie über das Dropdown eine Auswahl getroffen haben, werden die Einstellungen der jeweiligen Konfiguration angezeigt. Diese können Sie jederzeit bearbeiten, sofern der ausgewählte Workflow nicht aktiv ist.  
![Screenshot 2025-11-18 113251.png](https://doku.evoviu.de/__attachments/a_e54943d5bf064a5da81ad20011119ea61c48ca38efd3d39ace18eee802f325b7/Screenshot%202025-11-18%20113251.png?cb=6327abcd0e7bc61906cafe8ad08c055e)

## Remote Camera

Mit der Remote Camera können Sie auf eine andere evoVIU-Kamera in Ihrem Netzwerk zugreifen. Erstellen Sie eine Bildquelle auf der gewünschten Kamera mit den gewünschten Einstellungen. Wählen Sie dazu unter „Acquisition" die Option „Remote" für die Bildquelle aus. Die in der Browserleiste angegebene UUID kann als Bildquellen-ID verwendet werden.  

|  **Parameter**  | **Typ** |                                                                                                                                 **Beschreibung**                                                                                                                                  |             **Beispiel**             |
|-----------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------|
| Image Source Id | String  | Geben Sie die UUID der Bildquelle an, welche Sie zur Bildaufnahme nutzen möchten. Sie können diese auslesen, indem Sie die zu verwendende Bildquelle in Ihrem Browser öffnen und den URL-Teil nach [https://IP-Adresse/image-source/](https://ip-adresse/image-source/) kopieren. | 52db1383-7954-4868-8d66-421edb60d9de |
| Ip Address      | String  | Geben Sie die IP-Adresse der evoVIU-Kamera aus Ihrem Netzwerk an, von der Sie die Bilder beziehen möchten.                                                                                                                                                                        | 10.30.4.222                          |
| Username        | String  | Geben Sie Ihren Nutzernamen an, der zur Authentifizierung bzw. zum Verbindungsaufbau genutzt werden soll.                                                                                                                                                                         | DeinName                             |
| Password        | Secret  | Geben Sie das Passwort an, welches zur Authentifzierung bzw. zum Verbindungsaufbau genutzt werden soll.                                                                                                                                                                           | \<DeinToken\>                        |

## SMB Camera

Eine SMB-Camera erfasst keine Bilder in Echtzeit. Stattdessen ruft sie zuvor gespeicherte Bilder von einem entfernten NAS-Server mithilfe des SMB-Protokolls (Server Message Block) ab. Dies ist nützlich, wenn Bilder von externen Geräten oder evoVIUs erzeugt und zur späteren Verarbeitung gespeichert werden.

**Zugehörige Methode:** Get Latest Image File Name [https://evopro.atlassian.net/wiki/spaces/DVIU/pages/143622211/working+Camera+Components#Komponentenmethoden](https://doku.evoviu.de/de/product-documentation/8.6.0/camera-components.md#Komponentenmethoden)  

|     **Parameter**     | **Typ** |                                                                     **Beschreibung**                                                                      |                                    **Beispiel**                                     |
|-----------------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| Share                 | String  | Geben Sie den Namen Ihres Netzwerkordners an.                                                                                                             |                                                                                     |
| Directory             | String  | Geben Sie den Ordner an, in dem sich die zu verwendenden Dateien befinden.                                                                                |                                                                                     |
| Is Lazy               | Boolean | Hierüber werden Bilder erst geladen, wenn sie tatsächlich benötigt werden, wodurch die Auswirkungen auf die Performance reduziert werden kann.            | Mögliche Werte: * True * False                                                      |
| Image Type            | Enum    | Die Anzeige der Bilder kann in Graustufe oder Farbe erfolgen.                                                                                             | Mögliche Werte: * Grayscale: Bildanzeige in Graustufe * Color: Bildanzeige in Farbe |
| Cycle Images          | Boolean | Nutzer können hier entscheiden, ob nach einem vollständigen Durchlauf des Ordners eine erneute Iteration von Beginn an durchgeführt werden soll.          | Mögliche Werte: * True * False                                                      |
| Version               | Enum    | Wählen Sie die SMB Protokoll Version aus. Es empfiehlt sich die Nutzung von V3 - je neuer das Protokoll, desto besser sind Sicherheit und Performance.    | Mögliche Werte: * V1 * V2 * V3                                                      |
| Server Address        | String  | Die IP-Adresse oder der Hostname des NAS- oder SMB-Servers, zu dem Sie eine Verbindung herstellen möchten.                                                | 10.30.4.222                                                                         |
| Transport Type        | Enum    | Wählen Sie einen passenden Typen basierend auf Ihrer Netzwerk-Konfiguration und Server-Kompatibilität. Die Nutzung von DirectTCPTransport wird empfohlen. | Mögliche Werte: * NetBiosOverTCP * DirectTCPTransport                               |
| Domain Name           | String  | Die dem Server zugeordnete Authentifizierungsdomäne.                                                                                                      |                                                                                     |
| Username              | String  | Geben Sie Ihren Nutzernamen an, der zur Authentifizierung bzw. zum Verbindungsaufbau genutzt werden soll.                                                 | DeinName                                                                            |
| Password              | Secret  | Geben Sie das Passwort an, welches zur Authentifzierung bzw. zum Verbindungsaufbau genutzt werden soll.                                                   | \<DeinToken\>                                                                       |
| Authentication Method | Enum    | Wählen Sie aus einer Verschlüsselungsmethode aus. Die Nutzung von NTLMv2 wird empfohlen.                                                                  | Mögliche Werte: * NTLMv1 * NTLMv1 Extended Session Security * NTLMv2                |

## Komponentenmethoden

### Get Latest Image File Name

Als Teil der Komponenten **File Camera, SMB Camera und Azure Storage Blob Camera** wird die Methode **Get Latest Image File Name** bereitgestellt. Die Methode dient dazu, den Dateinamen des zuletzt erfassten Bildes der angegebenen Komponente abzufragen. Der ermittelte Dateiname kann für nachgelagerte Prozesse, beispielsweise für spezifisches Logging oder die Zuordnung von Dateien, verwendet werden, ohne den bestehenden Bilderfassungsprozess zu beeinflussen. Falls kein Dateiname ermittelt werden kann oder sich die Bildquelle in einem Fehlerzustand befindet, wird ein leerer String zurückgegeben.

Nachdem die entsprechende Kamera-Komponente erstellt wurde, kann die Methode über das Node-Menü der Komponente ausgewählt und konfiguriert werden.  
![grafik-20260817-124530.png](https://doku.evoviu.de/__attachments/a_4fc6ee3df130b207748c941d71a2c1a041e80504394527121c4cc46797fecca9/grafik-20260817-124530.png?cb=75fef791be626ec2281e9eeb041211c7)

---
version: "8.6.0"
language: "de"
---
# Changelog (evoviu)

## Version 8.6.0

Release date: 2026-08-31

### Zusammenfassung

*
  * Gezielter Bildabruf von SMB-Speichern

  * Optimierung der Systemstabilität bei hoher Last:

  * Dynamische Dateiverarbeitung im Workflow

  * Erweiterte Bild-Metadaten und Fehlerkorrekturen

  * Verbesserung von Draw-Funktionen im Workflow sowie der Analyse im Histogramm

## Version 8.5.1

Release date: 2026-08-12

### Zusammenfassung

* Behebung eines kritischen Fehlers bei der Erstinbetriebnahme, der durch fehlende Verzeichnisse zu Log-Spam und potenziellen Startproblemen führte.

* Optimierung der Systemstabilität durch eine Vorabprüfung auf existierende Pfade vor dem Start der automatischen Verzeichnisüberwachung.

## Version 8.5.0

Release date: 2026-08-05

### Zusammenfassung

* Die Anwendung unterstützt nun die Nutzung externer SD-Karten zur flexiblen Speicherung und Verwaltung von Bildern und Prozessdaten.

* Nutzer können die MQTT-Kommunikation durch konfigurierbare Qualitätsstufen (QoS) und erweiterte Abonnement-Optionen stabiler und flexibler gestalten.

* Eine neue visuelle Füllstandsanzeige und detaillierte Speicherübersichten in den Einstellungen ermöglichen die proaktive Überwachung aller Speichermedien.

## Version 8.4.2

Release date: 2026-07-01

### Zusammenfassung

* **Verbesserte Fehlerbehandlung in der Image Source:** Es wurde ein Problem behoben, bei dem Backend-Fehler (z. B. durch ungültige Kamera-Einstellungen wie zu hohe Belichtungszeiten oder Auflösungen) nicht einheitlich an die Benutzeroberfläche gemeldet wurden. Fehlermeldungen werden nun zuverlässig als Pop-up angezeigt, und der betroffene Prozess wird korrekt gestoppt, um Folgefehler (wie den "409 Conflict") bei einem Neustart zu vermeiden.

## Version 8.4.1

Release date: 2026-06-30

### Zusammenfassung

* Behebung eines kritischen Speicherlecks (Memory Leak) im ONNX-Erkennungscode für Lasercodes. Dies stellt die Systemstabilität im Dauerbetrieb sicher und macht den zuvor notwendigen täglichen Neustart der Kamera hinfällig.

## Version 8.4.0

Release date: 2026-06-24

### Zusammenfassung

* Umfangreiches System-Branding

* Erweiterte GPIO-Steuerung

* Optimierte Bildaufnahme und Sensor-Support

* Verbesserte Workflow-Stabilität und UX

* Sicherheits-Updates und Wartung

## Version 8.3.3

Release date: 2026-06-23

### Zusammenfassung

* Optimierung der OPC-UA Ereignissteuerung

## Version 8.3.2

Release date: 2026-06-22

### Zusammenfassung

* Behebung eines kritischen Startfehlers bei aktivem Login-Panel

## Version 8.3.1

Release date: 2026-06-09

### Zusammenfassung

* Stabilität des Kamera-Subsystems bei Verbindungsfehlern

* Automatischer Recovery-Modus (Auto-Reboot)

* Optimierte System-Initialisierung

* Verbesserte Nutzerinformation im Fehlerfall

## Version 8.3.0

Release date: 2026-05-20

### Zusammenfassung

* Umfangreiche Plugin-Verwaltung in der Benutzeroberfläche

* Verbesserte Netzwerk-Kompabilität für AEM-Integrationen

* Echtzeit-Statusüberwachung für Workflow-Komponenten

* Optimierte Benutzererfahrung und Bildverarbeitung

* Sicherheits-Updates und Plattform-Modernisierung

## Version 8.2.0

Release date: 2026-05-04

### Zusammenfassung

* Einführung einer umfassenden Histogramm-Anzeige sowohl in der Image Source als auch im Workflow, inklusive statistischer Merkmale (Mean, Median, Max/Min) und Kanal-Auswahl.

* Implementierung eines neuen, generischen Status-Modells für Komponenten (WCS), das Verbindungszustände (Connected, Error, etc.) in Echtzeit via SignalR visualisiert.

* Signifikante Performance-Optimierung durch die asynchrone Auslagerung von Bild-Berechnungen in eine Worker-Queue.

* Erweiterung der Workflow-Bibliothek um den "Get Text Size" Node zur präzisen Positionierung von Textelementen sowie die Behandlung von Regionen als Primitiv-Typ.

## Version 8.1.1

Release date: 2026-04-09

### Zusammenfassung

* Die Kompatibilität der evoVIU Plattform mit GigE Vision Kameras wurde erweitert.

* Verbesserte Integration ermöglicht den Einsatz weiterer Kameramodelle im Workflow.

* Anwender profitieren von einer größeren Auswahl an unterstützten Kameras und erhöhter Flexibilität bei der Systemkonfiguration.

## Version 8.1.0

Release date: 2026-04-07

### Zusammenfassung

* Integration der GenICam-Schnittstelle inklusive Unterstützung für GigE Vision sowie Erweiterungen für Kamera-Parameter.

* Implementierung der Nodes Find Homography und Perspective Transform um Bildbereiche geometrisch zugeordnen und perspektivisch transformieren zu können

* Einbindung einer Import- und Export-Funktion von Structs

* Aufnahme von komplexen Datentypen im Bereich der persistenten Variablen

* Verbesserungen im Bereich User Experience, u.a. durch General Settings Tab, Refactoring der Netzwerkeinstellungen und optimierte Fehlermeldungen.

## Version 8.0.4

Release date: 2026-03-17

### Zusammenfassung

* Der Export von Workflows im Image Source Component ist jetzt auch ohne verlinkte IMG Source möglich.

* Das Problem mit abweichenden Hintergrundfarben im Dashboard wurde behoben.

* Verbesserte Konsistenz und Zuverlässigkeit im Workflow-Export und der Dashboard-Darstellung.

## Version 8.0.3

Release date: 2026-03-13

### Zusammenfassung

* Überarbeitete Number-Input-Komponente für klarere Validierung und Fehlermeldungen

* Min-/Max-Grenzwerte werden bei gültigen Eingaben transparent angezeigt

* Ungültige oder nicht-numerische Eingaben werden mit verständlichen Hinweisen abgefangen

## Version 8.0.2

Release date: 2026-03-11

### Zusammenfassung

* Verhindern mehrfacher MQTT-Subscriptions

* Korrektur der Unsubscribe- und Disconnect -Implementierung

* Stabilisierung der Reconnect-Mechanik

## Version 8.0.1

Release date: 2026-03-06

### Zusammenfassung

* Korrekte Rückgabewerte bei mehrmaligem Funktionsaufruf mit unterschiedlichen Inputs

## Version 8.0.0

Release date: 2026-03-05

### Zusammenfassung

* Rebranding der Web-Anwendung mit überarbeitetem Bedienkonzept der Image Source

* Wechsel von Varianten innerhalb des Workflows per Node

* Not-Aus-Funktion zum Stoppen des aktiven Workflows

* Zahlreiche Verbesserungen und Anpassungen am File System

* Weiterentwicklung des Plot Text Nodes

* Erweiterung der NATS Client Komponente um Creds-File

### Neue Nodes

* Autofocus

* Change Variant

* Split Region

### Obsolete Nodes

* Adaptive Threshold

* Find Single Edge

* Get Image Size

* Read Multiple 1D/2D Codes

* While Loop

* Start Row (Float)

* Add To Row (DateTime)

* Start Row (DateTime)

* Add To Row (Byte)

* Start Row (Byte)

* Add To Row (Boolean)

* Start Row (Boolean)

* Add To Row (Integer)

* Start Row (Integer)

* Add To Row (String)

* Start Row (String)

* Crop By Box

* Crop By Rectangle

* Crop Circular Part

* Crop By Polygon

* Crop By Region

* Draw Circle

* Draw Segment

* Draw Line

* Draw Polyline

* Draw Rectangle

* Reduce Domain To Box

* Reduce Domain To Rectangle

* Reduce Domain To Region

* Reduce Domain To Circular Part

* Reduce Domain To Polygon

* Sensor Code Bookmark

### Obsolete Components

* Send SFTP

## Version 7.13.2

Release date: 2026-02-11

### Zusammenfassung

* Vornahme von Korrekturen beim Import-Prozess von Workflow-Funktionen und Datenbanken

## Version 7.13.1

Release date: 2026-02-09

### Zusammenfassung

* Übernahme von Einstellungen bei laufender Bildquelle

## Version 7.13.0

Release date: 2026-02-04

### Zusammenfassung

* Bereitstellung einer Kalibrierfunktion

* Enclosing-Funktion im Workflow

* Integration weiterer Min- und Max-Operatoren im Workflow

### Neue Nodes

* Clear Array

* Crop By Shape

* Enclosing Box (Contours)

* Enclosing Circle (Contours)

* Enclosing Circle (Region)

* Enclosing Rectangle (Region)

* From Unix Time Seconds

* Make (DateTime)

* Max Of Byte Array

* Max Of Float Array

* Min Of Byte Array

* Min Of Float Array

* Parse (DateTime)

* Reduce Domain To Shape

* To Unix Time Seconds

## Version 7.12.2

Release date: 2026-01-13

### Zusammenfassung

* Korrektur der Abbruchbedingung im Knoten While Loop

### Neue Nodes

* While Loop

### Obsolete Nodes

* While Loop

## Version 7.12.1

Release date: 2025-12-17

### Zusammenfassung

* Fehlerbehandlung bei der Nutzung von Konstanten innerhalb von Funktionen im Workflow

## Version 7.12.0

Release date: 2025-12-15

### Zusammenfassung

* Import- und Exportfunktion für Custom Functions

* Integration von YOLO

* Verbesserte Kantendetektion mit Find Edges

* Gesteigerte Performance bei Draw-Funktionen

* Erweiterung des Workflows um eine S7 PLC Trigger Funktion

* Angleichung von Layout und Steuerung der Image Source an Workflow

* Kleinere Anpassungen am Design der Anwendung

### Neue Nodes

* Break Npu Inference Yolo Classification Settings

* Break Npu Inference Yolo Detection Settings

* Break Npu Inference Yolo Segmentation Settings

* Break Onnx Inference Yolo Classification Settings

* Break Onnx Inference Yolo Detection Settings

* Break Onnx Inference Yolo Segmentation Settings

* Camera Bookmark

* Classify Image (NPU)

* Classify Image (ONNX)

* Detect Objects (NPU)

* Detect Objects (ONNX)

* Device Name Bookmark

* Display Bookmark

* Docker Bookmark

* Find Edges

* Focus Bookmark

* IP Address Bookmark

* Lens Bookmark

* Light Bookmark

* Load Image From File System

* MAC Address Bookmark

* Make Npu Inference Yolo Classification Settings

* Make Npu Inference Yolo Detection Settings

* Make Npu Inference Yolo Segmentation Settings

* Make Onnx Inference Yolo Classification Settings

* Make Onnx Inference Yolo Detection Settings

* Make Onnx Inference Yolo Segmentation Settings

* Segment Instances (NPU)

* Segment Instances (ONNX)

* Sensor Code Bookmark

* Serial Number Bookmark

* Sort Edges

* Trigger (S7 Plc Trigger)

* Wireless Bookmark

### Neue Components

* Generic Event

* NPU Yolo Classification

* NPU Yolo Detection

* NPU Yolo Segmentation

* ONNX Yolo Classification

* ONNX Yolo Detection

* ONNX Yolo Segmentation

* S7 Plc Trigger

### Neue Widgets

* -

### Obsolete Nodes

* -

### Obsolete Components

* -

## Version 7.11.0

Release date: 2025-11-10

### Zusammenfassung

* Erweiterung des Workflows um eine Mustererkennungsfunktion

* Verbesserung der User Experience bei der Konfiguration von Annotationen

* Einstellungsänderungen der Image Source im Workflow zur Laufzeit

* Bereitstellungen von fortgeschrittenen Werkzeug zur Untersuchung von Histogrammen

* Einbindung von Bookmarks im Workflow

* Automatisches Befüllen des Graphen einer Custom Function mit essenziellen Knoten

* Update der verwendeten Tesseract-Version

### Neue Nodes

* Break Bookmark Settings

* Break Contour Data

* CLAHE

* Equalize Histogram

* Expand Contrast

* Find Pattern

* Get Bookmark

* Literal (PatternMatchingMode)

* Make Bookmark Settings

* Make Contour Data

* Parse (PaternMatchingMode)

* Select (PatternMatchingMode)

* Switch (PatternMatchingMode)

* To String (PatternMatchingMode)

* Turn On Lights With Intensity

* Turn On Loxi

* Update Bookmark

* Update Settings (Camera)

### Neue Components

* Bookmark

## Version 7.10.2

Release date: 2025-10-27

### Zusammenfassung

* Fehlerbehandlung beim Zusammenführen des Branch-Nodes

## Version 7.10.1

Release date: 2025-10-22

### Zusammenfassung

* Fehlerbehandlung beim Import von Konfigurationen und Datenbänken

## Version 7.10.0

Release Date: 2025-10-06

### Zusammenfassung

* Kompilier-Funktion für Workflows mit Auflistung von Informationen im Fehlerfall

* Farbige Kenntlichmachung sowie direkte Auswahlmöglichkeit von fehlerhaften Nodes

* Rechtliche Hinweise mit einer Auflistung aller verwendeten Pakete sowie zugehöriger Lizenztexte

* Berechnung von Histogrammen im Workflow

* Konfiguration der Anzeigeinformationen im Output

### Neue Nodes

* Break Histogram Bin

* Break Image Histogram

* Break Image Histogram Channel

* Calculate Histogram

* Literal (HistogramAnalysisType)

* Make Histogram Bin

* Make Image Histogram

* Make Image Histogram Channel

* Parse (HistogramAnalysisType)

* Reboot

* Restart

* Select (HistogramAnalysisType)

* Switch (HistogramAnalysisType)

* To String (HistogramAnalysisType)

### Neue Components

* System

### Neue Widgets

* Event Button Widget

### Obsolete Nodes

* -

### Obsolete Components

* System Information

## Version 7.9.1

Release date: 2025-09-16

### Zusammenfassung

* Fehlerbehandlung für zyklische Ausführung von Custom Functions

* Fehlerbehandlung beim Setzen von Point2D-Variablen in Custom Functions

## Version 7.9.0

Release date: 2025-09-10

### Zusammenfassung

* Konfiguration der MQTT Verbindung mit Protokoll-Versionen

## Version 7.8.0

Release date: 2025-09-02

### Zusammenfassung

* Lösen komplexer mathematischer Berechnungen anhand der Formulas bzw. Calculate Knoten

* Verbindungstypen OPC UA, NATS.io und Adobe Experience Manager verfügbar

* Integration von Event Components zum zyklischen und manuellen Auslösen von Aktionen

* Zahlreiche kleinere Bugfixes im Zusammenhang mit den Custom Functions

* Verbesserte Performance bei der ersten Bildaufnahme

### Neue Nodes

* AEM Upload (Adobe)

* Break Aem Options

* Break H 264 Rtsp Server Settings

* Break H 264 Rtsp Server Component Settings

* Break Mjpeg Rtsp Server Settings

* Break Mjpeg Rtsp Server Component Settings

* Break Nats Client Settings

* Break Nats Subscription Settings

* Break OPC-UA Client Settings

* Break OPC-UA Subscription Settings

* Calculate

* Connection State Changed (OPC-UA Client)

* Data Changed (OPC-UA Subscription)

* Deserialize Array From JSON

* Make Aem Options

* Make H 264 Rtsp Server Settings

* Make H 264 Rtsp Server Component Settings

* Make Mjpeg Rtsp Server Settings

* Make Mjpeg Rtsp Server Component Settings

* Make Nats Client Settings

* Make Nats Subscription Settings

* Make OPC-UA Client Settings

* Make OPC-UA Subscription Settings

* Next Occurrence (Scheduler)

* Read Value (OPC-UA)

* RTSP App Source Push Buffer

* RTSP Start Stream

* RTSP Stop Stream

* Scheduler (Scheduler)

* Serialize Array From JSON

* Subscription (NATS Subscription)

* Trigger (Button Event)

* Upload Csv (Azure Table)

* Write Value (OPC-UA)

### Neue Components

* AEM Connection (Adobe)

* Button Event

* H264 RTSP Server

* MJPEG RTSP Server

* NATS Client

* NATS Subscription

* OPC-UA Client

* OPC-UA Subscription

* Scheduler Event

## Version 7.7.2

Release date: 2025-08-07

### Zusammenfassung

* Erkennen der Docker-Variante (VIU2)

## Version 7.7.1

Release date: 2025-08-04

### Zusammenfassung

* Ausführung von Custom Functions mit Array-Parametern

## Version 7.7.0

Release date: 2025-07-28

### Zusammenfassung

* Einbinden von Sub-Graphen im Workflow

* Größere Flexibilität bei der Vergabe von Labels für Components

* Einführung von optionalen Inputs bei Nodes

* Erweiterung der Image Analyze Nodes um Mask Input

* Verbesserte Darstellung von Metriken im Output

* Erweiterung der Threshold Nodes um die Ausgabe des Otsu Threshold Values

* Anzeige der Uptime

#### Neue Nodes

* Color Threshold

* Find Circle

* Sort Contours

## Version 7.6.1

Release date: 2025-07-10

### Zusammenfassung

* Korrekte, einmalige Ausführung von Increment und Decrement Nodes im Workflow

## Version 7.6.0

Release date: 2025-06-23

### Zusammenfassung

* Zusammenfügen von Bildern zu hochauflösenden Aufnahmen

* Verbesserte User Experience bei Nutzung des Autofokus

* Geschwindigkeitsverbesserungen an verschiedenen Stellen

#### Neue Nodes

* Stitch

## Version 7.5.0

Release date: 2025-05-26

### Zusammenfassung

* Neuer Verbindungstyp ISO on TCP

* Erkennen von Reed Solomon Codes

* Integration weiterer Vermessungswerkzeuge

* Funktionen zum Auslesen von Farbinformationen in Bildern

* Vorschaumodus mit Abspielfunktion für Videos

* Verbessertes Zoom- und Pan-Handling bei Bildanzeige

* Verbesserte RAM-Verwaltung bei der Ausführung von Workflows

### Zusätzliche Informationen

#### Neue Nodes

* Combine RGB Color Channels

* Crop By Shape

* Draw Shape

* Measure Angle (Line)

* Measure Angle (Segment)

* Measure Line To Line

* Reduce Domain To Shape

* Reed Solomon

* Region Size

* Sort Regions

* Split Image in HSV

* Split RGB Color Channels

* To String (Enum)

#### Neue Components

* ISO on TCP

#### Obsolete Nodes

* Crop By Box

  * Ersetzt durch Crop By Shape

* Crop By Rectangle

  * Ersetzt durch Crop By Shape

* Crop Circular Part

  * Ersetzt durch Crop By Shape

* Crop By Polygon

  * Ersetzt durch Crop By Shape

* Crop By Region

  * Ersetzt durch Crop By Shape

* Reduce Domain To Box

  * Ersetzt durch Reduce Domain To Shape

* Reduce Domain To Rectangle

  * Ersetzt durch Reduce Domain To Shape

* Reduce Domain To Circular Part

  * Ersetzt durch Reduce Domain To Shape

* Reduce Domain To Polygon

  * Ersetzt durch Reduce Domain To Shape

* Reduce Domain To Region

  * Ersetzt durch Reduce Domain To Shape

* Draw Circle

  * Ersetzt durch Draw Shape

* Draw Polyline (geschlossene Variante)

  * Ersetzt durch Draw Shape

* Draw Rectangle

  * Ersetzt durch Draw Shape

* Draw Box

  * Ersetzt durch Draw Shape

* Draw Segment

  * Ersetzt durch Draw Line Variant

* Draw Line

  * Ersetzt durch Draw Line Variant

* Draw Polyline (offene Variante)

  * Ersetzt durch Draw Line Variant

---
version: "8.6.0"
language: "de"
---
# Cloudspeicher

VISIONWEB kann Dateien und Daten direkt in Cloud-Umgebungen übertragen um Integrationen, Auswertungen oder Weiterverarbeitung zu ermöglichen.  

|           **Cloud**            |                                                                               **Beschreibung**                                                                               |                         **Anleitung**                         |
|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------|
| Microsoft Azure                | VISIONWEB unterstützt Azure Blob Storage zur sicheren Ablage von Bildern, Logdaten und Ergebnissen in der Microsoft-Cloud. Ideal für zentrale, skalierbare Speicherlösungen. | [working Azure](https://doku.evoviu.de/de/product-documentation/8.6.0/azure.md)     |
| Amazon Web Services (AWS)      | Über Amazon S3 lassen sich Daten aus VISIONWEB direkt in die AWS-Cloud schreiben. Dies ermöglicht eine einfache Anbindung an Analyse-, KI- oder Archivierungsdienste.        | [working AWS](https://doku.evoviu.de/de/product-documentation/8.6.0/aws.md)         |
| Adobe Experience Manager (AEM) | VISIONWEB kann Bild- und Metadaten direkt an Adobe Experience Manager übertragen -- ideal für die Integration in Digital-Asset-Management- oder Web-Content-Systeme.         | [working Adobe](https://doku.evoviu.de/de/product-documentation/8.6.0/adobe-aem.md) |

---
version: "8.6.0"
language: "de"
---
# Code & Text

## Read Single 1D/2D Code

Mit diesem Knoten können Sie einen einzelnen 1D/2D-Code aus Ihrem Bild auslesen. Dabei werden folgende Formate unterstützt:  

| **Typ**  |                                                      **Einsatzbereich**                                                      |                                                     **Nutzen**                                                      |
|----------|------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------|
| Codabar  | * Medizin (Blutbanken, Laborproben) * Bibliotheken * Logistik und Kurierdienste                                              | Einfacher, sehr robuster Code, der auch mit alten oder einfachen Druckern gut funktioniert.                         |
| Code 39  | * Industrie (Automobil, Defense, Luftfahrt) * Inventar- und Asset-Tracking * Zugangskarten                                   | Kann Buchstaben, Zahlen und einige Sonderzeichen darstellen. Wird häufig in industriellen Anwendungen genutzt.      |
| Code 93  | * Erweiterung / Optimierung von Code 39 * Logistik, interne Systemcodes                                                      | Höhere Datendichte und Zuverlässigkeit als Code 39; unterstützt denselben Zeichensatz, benötigt aber weniger Platz. |
| Code 128 | * Versandetiketten (z. B. UPS) * Logistik \& Lagerhaltung * GS1-128 für standardisierte Waren- und Lieferketteninformationen | Sehr kompakt, unterstützt den vollständigen ASCII-Satz. Ideal für viel Information auf kleinem Platz.               |
| EAN-8    | * Kleinformatige Produkte (z. B. Kaugummi, kleine Kosmetikprodukte)                                                          | Gleiche Funktion wie EAN-13, aber kürzer. Wird genutzt, wenn ein großes Etikett keinen Platz hat.                   |
| EAN-13   | * Europäischer Einzelhandel, Supermärkte                                                                                     | Internationaler Standard für Konsumgüterkennzeichnung. Wird überall im Handel gescannt.                             |
| ITF      | * Verpackungseinheiten / Kartons (nicht Einzelprodukte!)                                                                     | Gut für Druck auf Wellpappe, sehr robust gegen Verzerrungen. Kodiert nur Zahlen.                                    |
| MSI      | * Preisetiketten * Bestandsverwaltung * Bibliothekssysteme (ältere Systeme)                                                  | Einfache Integration, aber weniger normiert. Kodiert nur Zahlen.                                                    |
| RSS-14   | * Frischeprodukte (z. B. Obst, Gemüse) * Coupons * Globale Lieferketten                                                      | Kann mehr Informationen speichern (z. B. Chargen- oder Verfallsdaten) auf kleinerem Raum als EAN/UPC.               |
| UPC-A    | * Einzelhandel in den USA / Kanada                                                                                           | Nordamerikanisches Pendant zum EAN-13 (12-stellig).                                                                 |
| UPC-E    | * Sehr kleine Verpackungen im US-Einzelhandel                                                                                | Kompakte Version von UPC-A (komprimiert Nullen).                                                                    |

### Flow

Unser Beispiel arbeitet mit einer File Camera Komponente und zwei Variablen vom Typ String um den Text und das Format des Codes auslesen zu können.

Zur Vorverarbeitung benötigen wir den Knoten Binary Threshold. Ein Schwellwert, bspw. der Wert 128, wird dabei auf das Eingangsbild angewendet und konvertiert die Pixel in schwarz und weiß. Als Ergebnis erhalten wir eine Region, welche wir zum Auslesen des Codes nutzen können.

Die Nachverarbeitung benötigt den Knoten Break Code Result. Diese Struktur muss zur weiteren Verarbeitung aufgebrochen werden, damit der erkannte Inhalt des Codes sowie das vorliegende Format ausgelesen werden können.  
![Screenshot 2025-11-19 083059.png](https://doku.evoviu.de/__attachments/a_631bf49a7c696ad3c53828eb21427be79af91a835e0921b583a788906dce7c0d/Screenshot%202025-11-19%20083059.png?cb=691ca678a88730e968a4bde80051eb5d)

### Parameterset

| **Parameter** |   **Typ**   |                                                                                                     **Beschreibung**                                                                                                      |
|---------------|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Region        | Region      | Binärbild, welches über die Vorverarbeitung, bspw. über den Knoten Binary Threshold, erzeugt werden kann und zum Auslesen von Codes benötigt wird.                                                                        |
| Return        | Code Result | Der im Code eingebettete Wert wird als Codeergebnis zurückgegeben, das einen „Text" und das „Codeformat" enthält. Verwenden Sie einen „Break Code Result"-Knoten, um auf die einzelnen Teile des Ergebnisses zuzugreifen. |

## Read Data Matrix Code

Mit diesem Knoten können Sie einen Data-Matrix-Code aus Ihrem Bild auslesen. Ein Data-Matrix-Code ist ein zweidimensionaler Code, der aus schwarzen und weißen quadratischen Modulen besteht, die in einem Rastermuster angeordnet sind.

### Flow

Unser Beispiel arbeitet mit einer File Camera Komponente und einer Variablen vom Typ String-Array um den Text bzw. die Ergebnisse auslesen zu können. Eine Vor- oder Nachverarbeitung des Auslesevorgangs ist nicht notwendig.  
![Screenshot 2025-11-19 084244.png](https://doku.evoviu.de/__attachments/a_259d0e345a5b0933ba85d175679a49ca337040307ea941658715ab328d72d528/Screenshot%202025-11-19%20084244.png?cb=8de82c6842b786bc50e623a42880a8ce)

### Parameterset

| **Parameter** |    **Typ**     |                                    **Beschreibung**                                     |
|---------------|----------------|-----------------------------------------------------------------------------------------|
| Image         | Image          | Das Eingangsbild, welches den Data Matrix Code enthält.                                 |
| Return        | String (Array) | Rückgabewert in Form eines String-Arrays, der alle im Code eingebetteten Werte enthält. |

## Read Text

Dieser Knoten ermöglicht es Ihnen, Text in Ihrem Bild zu lesen, auch bekannt als OCR (optische Zeichenerkennung).

### Flow

Unser Beispiel arbeitet mit einer File Camera Komponente, einer Variablen vom Typ String um den Text auslesen zu können, sowie einer Variablen vom Typ Single um die Qualität des Auslesevorgangs bewerten zu können. Eine Vor- oder Nachverarbeitung des Auslesevorgangs ist nicht notwendig.

Der Knoten Read Text erfordert die Angabe einer Sprache und eines Modus. Als Sprachen stehen Ihnen aktuell deutsch und englisch zur Verfügung. Der Modus wird benötigt um die Genauigkeit auf Basis der Textstruktur zu verbessern.  
![Screenshot 2025-11-19 085031.png](https://doku.evoviu.de/__attachments/a_9700c2265c67e8edc0b29f7a811e2382ac562da6e4d372435657df78fef8d56b/Screenshot%202025-11-19%20085031.png?cb=5afbd30a26efb5dfef6d35ee66aff1b7)

### Parameterset

| **Parameter** |   **Typ**    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         **Beschreibung**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|---------------|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image        | Das Eingangsbild, welches den Text enthält.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Language      | TextLanguage | Die Sprache, in der der Text vorliegt. Dieser Knoten kann aktuell mit deutsch und englisch umgehen. Gültige Werte sind daher English und German.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Mode          | Mode         | Die Wahl des passenden Modus verbessert die OCR-Genauigkeit basierend auf der Textstruktur. * Automatic: Vollautomatische Seitensegmentierung, aber keine Bildschirmdarstellung (OSD). * Automatic Only: Erkennt automatisch das Textlayout, ohne Ausrichtung oder Sprache zu prüfen. * Automatic Osd: Erkennt automatisch das Textlayout auf der Seite und ermittelt Ausrichtung und Sprache. * Circle Word: Geht davon aus, dass das Bild ein Wort in einem Kreis enthält. * Osd Only: Ermittelt lediglich Ausrichtung und Sprache des Textes, ohne den Text zu lesen. * Raw Line: Behandelt das Bild als einzelne Textzeile und ignoriert jegliche spezielle Verarbeitung durch die Software. * Single Block: Nützlich, wenn das Bild einen Textblock mit einheitlicher Schriftgröße und Ausrichtung enthält, wie z. B. in einem Buch oder einer E-Mail. * Single Block Vertical Line: Nützlich, wenn das Bild einen vertikal ausgerichteten Textblock enthält. * Single Char: Nützlich, wenn das Bild nur ein einzelnes Zeichen enthält. * Single Column: Nützlich, wenn das Bild eine einzelne Textspalte mit unterschiedlichen Schriftgrößen enthält, wie z. B. eine Tabellenkalkulation oder eine Quittung. * Single Line: Nützlich, wenn das Bild eine einzelne Textzeile enthält, z. B. ein Logo, ein Nummernschild oder ein Etikett. * Single Word: Nützlich, wenn das Bild nur ein Wort enthält, z. B. ein Logo oder ein Etikett. * Sparse Text: Versucht, so viel Text wie möglich im Bild zu finden, ohne auf Reihenfolge oder Ausrichtung zu achten. * Sparse Text Osd: Wie „Sparse Text", jedoch mit OSD-Funktion. |

---
version: "8.6.0"
language: "de"
---
# Compile & Error Handling

## Compile-Funktion

Wenn ein neuer Workflow entsteht, der bspw. auch eine Verbindung zu externen Servern oder Diensten aufbaut, könnte es sein, dass das Aktivieren dieses Workflows an anderer Stelle für Komplikationen sorgt. Oftmals möchte man trotzdem wissen, ob der entwickelte Workflow in seiner Form vollständig ist und gestartet werden kann. In diesem Fall schafft die Compile-Funktion Abhilfe.

Die Compile-Funktion befindet sich im Workflow in der rechten oberen Ecke des Tabs Event Graph. Der Zustand wird dabei über ein farbiges Icon visualisiert. Das grüne Häkchen symbolisiert einen vollständigen, funktionsfähigen Workflow - das rote Ausrufezeichen hingegen weist auf Fehler hin. Über den rechts daneben platzierten gelben Button mit dem autorenew-Icon kann der Compile-Vorgang ausgelöst werden, die Ergebnisanzeige erfolgt unmittelbar. Ein Beispiel:

### Beispiel

Wir fügen im Tab Event Graph die Knoten Start und Grab Image (Camera) hinzu und verbinden diese miteinander. Anschließend führen wir die Compile-Funktion durch einen Klick auf den gelben Button aus und erhalten als Resultat einen Fehler. Doch wie gehen wir nun damit um?  
![Screenshot 2025-09-24 145826.png](https://doku.evoviu.de/__attachments/a_1a2122d68741cafd27f303d11252bebd103cbb17c4008c87f24a0fa33b1f8170/Screenshot%202025-09-24%20145826.png?cb=b1d4bedc0d42f22dc0273f2c832caec6)
Die Compile-Funktion zeigt einen Fehler aufgrund eines fehlenden Inputs beim Knoten Grab Image an.

#### Fehlerfall

Zunächst einmal werden im Tab Event Graph fehlerhafte Knoten mit einem roten Hintergrund farblich hervorgehoben. Zusätzlich wird dort das Ergebnis, in unserem Fall ein Fehler, links neben dem gelben Button zum Starten der Compile-Funktion angezeigt. Dieses Ergebnis wählt per Klick den Tab Errors aus. Der Tab wird ebenfalls mit einem roten Icon hervorgehoben und listet die gefundenen Fehler auf. Für weitere Informationen und Lösungsvorschläge zur Fehlerbehebung kann das Info-Icon angeklickt werden. Anschließend werden im Dialog zusätzliche Hinweise angezeigt.  
![Screenshot 2025-09-24 145855.png](https://doku.evoviu.de/__attachments/a_fa6439b7ee9970381e121a81f804445572321f5a380a1efb2a11af1e68f60834/Screenshot%202025-09-24%20145855.png?cb=dab6bf6aca3a53b306c484e85b058d2e)
Dialog mit Informationen und Hinweise zum vorliegenden Fehler.

Falls der vorliegende fehlerhafte Workflow sehr groß ist, bietet sich die Nutzung des Button rechts neben dem Info-Icon an. Dieser springt automatisch zum fehlerhaften Knoten im Workflow und erspart die Suche. So gelangt man schnell und bequem an die richtige Stelle.

#### Erfolgsfall

Doch zurück zu unserem eigentlichen Beispiel: Wir wollen den Fehler im Workflow beheben. Damit der Knoten Grab Image ausgeführt werden kann, müssen alle Inputs belegt sein. Was noch fehlt ist eine Camera. In diesem Fall kann es auch eine File Camera oder Image Source sein. Hierfür muss eine Component angelegt und im Tab Event Graph hinzugefügt werden. Sobald alle Knoten miteinander verbunden sind, kann die Compile-Funktion erneut aufgerufen werden. Dieses Mal erhalten wir ein positives Ergebnis zurück. Auch der Tab Errors ist wieder leer. Der Workflow kann also erfolgreich gestartet werden.  
![Screenshot 2025-09-24 145805.png](https://doku.evoviu.de/__attachments/a_7316194a6e5dbd47554b10504afd85c1df5fc1cb0e28b482bb57a1f7920dd254/Screenshot%202025-09-24%20145805.png?cb=1d5fdccf2ab708e0e11c8c5af701ae39)

### Fehlertypen

Je nach Anwendungsfall und Konfiguration können unterschiedliche Typen an Fehlern auftreten. Die folgende Tabelle sollen einen Überblick über die jeweiligen Typen, ihre Ursachen sowie die damit verbundenen Lösungsansätze schaffen.  

|                  **Typ**                   |                                                                                                                                        **Information**                                                                                                                                        |
|--------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Duplication Identifier Error               | Der Workflow enthält mehrere Knoten mit derselben ID. Um dieses Problem zu beheben, muss der Knoten entfernt und anschließend erneut hinzugefügt werden.                                                                                                                                      |
| Unknown Node                               | Der Workflow enthält für einen bestimmten Knoten ein unbekanntes Knotenschema. Um dieses Problem zu beheben, muss dieser Knoten entfernt werden.                                                                                                                                              |
| Dynamic Instance Count Not Defined         | Der Workflow hat versucht, einen dynamischen Socket zu verwenden, dieser ist jedoch nicht definiert.                                                                                                                                                                                          |
| Required Dynamic Instance Count Not Met    | Der Workflow konnte nicht kompiliert werden. Die erforderlichen dynamischen Verbindungen konnten nicht hergestellt werden oder fehlen vollständig. Um dieses Problem zu beheben, muss die Verbindung zum Knoten erneut herzustellen.                                                          |
| Missing Data Dependency                    | Der Workflow enthält einen Eingangssteckplatz, bei dem ein erforderlicher Parameter oder Wert fehlt. Um dieses Problem zu beheben muss sichergestellt werden, dass alle erforderlichen Steckplätze, wie z. B. für Bilddateien oder Regionen, korrekt verbunden sind.                          |
| Link To Unknown Socket                     | Der Workflow enthält mindestens einen Link zu einem unbekannten Socket. Tritt auf nach einem Update, wenn sich dabei Nodes verändert haben.                                                                                                                                                   |
| Link To Dynamic Socket Without Instance    | Der Workflow enthält mindestens einen Verweis auf einen dynamischen Anschluss, für den keine Instanz vorhanden ist. Um dieses Problem zu beheben, muss der fehlerhafte Verweis entfernt werden.                                                                                               |
| Link To Unknown Dynamic Socket             | Der Workflow enthält mindestens einen Link zu einem unbekannten dynamischen Socket. Um dieses Problem zu beheben, muss der fehlerhafte Link entfernt werden.                                                                                                                                  |
| Link To Unknown Node                       | Der Workflow enthält mindestens einen Link zu einem unbekannten Knoten. Um dieses Problem zu beheben, muss der fehlerhafte Link entfernt werden.                                                                                                                                              |
| Link On Same Node                          | Der Workflow enthält mindestens einen Link, der auf denselben Knoten verweist. Um dieses Problem zu beheben, muss der fehlerhafte Link entfernt werden.                                                                                                                                       |
| Link Between Incompatible Sockets          | Der Workflow enthält mindestens eine Verbindung zwischen inkompatiblen Anschlüssen. Um dieses Problem zu beheben, muss diese fehlerhafte Verbindung entfernt werden.                                                                                                                          |
| Ambiguous Execution Dependency             | Der Workflow enthält einen Ausgangspunkt für die Ausführung, der mit mindestens zwei Eingangs-Anschlüssen für die Ausführung verbunden ist. Um dieses Problem zu beheben, muss sichergestellt sein, dass der Ausgangspunkt für die Ausführung nur mit einem Eingangs-Anschluss verbunden ist. |
| Ambiguous Data Dependency                  | Der Workflow enthält einen Dateneingangssteckplatz, der mit mindestens zwei Ausgängen verbunden ist. Um dieses Problem zu beheben, muss sichergestellt sein, dass der Dateneingangssteckplatz nur mit einem einzigen Ausgang verbunden ist.                                                   |
| Cyclic Data Dependency                     | Der Workflow enthält einen Knoten, der auf seinen Vorgänger verweist. Um dieses Problem zu beheben, entfernen Sie den Verweis auf den Vorgänger.                                                                                                                                              |
| Cyclic Execution Dependency                | Der Workflow enthält eine Verknüpfung, die einen Loop verursacht. Um dieses Problem zu beheben, muss die Verknüpfung zum vorherigen Schritt entfernt werden.                                                                                                                                  |
| Undefined Wildcard Type                    | Der Workflow enthält einen Platzhalter-Steckplatz, der nicht definiert ist.                                                                                                                                                                                                                   |
| Ambiguous Wildcard Type                    | Der Workflow enthält einen Platzhalter-Steckplatz, dessen Typ nicht bestimmt werden kann, da mehrere Auswahlmöglichkeiten vorhanden sind.                                                                                                                                                     |
| Reference To Loop Variable Outside Of Body | Der Workflow enthält eine Variable oder einen Link, der die Schleife verlässt.                                                                                                                                                                                                                |
| Break Loop Outside Of Body                 | Ihr Workflow enthält zwar einen Eingabeparameter zum Beenden der Schleife, dieser ist jedoch außerhalb der Schleife positioniert.                                                                                                                                                             |
| Illegal Constant                           | Der Workflow enthält eine Konstante mit einer ungültigen Konfiguration. Das bedeutet, dass die Konstante auf einen Ausgang, einen unbekannten Anschluss, einen Ausführungsanschluss oder einen Anschluss verweist, der zwei Konstanten als Eingabedaten verwendet.                            |
| Missing Secret                             | Der Workflow enthält eine Variable, für die ein Geheimschlüssel erforderlich ist, dieser ist jedoch nicht vorhanden. Um dieses Problem zu beheben, muss der Variable ein Geheimschlüssel hinzugefügt werden.                                                                                  |
| Validation Error                           | Der Workflow enthält eine Konstante, die nicht allen Validierungsregeln entspricht.                                                                                                                                                                                                           |
| Invalid Constant Type Mismatch             | Der Workflow enthält einen Eingabetyp, der nicht mit dem erwarteten Typ übereinstimmt und daher nicht konvertiert werden kann.                                                                                                                                                                |
| Invalid Constant Missing Member            | Der Workflow enthält einen Eingabetyp, der auf ein nicht vorhandenes Element verweist.                                                                                                                                                                                                        |
| Invalid Constant Unknown Member            | Der Workflow enthält einen Eingabetyp, der auf kein bekanntes Konstantenmitglied verweist.                                                                                                                                                                                                    |
| Missing Component Settings                 | Der Workflow enthält mindestens ein Element mit fehlenden Werten. Um dieses Problem zu beheben, müssen die fehlenden Werte für die Konstanten des jeweiligen Elements angegeben.                                                                                                              |
| Missing Function Return                    | Der Workflow enthält eine benutzerdefinierte Funktion ohne Rückgabewert. Um dieses Problem zu beheben, muss benutzerdefinierten Funktion ein Rückgabewert hinzugefügt werden.                                                                                                                 |
| Missing Function Function Entry            | Der Workflow enthält eine benutzerdefinierte Funktion ohne Startknoten. Um dieses Problem zu beheben, muss der benutzerdefinierten Funktion ein Startknoten hinzugefügt werden.                                                                                                               |
| Multiple Function Entires                  | Der Workflow enthält eine benutzerdefinierte Funktion mit mehreren Eingangs-Nodes. Um dieses Problem zu beheben, müssen die zusätzlichen Eingangs-Nodes aus der benutzerdefinierten Funktion entfernt werden. Es ist nur ein einziger Eingangs-Node zulässig.                                 |
| Recursive Function Calls                   | Der Workflow enthält eine benutzerdefinierte Funktion, die zu rekursiven Aufrufen führt. Um dieses Problem zu beheben, müssen die Verknüpfungen gelöscht und erneut hinzugefügt werden.                                                                                                       |
| Illegal Node                               | Der Workflow enthält mindestens einen Knoten, der an der falschen Stelle verwendet wird. Um dieses Problem zu beheben, muss der fehlerhafte Knoten entfernt werden.                                                                                                                           |
| Variant Parameter Not Provided             | Der Workflow enthält mindestens einen Variantenparameter, für den kein Wert angegeben wurde. Um dieses Problem zu beheben, muss ein Wert für diesen Variantenparameter angegeben werden.                                                                                                      |

## Schema-Validierungen

### Veränderte Komponenteneinstellungen

Durch Updates der Software sowie der stetigen Weiterentwicklung des Systems können sich Komponenten im Laufe der Zeit verändern. So kann es mitunter vorkommen, dass vormals funktionsfähige Komponenten plötzlich nicht mehr ausgeführt werden können, da Einstellungswerte fehlen. In diesem Fall können veränderte Komponenteneinstellungen am Warn-Icon der Komponente sowie aus dem Details-Tab der Komponente entnehmen werden.  
![Screenshot 2025-09-26 083200.png](https://doku.evoviu.de/__attachments/a_7e1e18751916cb1e63ca7671d345f39d019abae2597e8d356d380e2d45e5448d/Screenshot%202025-09-26%20083200.png?cb=281fb0f7a4dfb35bbe36b18c927b6797)

Der Button "Fix Settings" öffnet einen Dialog mit Erklärungen und Lösungsvorschläge, damit das vorliegende Problem in Sekundenschnelle behoben werden kann. Hierfür muss der Dialog bestätigt werden - ein Abbruch des Dialogs behält den vorliegenden Zustand bei.  
In diesem Dialog können immer auch die gerade vorliegenden mit den neuen, erforderlichen Einstellungen verglichen werden. Dazu muss ggf. der Bereich ausgeklappt werden.  
![Screenshot 2025-09-26 083809.png](https://doku.evoviu.de/__attachments/a_0a4f3fbb759c3fdd7187275fa6a9ecfc5a2a304fc0db9574811849553a9532fd/Screenshot%202025-09-26%20083809.png?cb=0069fd4010c2a7a16761193c00c357b7)

### Verwaiste Konstanten

Analog zu den veränderten Komponenteneinstellungen können auch Konstanten nach einem Update beschädigt sein. Konstanten können verwaisen, wenn bspw. ein Link nicht mehr vorhanden ist. In diesem Fall wird im Tab "Event Graph" am oberen Bildschirmrand eine Leiste mit einem Hinweis eingeblendet.  
![Screenshot 2025-09-26 140634.png](https://doku.evoviu.de/__attachments/a_73241beeffd49586c821b91fd238d08d4de5938f3b596d25197bb5482da6242a/Screenshot%202025-09-26%20140634.png?cb=50366dfe429755b31625ee41bf5aee96)

Über den Button "Show" können die weitere Details angezeigt werden, um ein besseres Verständnis über den vorliegenden Fehler gewinnen zu können. Die Einträge können im Dialog u.a. ausgeklappt werden und warten dann mit detaillierten Informationen zum Schema auf. Des Weiteren können die Fehler über den Mülleimer-Button behoben werden.  
![Screenshot 2025-09-26 140711.png](https://doku.evoviu.de/__attachments/a_639964aa9784f036e647cc6e05bf9540c1472d86fe8a5384775ae430abcb54a2/Screenshot%202025-09-26%20140711.png?cb=1677da5dd56c307651bc5a20c2b59634)

---
version: "8.6.0"
language: "de"
---
# Component Status Widget

## Component Status Widget

Mit dem Component Status Widget können Sie den Verbindungsstatus einer ausgewählten Workflow-Komponente direkt auf dem Dashboard überwachen. Das Widget zeigt Ihnen auf einen Blick, ob eine Komponente aktuell erreichbar ist oder nicht -- und aktualisiert sich in Echtzeit, ohne dass ein Seiten-Reload erforderlich ist. Damit eignet sich das Widget besonders zur Überwachung kritischer Verbindungen, beispielsweise zu Kameras oder SPS-Steuerungen.

### Hinzufügen des Widgets

Fügen Sie auf dem Dashboard das Widget "Component Status" über den "Add"-Button hinzu. Wechseln Sie gegebenenfalls erst in den Editor Mode. Im Dialog zur Auswahl des Widget-Typs finden Sie den Eintrag "Component Status" am Ende der Liste.  
![Screenshot 2026-05-07 120746.png](https://doku.evoviu.de/__attachments/a_3f582f9ab7b5bf2504af668abb16dae1999bb55669b4008c163a3b074b83dea5/Screenshot%202026-05-07%20120746.png?cb=2ae5f3fbbd2f295979688dbf1c6a08c7)

#### Leerer Zustand

Nach dem Hinzufügen wird das Widget zunächst im leeren Zustand angezeigt. Sie sehen die Meldung "No component selected" sowie einen gelben Button "SELECT ONE". Über diesen Button können Sie den Auswahldialog öffnen, um eine Komponente zuzuweisen.  
![Screenshot 2026-05-07 120905.png](https://doku.evoviu.de/__attachments/a_d4b70e1ab403f868ee9be62f729dabb7ae62176349eb0573fc84272aa396ca70/Screenshot%202026-05-07%20120905.png?cb=a2ade1396afae9954ce9e619c6abafc8)

#### Auswahl einer Component

Wenn Sie auf den Button "SELECT ONE" klicken, öffnet sich der Dialog "Choose Status Component". In diesem Dialog werden ausschließlich Components angezeigt, die einen Status unterstützen (sogenannte „statusfähige" Components). Die Liste wird dynamisch aus Ihrem Workflow geladen.

Sie können genau eine Component aus der Liste auswählen, indem Sie den entsprechenden Radiobutton aktivieren. Bestätigen Sie Ihre Auswahl mit dem Button "CONFIRM" oder brechen Sie den Vorgang mit "CANCEL" ab. Beim erneuten Öffnen des Dialogs ist die zuletzt gespeicherte Auswahl vorausgewählt.

Falls keine statusfähigen Components in Ihrem Workflow vorhanden sind, wird im Dialog eine entsprechende Meldung angezeigt.  
![Screenshot 2026-05-07 120927.png](https://doku.evoviu.de/__attachments/a_067b25e478f00e5398cfed35d96c90ae926a0128d5891c16260e7baa604f7402/Screenshot%202026-05-07%20120927.png?cb=0afbd8b46af4f1d708d7fd7178d9084a)

#### Statusanzeige

Sobald Sie eine Component ausgewählt haben, zeigt das Widget deren aktuellen Verbindungsstatus an. Der Status wird über einen farblich codierten Kreis visualisiert:  

| Farbe |      Status      |                                       Bedeutung                                        |
|-------|------------------|----------------------------------------------------------------------------------------|
| Grün  | Erreichbar       | Die Component ist verbunden und aktiv. Zusätzlich wird der Text „Connected" angezeigt. |
| Rot   | Nicht erreichbar | Die Component ist nicht erreichbar oder die Verbindung wurde unterbrochen.             |
| Grau  | Unbekannt        | Der Status konnte nicht geladen werden oder es liegt ein Fehler vor.                   |

Neben dem Farbkreis wird der Name der ausgewählten Component angezeigt (z. B. „Stopwatch" oder „S7 Plc"). Über den gelben Button mit dem Stift-Icon können Sie jederzeit den Auswahldialog erneut öffnen und eine andere Component auswählen.  
![Screenshot 2026-05-07 121102.png](https://doku.evoviu.de/__attachments/a_d8a192d4fd080653bbb1a05f45698034e24baf8023c4bd1a11408240dbb23431/Screenshot%202026-05-07%20121102.png?cb=7289bea1191d684507e93163b30321df)  
![Screenshot 2026-05-07 121033.png](https://doku.evoviu.de/__attachments/a_04fbd473274fc45705044c138ba893697079e6e87aacc71168c49f8d34c77ab3/Screenshot%202026-05-07%20121033.png?cb=85d8200c8d3ac7a7eae02accdc24f06c)  
![Screenshot 2026-05-07 121008.png](https://doku.evoviu.de/__attachments/a_2c9887b374e959099e02cb5027fbfcf985851cd73b3c517462c1398f262559ba/Screenshot%202026-05-07%20121008.png?cb=d593a670c73ecda3ddc196a327dc7ea7)

#### Live-Updates

Die Statusanzeige des Widgets aktualisiert sich automatisch in Echtzeit, sobald sich der Verbindungsstatus der ausgewählten Component ändert. Ein manuelles Neuladen der Seite ist nicht erforderlich. Die visuelle Darstellung wird innerhalb von einer Sekunde nach Eintreffen einer Statusänderung aktualisiert.

#### Hinweise

* **Verbindungsverlust:** Falls die Verbindung kurzfristig unterbrochen wird, bleibt der zuletzt bekannte Status samt Farbdarstellung sichtbar. Nach Wiederherstellung der Verbindung werden alle zwischenzeitlich verpassten Statusänderungen nachgeladen und die Darstellung entsprechend aktualisiert.

* **Warnung bei längerer Unterbrechung:** Ist die Verbindung länger als 30 Sekunden unterbrochen, zeigt das Widget einen Hinweis an, dass die angezeigten Daten möglicherweise nicht aktuell sind.

* **Fehlerzustand:** Wird ein ungültiger oder unbekannter Status empfangen, zeigt das Widget einen definierten Fehlerzustand in Form einer grauen Farbdarstellung und einer Fehlermeldung an.

---
version: "8.6.0"
language: "de"
---
# Components

|                           **Kategorie**                            |                                                      **Komponente**                                                       |                                                                                                                                   |                                                                                                                                                                                                                    **Beschreibung**                                                                                                                                                                                                                     |
|--------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Camera](https://doku.evoviu.de/de/product-documentation/8.6.0/camera-components.md)     |                                                                                                                           |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    | [Azure Storage Blob Camera](https://doku.evoviu.de/de/product-documentation/8.6.0/camera-components.md#Azure-Storage-Blob-Camera)               |                                                                                                                                   | Mit der Azure Storage Blob Camera können Sie Bilder direkt aus dem Blob-Speicher in der Azure-Cloud laden.                                                                                                                                                                                                                                                                                                                                              |
|                                                                    | [Camera](https://doku.evoviu.de/de/product-documentation/8.6.0/camera-components.md#Camera)                                                     |                                                                                                                                   | Diese Komponente ermöglicht den Zugriff auf eine zuvor von Ihnen erstellte Bildquelle. Sie können diese Bildquelle in den Kameraeinstellungen auswählen.                                                                                                                                                                                                                                                                                                |
|                                                                    | [File Camera](https://doku.evoviu.de/de/product-documentation/8.6.0/camera-components.md#File-Camera)                                           |                                                                                                                                   | Eine File Camera greift nicht direkt auf die aktuell aufgenommenen Bildquellen zu. Stattdessen können Sie einen Pfad zu zuvor gespeicherten Bildern angeben. Wählen Sie dazu den Speicherort der gespeicherten Bilder unter „Verzeichnis" aus oder geben Sie den Pfad direkt ein.                                                                                                                                                                       |
|                                                                    | [Image Source](https://doku.evoviu.de/de/product-documentation/8.6.0/camera-components.md#Image-Source)                                         |                                                                                                                                   | Diese Komponente ermöglicht den Zugriff auf eine zuvor erstellte Bildquelle. Sie können diese Bildquelle in den Kameraeinstellungen auswählen. Im Gegensatz zur Camera Komponente, die lediglich die Konfiguration von Bereichen wie Bildformat, Aufnahme, Farbeinstellungen und Automatikfunktionen erlaubt, bietet diese Komponente die vollständige Kontrolle über die Bildquelle innerhalb des Workflows.                                           |
|                                                                    | [Remote Camera](https://doku.evoviu.de/de/product-documentation/8.6.0/camera-components.md#Remote-Camera)                                       |                                                                                                                                   | Mit Remote Camera können Sie auf eine andere evoVIU-Kamera zugreifen, die mit Ihrem Netzwerk verbunden ist.                                                                                                                                                                                                                                                                                                                                             |
|                                                                    | [SMB Camera](https://doku.evoviu.de/de/product-documentation/8.6.0/camera-components.md#SMB-Camera)                                             |                                                                                                                                   | Eine SMB-Kamera erfasst keine Bilder in Echtzeit. Stattdessen ruft sie zuvor gespeicherte Bilder von einem entfernten NAS-Server mithilfe des SMB-Protokolls (Server Message Block) ab. Dies ist nützlich, wenn Bilder von externen Geräten oder evoVIUs erzeugt und zur späteren Verarbeitung gespeichert werden.                                                                                                                                      |
| [Utils](https://doku.evoviu.de/de/product-documentation/8.6.0/utils-components.md)       |                                                                                                                           |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    | [Bookmark](https://doku.evoviu.de/de/product-documentation/8.6.0/utils-components.md#Bookmark)                                                  |                                                                                                                                   | Wählen Sie im Detailbereich dieser Komponente ein zuvor erstelltes benutzerdefiniertes Lesezeichen aus. Diese Komponente muss für die Knoten „Get Bookmark" und „Update Bookmark" vollständig konfiguriert sein.                                                                                                                                                                                                                                        |
|                                                                    | [Button Event](https://doku.evoviu.de/de/product-documentation/8.6.0/utils-components.md#Button-Event)                                          |                                                                                                                                   | Mit dieser Komponente können Sie Ereignisse per Knopfdruck auslösen. Wenn der Workflow aktiv ist und die Komponente im Workflow verwendet wird, erscheint im Bereich „My Workflow" eine gelbe Wiedergabetaste.                                                                                                                                                                                                                                          |
|                                                                    | [CSV](https://doku.evoviu.de/de/product-documentation/8.6.0/utils-components.md#CSV)                                                            |                                                                                                                                   | Eine CSV-Datei ist ein einfaches, textbasiertes Format, das Daten in Zeilen und Spalten organisiert, wobei Kommas als Trennzeichen dienen. Mit dieser Komponente können Sie innerhalb Ihres Workflows eine benutzerdefinierte CSV-Datei erstellen. Sie eignet sich daher ideal zur Anzeige von Datentabellen im Ausgabefenster oder zum Senden von Daten an einen API-Endpunkt.                                                                         |
|                                                                    | [Scheduler](https://doku.evoviu.de/de/product-documentation/8.6.0/utils-components.md#Scheduler)                                                |                                                                                                                                   | Der Scheduler kann als Ereignis innerhalb des Workflows verwendet werden, um Knoten in regelmäßigen Abständen auszulösen, die monatlich, täglich, stündlich oder minütlich festgelegt werden können. Es ist auch möglich, bestimmte Wochentage auszuwählen.                                                                                                                                                                                             |
|                                                                    | [Stopwatch](https://doku.evoviu.de/de/product-documentation/8.6.0/utils-components.md#Stopwatch)                                                |                                                                                                                                   | Diese Komponente ermöglicht die Verfolgung der verstrichenen Zeit in einem Workflow.                                                                                                                                                                                                                                                                                                                                                                    |
|                                                                    | [System](https://doku.evoviu.de/de/product-documentation/8.6.0/utils-components.md#System)                                                      |                                                                                                                                   | Diese Komponente ermöglicht es Ihnen, Informationen über Ihr System abzurufen, z. B. über die Speichernutzung, und Aktionen durchzuführen, z. B. die Kamera neu zu starten.                                                                                                                                                                                                                                                                             |
|                                                                    | [Timer](https://doku.evoviu.de/de/product-documentation/8.6.0/utils-components.md#Timer)                                                        |                                                                                                                                   | Der Timer kann als Ereignis innerhalb des Workflows verwendet werden, um Knoten in regelmäßigen, in Millisekunden (ms) festgelegten Intervallen auszulösen.                                                                                                                                                                                                                                                                                             |
| [Hardware](https://doku.evoviu.de/de/product-documentation/8.6.0/hardware-components.md) |                                                                                                                           |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    | [Digital Write](https://doku.evoviu.de/de/product-documentation/8.6.0/hardware-components.md#Digital-Write)                                     |                                                                                                                                   | Stellen Sie einen Ausgangspin des evoVIU auf ein digitales HIGH- oder LOW-Signal ein. Sie können entweder PIN2 oder PIN4 steuern.                                                                                                                                                                                                                                                                                                                       |
|                                                                    | [Eight Bit Lens](https://doku.evoviu.de/de/product-documentation/8.6.0/hardware-components.md#Eight-Bit-Lens)                                   |                                                                                                                                   | Mit dem 8-Bit-Flüssiglinsentreiber lässt sich der Fokus einer S-Mount-Kamera vom Typ VIUXXX-XX\[0...4\]-X-X in 255 Schritten steuern.                                                                                                                                                                                                                                                                                                                   |
|                                                                    | [Gpio Trigger](https://doku.evoviu.de/de/product-documentation/8.6.0/hardware-components.md#Gpio-Trigger)                                       |                                                                                                                                   | Als Startereignis des Workflows wird der GPIO-Trigger aktiviert, sobald das erwartete Signal von den mit dem evoVIU verbundenen GPIO-Pins empfangen wird.                                                                                                                                                                                                                                                                                               |
|                                                                    | [Loxi Light](https://doku.evoviu.de/de/product-documentation/8.6.0/hardware-components.md#Loxi-Light)                                           |                                                                                                                                   | Die Loxi-Lichtkomponente ermöglicht die Konfiguration der einzelnen LED-Segmente (allerdings nicht visuell wie in der Bildquelle). Jedes Segment kann mit spezifischen Werten belegt werden.                                                                                                                                                                                                                                                            |
| [Connections](https://doku.evoviu.de/de/product-documentation/8.6.0/connections.md)      |                                                                                                                           |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    | [Adobe](https://doku.evoviu.de/de/product-documentation/8.6.0/adobe-aem.md)                                                                     |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | [AEM Connection (Adobe)](https://doku.evoviu.de/de/product-documentation/8.6.0/adobe-aem.md#Anlegen-einer-AEM-Connection)                               | Mit dieser Komponente können Sie eine Adobe Experience Manager-Verbindung für den Upload von Assets definieren. Sie unterstützt die Version AEM as a Cloud Service (AEMaaCS).                                                                                                                                                                                                                                                                           |
|                                                                    | [ISO-on-TCP](https://doku.evoviu.de/de/product-documentation/8.6.0/iso-on-tcp.md)                                                               |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | [ISO-on-TCP Client](https://doku.evoviu.de/de/product-documentation/8.6.0/iso-on-tcp.md#Anlage-einer-ISO-on-TCP-Client-Komponente)                      | Diese ISO-On-TCP-Komponente (Client) ermöglicht es Ihrer Anwendung, als Client in einer ISO-On-TCP-Verbindung zu fungieren für die Übertragung einfacher Datenblöcke.                                                                                                                                                                                                                                                                                   |
|                                                                    |                                                                                                                           | [ISO-on-TCP Server](https://doku.evoviu.de/de/product-documentation/8.6.0/iso-on-tcp.md#Anlage-einer-ISO-on-TCP-Server-Komponente)                      | Diese ISO-On-TCP-Komponente (Server) ermöglicht es Ihrer Anwendung, als Server in einer ISO-On-TCP-Verbindung zu fungieren für die Übertragung einfacher Datenblöcke.                                                                                                                                                                                                                                                                                   |
|                                                                    | [Kafka](https://doku.evoviu.de/de/product-documentation/8.6.0/kafka.md)                                                                         |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | [Kafka Producer](https://doku.evoviu.de/de/product-documentation/8.6.0/kafka.md#Anlage-der-Komponente-Kafka-Producer)                                   | Das Kafka-Protokoll ist eine Messaging-Plattform mit hohem Durchsatz und geringer Latenz, die für die Verarbeitung großer Datenmengen aus verschiedenen Quellen konzipiert ist. Es handelt sich um ein Publish-Subscribe-Messaging-System, das typischerweise zum Speichern und Verarbeiten von Datenströmen in Echtzeit verwendet wird. Die Kafka-Producer-Komponente ist eine Client-Anwendung, die Ereignisse in einem Kafka-Cluster veröffentlicht. |
|                                                                    | [NATS.io](https://doku.evoviu.de/de/product-documentation/8.6.0/nats-io.md)                                                                     |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | [NATS Client](https://doku.evoviu.de/de/product-documentation/8.6.0/nats-io.md#Anlegen-des-NATS-Clients---Schritt-f%25C3%25BCr-Schritt)                 | Die NATS-Client Komponente ermöglicht es Ihrem Workflow, eine Verbindung zu einem NATS-Messaging-Server herzustellen, um Nachrichten zu veröffentlichen und zu abonnieren. Diese Komponente verwaltet Authentifizierung, Sicherheit und Verbindungsparameter und gewährleistet so eine zuverlässige und sichere nachrichtenbasierte Kommunikation zwischen verschiedenen Teilen Ihres Workflows oder externen Systemen.                                 |
|                                                                    |                                                                                                                           | [NATS Subscription](https://doku.evoviu.de/de/product-documentation/8.6.0/nats-io.md#Anlegen-deiner-NATS-Subscription---Schritt-f%25C3%25BCr-Schritt)   | Die NATS-Subscription Komponente ermöglicht es Ihrem Workflow, Nachrichten von einem NATS-Server zu einem bestimmten Thema zu empfangen. Abonnements werden verwendet, um veröffentlichte Daten, Ereignisse oder Anfragen in Echtzeit zu überwachen und so ereignisgesteuerte Workflows und verteilte Kommunikation zu ermöglichen.                                                                                                                     |
|                                                                    | [OPC-UA](https://doku.evoviu.de/de/product-documentation/8.6.0/opc-ua.md)                                                                       |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | [OPC-UA Client](https://doku.evoviu.de/de/product-documentation/8.6.0/opc-ua.md#Anlegen-des-OPC-UA-Clients---Schritt-f%25C3%25BCr-Schritt)              | Der OPC-UA-Client dient zur Verbindung mit einem OPC-UA-Server, der typischerweise auf einer SPS gehostet wird.                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | [OPC-UA Subscription](https://doku.evoviu.de/de/product-documentation/8.6.0/opc-ua.md#Anlegen-einer-OPC-UA-Subscription---Schritt-f%25C3%25BCr-Schritt) | Diese Komponente ermöglicht das Abonnieren einer Variablen. Bitte beachten Sie, dass OPC-UA typbasiert ist; der zugewiesene Typ muss mit dem Typ auf dem Server übereinstimmen.                                                                                                                                                                                                                                                                         |
|                                                                    | [PLC](https://doku.evoviu.de/de/product-documentation/8.6.0/rfc1006.md)                                                                         |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | [S7 Plc](https://doku.evoviu.de/de/product-documentation/8.6.0/rfc1006.md#Anlage-einer-S7-PLC-Komponente)                                               | Diese Komponente bezieht sich auf Ihre SPS (Speicherprogrammierbare Steuerung).                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | [S7 Plc Trigger](https://doku.evoviu.de/de/product-documentation/8.6.0/rfc1006.md#S7-Plc-Trigger)                                                       | Diese Komponente ermöglicht Ihnen eine zyklische Abfrage hinsichtlich neuer vorliegender Daten in Ihrer SPS (Speicherprogrammierbare Steuerung).                                                                                                                                                                                                                                                                                                        |
|                                                                    | [Http Event](https://doku.evoviu.de/de/product-documentation/8.6.0/http.md)                                                                     |                                                                                                                                   | Um den Ausführungsablauf in Ihrem Workflow auszulösen, ist ein Ereignisknoten erforderlich, wie durch die weißen Verbindungslinien angezeigt. Wählen Sie in den Komponenteneinstellungen eine benutzerdefinierte Ereignis-ID aus, um einen eindeutigen Endpunkt für Ihr HTTP-Ereignis zu erstellen.                                                                                                                                                     |
|                                                                    | [MQTT Publish](https://doku.evoviu.de/de/product-documentation/8.6.0/mqtt.md#Anlegen-der-MQTT-Publish---Schritt-f%25C3%25BCr-Schritt)           |                                                                                                                                   | Mit dieser Komponente können Sie einen MQTT-Broker abonnieren, indem Sie dessen Hostnamen, Port und das gewünschte Thema angeben.                                                                                                                                                                                                                                                                                                                       |
|                                                                    | [MQTT Subscription](https://doku.evoviu.de/de/product-documentation/8.6.0/mqtt.md#Anlegen-der-MQTT-Subscription---Schritt-f%25C3%25BCr-Schritt) |                                                                                                                                   | Mit dieser Komponente können Sie einen MQTT-Broker abonnieren, indem Sie dessen Hostnamen, Port und das gewünschte Thema angeben.                                                                                                                                                                                                                                                                                                                       |
|                                                                    | [Send SFTP](https://doku.evoviu.de/de/product-documentation/8.6.0/ftp-sftp.md#Anlegen-einer-SFTP-Verbindung)                                    |                                                                                                                                   | SFTP (Secure File Transfer Protocol) ermöglicht die sichere Übertragung von Dateien über einen geschützten Datenstrom. Dabei werden Verschlüsselung und Authentifizierung eingesetzt, um die Daten während des Austauschs zwischen Clients und Servern zu schützen.                                                                                                                                                                                     |
|                                                                    | [SMB Client](https://doku.evoviu.de/de/product-documentation/8.6.0/nas-smb.md)                                                                  |                                                                                                                                   | Diese SMB-Client-Komponente (NAS-Server) ermöglicht Ihrer Anwendung die Verbindung zu einer entfernten Dateifreigabe über das Server Message Block (SMB)-Protokoll. SMB ist ein Netzwerkprotokoll zur Dateifreigabe, das Anwendungen und Benutzern das Lesen, Schreiben und Verwalten von Dateien auf entfernten Servern ermöglicht, als wären diese lokal.                                                                                             |
|                                                                    | [TCP Client](https://doku.evoviu.de/de/product-documentation/8.6.0/tcp-ip.md#Anlegen-eines-TCP-Clients---Schritt-f%25C3%25BCr-Schritt)          |                                                                                                                                   | Die TCP-Client Komponente ermöglicht die Erstellung eines TCP-Clients für Aufgaben wie Datenübertragung, Verbindungsaufbau und Verbindungsabbau.                                                                                                                                                                                                                                                                                                        |
|                                                                    | [TCP Server](https://doku.evoviu.de/de/product-documentation/8.6.0/tcp-ip.md#Anlegen-eines-TCP-Servers---Schritt-f%25C3%25BCr-Schritt)          |                                                                                                                                   | Die TCP-Server Komponente ermöglicht es Ihnen, einen TCP-Server für Aufgaben wie die Verwaltung eingehender Verbindungen, die Datenübertragung und die Bearbeitung von Client-Interaktionen einzurichten.                                                                                                                                                                                                                                               |
| Applications                                                       |                                                                                                                           |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    | [ONNX](https://doku.evoviu.de/de/product-documentation/8.6.0/onnx-components.md)                                                                |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | [ONNX Code Detection](https://doku.evoviu.de/de/product-documentation/8.6.0/onnx-components.md#ONNX-Code-Detection)                                     | Mit dieser Komponente können Sie mithilfe von KI-Methoden Codes in einem neuronalen Netzwerk erkennen und lesen.                                                                                                                                                                                                                                                                                                                                        |
|                                                                    |                                                                                                                           | [ONNX Yolo Classification](https://doku.evoviu.de/de/product-documentation/8.6.0/onnx-components.md#ONNX-Yolo-Classification)                           | Mit dieser Komponente können Sie Bilder mithilfe von KI-Methoden klassifizieren. VIU2 erforderlich.                                                                                                                                                                                                                                                                                                                                                     |
|                                                                    |                                                                                                                           | [ONNX Yolo Detection](https://doku.evoviu.de/de/product-documentation/8.6.0/onnx-components.md#ONNX-Yolo-Detection)                                     | Mit dieser Komponente können Sie Objekte in einem Bild mithilfe von KI-Methoden erkennen. VIU2 erforderlich.                                                                                                                                                                                                                                                                                                                                            |
|                                                                    |                                                                                                                           | [ONNX Yolo Segmentation](https://doku.evoviu.de/de/product-documentation/8.6.0/onnx-components.md#ONNX-Yolo-Segmentation)                               | Mit dieser Komponente können Sie eine Instanzsegmentierung mithilfe von KI-Methoden durchführen. VIU2 erforderlich.                                                                                                                                                                                                                                                                                                                                     |
|                                                                    | RTSP                                                                                                                      |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | H264 RTSP Server                                                                                                                  | Die H264 RTSP-Serverkomponente streamt codiertes Video über das Netzwerk mittels RTSP (Real-Time Streaming Protocol). VIU2 erforderlich.                                                                                                                                                                                                                                                                                                                |
|                                                                    |                                                                                                                           | MJPEG RTSP Server                                                                                                                 | Die MJPEG RTSP Serverkomponente streamt JPEG (MJPEG)-Bilder über das Netzwerk mittels RTSP (Real-Time Streaming Protocol). VIU2 erforderlich.                                                                                                                                                                                                                                                                                                           |
|                                                                    | [NPU](https://doku.evoviu.de/de/product-documentation/8.6.0/npu-components.md)                                                                  |                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                                    |                                                                                                                           | [NPU Yolo Classification](https://doku.evoviu.de/de/product-documentation/8.6.0/npu-components.md#NPU-Yolo-Classification)                              | Mit dieser Komponente können Sie Bilder mithilfe von KI-Methoden klassifizieren. VIU2 erforderlich.                                                                                                                                                                                                                                                                                                                                                     |
|                                                                    |                                                                                                                           | [NPU Yolo Detection](https://doku.evoviu.de/de/product-documentation/8.6.0/npu-components.md#NPU-Yolo-Detection)                                        | Mit dieser Komponente können Sie Objekte mithilfe von KI-Methoden erkennen. VIU2 erforderlich.                                                                                                                                                                                                                                                                                                                                                          |
|                                                                    |                                                                                                                           | [NPU Yolo Segmentation](https://doku.evoviu.de/de/product-documentation/8.6.0/npu-components.md#NPU-Yolo-Segmentation)                                  | Mit dieser Komponente können Sie eine Instanzsegmentierung mithilfe von KI-Methoden durchführen. VIU2 erforderlich.                                                                                                                                                                                                                                                                                                                                     |

---
version: "8.6.0"
language: "de"
---
# Connections

Das **evoVIU Kamerasystem** bietet im Standardumfang der **VISIONWEB-Anwendung** eine Vielzahl an **flexiblen Kommunikationsmöglichkeiten**, um sich nahtlos in unterschiedlichste industrielle und IT-Systemlandschaften integrieren zu lassen.

Die Kamera kann mit verschiedensten Endpunkten kommunizieren -- von lokalen Geräten bis hin zu cloudbasierten Plattformen -- und unterstützt dabei unterschiedliche Protokolle wie **TCP/IP** , **UDP** , **HTTP** , **MQTT** , **RFC1006 (ISO-on-TCP)** sowie **Kafka** . Zusätzlich stehen klassische Dateispeicher-Ziele wie **FTP** und **NAS-Systeme** oder Clouddienste wie **Azure** oder **AWS**zur Verfügung.

Je nach Anwendungsfall können Daten zyklisch, ereignisgesteuert oder manuell gesendet bzw. empfangen werden. Dabei lassen sich beliebig viele Kommunikationsendpunkte konfigurieren -- sowohl für die Übertragung (Publish) als auch für den Empfang (Subscription) von Daten.

In den folgenden Kapiteln erläutern wir detailliert, welche Verbindungsarten zur Verfügung stehen, wie sie eingerichtet werden und in welchen Szenarien sie jeweils sinnvoll eingesetzt werden können.

Diese Anleitung unterstützt Sie dabei, die passende Kommunikationsmethode für Ihre Anwendung auszuwählen und optimal zu konfigurieren.  
Ohne die gezielte Implementierung von Workflows mit Kommunikationsprotokollen findet im System keinerlei selbstständige Kommunikation statt. Die Kamera nimmt erst dann Kontakt auf, wenn eine entsprechende Verbindung im Workflow eingerichtet und aktiviert wurde.  

|                                    **Verbindungsart**                                     |           **Typ**           | **ab Version** |
|-------------------------------------------------------------------------------------------|-----------------------------|----------------|
| Protokolle                                                                                                                             |||
| [working UDP](https://doku.evoviu.de/de/product-documentation/8.6.0/udp.md)                                     | PROTOKOLL UDP               | `5.0.0`        |
| [working TCP/IP](https://doku.evoviu.de/de/product-documentation/8.6.0/tcp-ip.md)                               | PROTOKOLL TCP/IP            | `5.0.0`        |
| [HTTP](https://evopro.atlassian.net/wiki/spaces/ER/pages/34871024/HTTP)                   | PROTOKOLL TCP/IP            | `5.4.0`        |
| [working MQTT](https://doku.evoviu.de/de/product-documentation/8.6.0/mqtt.md)                                   | PROTOKOLL TCP/IP            | `5.2.0`        |
| [working Kafka](https://doku.evoviu.de/de/product-documentation/8.6.0/kafka.md)                                 | PROTOKOLL TCP/IP            | `7.4.0`        |
| [working RFC1006](https://doku.evoviu.de/de/product-documentation/8.6.0/rfc1006.md)                             | PROTOKOLL TCP/IP AUTOMATION | `5.0.0`        |
| [working ISO-on-TCP](https://doku.evoviu.de/de/product-documentation/8.6.0/iso-on-tcp.md)                       | PROTOKOLL TCP/IP AUTOMATION | `7.6.0`        |
| [working OPC UA](https://doku.evoviu.de/de/product-documentation/8.6.0/opc-ua.md)                               | PROTOKOLL TCP/IP AUTOMATION | `7.8.0` NEW    |
| [working NATS.IO](https://doku.evoviu.de/de/product-documentation/8.6.0/nats-io.md)                             | PROTOKOLL TCP/IP            | `7.8.0` NEW    |
| GeniCam                                                                                   | PROTOKOLL TCP/IP            | `Jan 2026`     |
| Dokumente                                                                                                                              |||
| [working CSV](https://doku.evoviu.de/de/product-documentation/8.6.0/csv.md)                                     | FILE LOCAL CLOUD            | `7.3.0`        |
| Lokale Datenspeicher                                                                                                                   |||
| [working FTP/SFTP](https://doku.evoviu.de/de/product-documentation/8.6.0/ftp-sftp.md)                           | FILE TCP/IP LOCAL           | `5.0.0`        |
| [working NAS - SMB](https://doku.evoviu.de/de/product-documentation/8.6.0/nas-smb.md)                           | FILE TCP/IP LOCAL           | `7.4.0`        |
| [working Gerätespeicher](https://doku.evoviu.de/de/product-documentation/8.6.0/geratespeicher.md)               | FILE evoVIU LOCAL           | `5.2.0`        |
| Cloudspeicher                                                                                                                          |||
| [working Azure](https://doku.evoviu.de/de/product-documentation/8.6.0/azure.md)                                 | FILE TCP/IP CLOUD           | `5.0.0`        |
| [working AWS](https://doku.evoviu.de/de/product-documentation/8.6.0/aws.md)                                     | FILE TCP/IP CLOUD           | `5.0.0`        |
| [working Adobe AEM](https://doku.evoviu.de/de/product-documentation/8.6.0/adobe-aem.md)                         | FILE TCP/IP CLOUD           | `7.8.0` NEW    |
| Digital Input / Output                                                                                                                 |||
| [working Digital Input / Output](https://doku.evoviu.de/de/product-documentation/8.6.0/digital-input-output.md) | HardWARe Signal             | `5.0.0`        |

---
version: "8.6.0"
language: "de"
---
# Contour

## Filter

### Sobel

Wendet den Sobel-Operator an -- berechnet Gradientenbetrag und hebt Kanten sowie Intensitätsänderungen hervor.  
Der **Sobelfilter** hebt Kanten hervor, indem er Helligkeitsänderungen im Bild misst.

Er berechnet Gradienten in x- und y-Richtung und kombiniert sie zu einer Kantenstärke.

So werden Objektumrisse sichtbar, robust gegen leichtes Rauschen.

#### Flow

![image-20250901-093009.png](https://doku.evoviu.de/__attachments/a_08e590d832ab0fd6129189ba9d803075316b87e09f5aa2fc4698d6f6c62b1578/image-20250901-093009.png?cb=51d29978166efb5fbb312ed8c69f32ed)

#### Parameterset

|    **Parameter**    | **Typ** |                                                                      **Beschreibung**                                                                      | **Wertebereich** |                                                                                **Effekt Min**                                                                                 |                                                                                **Effekt Max**                                                                                 |
|---------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image               | Image   | Benötigt ein Graustufenbild. Dieses kann erzeugt werden, indem vorab der Knoten "Convert To Grayscale" genutzt wird.                                       |                  | ![image-20250901-091538.png](https://doku.evoviu.de/__attachments/a_bc79464ca8cb5419141f2d91f720bd4acd788f6157525d3751a65caa4f992b31/image-20250901-091538.png?cb=451c03fdee6262a19b91f96b8e2138bf) | ![image-20250901-091643.png](https://doku.evoviu.de/__attachments/a_e1f68686e89ace63e68a61b74738a6cfd25004105d09540662ea027108835dc8/image-20250901-091643.png?cb=dc860d4505e17052161f774ef9067862) |
| Order X             | Int32   | Gibt die Gradientenordnung in x-Richtung an.                                                                                                               | 0...2            | ![image-20250901-092049.png](https://doku.evoviu.de/__attachments/a_cf6eb879816fd6ca7aa660a071bb76a05ebb6d253e61ef78eb47ab75f85ba7dd/image-20250901-092049.png?cb=66df5563f122b27584f0fdf416a05d26) | ![image-20250901-092112.png](https://doku.evoviu.de/__attachments/a_6539c14732bb5547f5b64d9fdcb85e77efb0c392d1e8002a063752cb4aecb9d8/image-20250901-092112.png?cb=1e90f7c90b197c8b10f012fec2cccb08) |
| Order Y             | Int32   | Gibt die Gradientenordnung in y-Richtung an.                                                                                                               | 0...2            | ![image-20250901-092150.png](https://doku.evoviu.de/__attachments/a_cc0d7cc09dd3715fdb1b11c61bd9f4e40db47b6b7af9c0424b4d92e12b3486cf/image-20250901-092150.png?cb=da456b429fb722fef8f8501223d90c2d) | ![image-20250901-092237.png](https://doku.evoviu.de/__attachments/a_6b8778811800d9675df85923cb79f359c50d4868e44b455950ae30e131e304a5/image-20250901-092237.png?cb=e475f1485fbfc6e7a6c0c30a6e453631) |
| Kernel Size (Pixel) | Int32   | Ein hoher Wert vergrößert die Kernelgröße für die Berechnung größerer Flächengradienten. Die Größe des erweiterten Sobel-Kernels muss 1, 3, 5 oder 7 sein. | 1,3,5,7          | ![image-20250901-092428.png](https://doku.evoviu.de/__attachments/a_fe24b445853477cf33525e52aed7e7eb56a85f7b22f1327d95177ac0357fc058/image-20250901-092428.png?cb=a7c8a7ee1770dae807d798e5a127f46c) | ![image-20250901-092527.png](https://doku.evoviu.de/__attachments/a_f7f4d21ed7acd52d21abc0c4072f6426625158910ac7fea268a462a13d915780/image-20250901-092527.png?cb=89df5e545c7407ea02b25e16e919d8c2) |
| Scale               | Single  | Skalierungsfaktor, der auf den berechneten Gradienten angewendet wird.                                                                                     | \>0.1            | ![image-20250901-092841.png](https://doku.evoviu.de/__attachments/a_d4e31d9c3175e5b8e5b37e44eb61fb2f23d9ba9b26079289f417cbb4eff8497f/image-20250901-092841.png?cb=39cb9bf639efb247ff48bc9613adf952) | ![image-20250901-092816.png](https://doku.evoviu.de/__attachments/a_0e1f6e5ae6f8a8333600c10dfa590dde3539901e950611a1932a7820b3cdd8d0/image-20250901-092816.png?cb=d564e116981c9d305a74f0aeec3df492) |
| Delta               | Single  | Zum berechneten Gradienten hinzugefügter Wert.                                                                                                             |                  | ![image-20250901-093227.png](https://doku.evoviu.de/__attachments/a_a60b7ed3e52e88477c5cb215a9eee7d16900728fb699a8c38bd309fbe200c992/image-20250901-093227.png?cb=a971b147ec6f2c912be562776565b638) | ![image-20250901-093252.png](https://doku.evoviu.de/__attachments/a_458d3bbc2c1e4b2e72b6ba441df5cb2c6a10bac86a593fa052047b64ba9fe4a2/image-20250901-093252.png?cb=4e531bcfe2223c261b188c088a3224f1) |

### Canny

Wendet den Canny-Kantendetektionsalgorithmus an -- erkennt Kanten anhand von Intensitätsgradienten im Bild.  
Der **Canny-Detektor** findet Kanten besonders präzise durch mehrstufige Verarbeitung (Glättung, Gradient, Non-Maximum Suppression, Hysterese).

Er liefert dünne, klare Konturen und unterdrückt Rauschen zuverlässig.

Damit eignet er sich für exakte Kantenanalysen und komplexe Szenen.

#### Flow

![image-20250901-101515.png](https://doku.evoviu.de/__attachments/a_8e6b9254923fe5f7df29286afd0a9bdd893a78f1619215e22e44270b1fa6f665/image-20250901-101515.png?cb=5f15e86564128952a49f1a4e1b5bbbeb)

#### Parameterset

| **Parameter** | **Typ** |                                                                    **Beschreibung**                                                                    | **Wertebereich** |                                                                                **Effekt Min**                                                                                 |                                                                                **Effekt Max**                                                                                 |
|---------------|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image   | Benötigt ein Graustufenbild. Dieses kann erzeugt werden, indem vorab der Knoten "Convert To Grayscale" genutzt wird.                                   |                  | ![image-20250901-091538.png](https://doku.evoviu.de/__attachments/a_bc79464ca8cb5419141f2d91f720bd4acd788f6157525d3751a65caa4f992b31/image-20250901-091538.png?cb=451c03fdee6262a19b91f96b8e2138bf) | ![image-20250901-091643.png](https://doku.evoviu.de/__attachments/a_e1f68686e89ace63e68a61b74738a6cfd25004105d09540662ea027108835dc8/image-20250901-091643.png?cb=dc860d4505e17052161f774ef9067862) |
| Threshold     | Single  | Der Wert muss zwischen 0 und 255 liegen. Höhere Werte erhöhen die Empfindlichkeit gegenüber Kanten, wodurch möglicherweise mehr Kanten erkannt werden. | 0...255          | ![image-20250901-101336.png](https://doku.evoviu.de/__attachments/a_a575a5129f3a2f57ae04b79ec618219727db71f202c0f7f85535ccd1aa0f2f45/image-20250901-101336.png?cb=ea2fb040b044f104a1b84e1e06d8c7e6) | ![image-20250901-101410.png](https://doku.evoviu.de/__attachments/a_03e352c24a55144ea2c84a369764843f3c13e58e670dd34ea255d86f52538911/image-20250901-101410.png?cb=e184c0cf6d5e40f32b1dce8afff2fc5f) |

### Laplacian

Wendet den Laplace-Operator an -- berechnet zweite Ableitung und verstärkt Bereiche mit schnellen Intensitätsänderungen.  
Der **Laplacian-Filter** nutzt die **2. Ableitung** und markiert Kanten durch starke Intensitätswechsel. Er erkennt Kanten unabhängig von deren Richtung. Da er empfindlich auf Rauschen reagiert, wird er oft mit vorheriger Glättung kombiniert.

#### Flow

![image-20250901-101834.png](https://doku.evoviu.de/__attachments/a_7288001aebc118efd487a904a81eb57922289800fbc9ebdc065c82a5388ccef3/image-20250901-101834.png?cb=2c99632f054ae6b03278e6b1a2f31c44)

#### Parameterset

|    **Parameter**    | **Typ** |                                                       **Beschreibung**                                                        | **Wertebereich** |                                                                                **Effekt Min**                                                                                 |                                                                                **Effekt Max**                                                                                 |
|---------------------|---------|-------------------------------------------------------------------------------------------------------------------------------|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image               | Image   | Benötigt ein Graustufenbild. Dieses kann erzeugt werden, indem vorab der Knoten "Convert To Grayscale" genutzt wird.          |                  | ![image-20250901-091538.png](https://doku.evoviu.de/__attachments/a_bc79464ca8cb5419141f2d91f720bd4acd788f6157525d3751a65caa4f992b31/image-20250901-091538.png?cb=451c03fdee6262a19b91f96b8e2138bf) | ![image-20250901-091643.png](https://doku.evoviu.de/__attachments/a_e1f68686e89ace63e68a61b74738a6cfd25004105d09540662ea027108835dc8/image-20250901-091643.png?cb=dc860d4505e17052161f774ef9067862) |
| Kernel Size (Pixel) | Int32   | Der Wert muss positiv und ungerade sein. Ein hoher Wert erhöht die Kernelgröße für die Berechnung größerer Flächengradienten. | 1,3,5,7          | ![image-20250901-102142.png](https://doku.evoviu.de/__attachments/a_774c5b01543abbf86c9f23986d0f491c6a1f8c0cf93edb53c187244a5d418dfd/image-20250901-102142.png?cb=667fb0e985da069244118a2336363107) | ![image-20250901-102202.png](https://doku.evoviu.de/__attachments/a_75c537a18d3611c6aabac11cadc3b6ea40fe86d08399880700dc376177424bd6/image-20250901-102202.png?cb=b9f7fcec543ff30aeedca298e41b7113) |
| Scale               | Single  | Skalierungsfaktor, der auf den berechneten Gradienten angewendet wird.                                                        | \>0.1            | ![image-20250901-102245.png](https://doku.evoviu.de/__attachments/a_70e815e146724d1991693315f76a58a82868a0f47d253cdeb949beb2f56e2bb0/image-20250901-102245.png?cb=506c50925eca18e13a4a68e48b0f8ed9) | ![image-20250901-102305.png](https://doku.evoviu.de/__attachments/a_228cab95c2b3b970b71a838fd8810bf9601d50b02be2f2473072a7b69b2032d3/image-20250901-102305.png?cb=c419293aa93beb19c49ca722a6a05397) |
| Delta               | Single  | Zum berechneten Gradienten hinzugefügter Wert.                                                                                |                  | ![image-20250901-102340.png](https://doku.evoviu.de/__attachments/a_e4ebeace33ad2de8949ad9eaf810a84b70144be615840e3067253db88b21c951/image-20250901-102340.png?cb=974f58d85973b138b373b565116a564c) | ![image-20250901-102512.png](https://doku.evoviu.de/__attachments/a_317f1f85915d09e062d1e4f83cc4b78a8468437f5c459d9c15e3f557e012bbbf/image-20250901-102512.png?cb=0a458bd6e7fd93134898a91f40bc6bda) |

## Find Contours Basic

Dieser Knoten erkennt und umrandet **Konturen** (weiße Bereiche) in einem **Binärbild** .

Als Eingang eignen sich z. B. die Knoten *Binary Threshold* , *Adaptive Threshold* , *Color Threshold* , *Canny* oder andere Verfahren, die aus einem Graustufenbild ein Binärbild erzeugen.

Es stehen drei Modi zur Auswahl: **Inner Contour** , **Outer Contour** oder **Both Contours** -- damit lassen sich die **innere und äußere Kontur einer Fläche** erfassen. Die erkannten Konturen können anschließend für die **weitere Verarbeitung** genutzt werden.

### Flow

![image-20250901-202715.png](https://doku.evoviu.de/__attachments/a_b1cb783ae3b63780a53d482915b722f75ba7b479cc8694953bb43040ba06b640/image-20250901-202715.png?cb=bac6c81370f7b181e786f4c1be09348a)

#### Parameterset

| **Bildvorbereitung** |    **Typ**     |                                                                                                                   **Beschreibung**                                                                                                                    | **Wertebereich** |                                                                                   **Davor**                                                                                   |                                                                                  **Danach**                                                                                   |
|----------------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image                | Image → Region | Umwandlung eines Bildes in eine **Region** mithilfe des Knotens *Color Threshold* . Die gewünschte Farbe wird zuvor im *Make Color* -Knoten definiert -- z. B. **Gelb** als Beispiel.                                                                 |                  | ![image-20250901-202839.png](https://doku.evoviu.de/__attachments/a_331804d973024fc73725ff42f8fc93b21cdc460a5e5f1fe5323940443283c49d/image-20250901-202839.png?cb=03666f752993ae0eb8a69c7677fec69b) | ![image-20250901-202852.png](https://doku.evoviu.de/__attachments/a_e92bda6ad4686c7fe92eef09834c24376a73ec307e231faa064275d2e86aeb6d/image-20250901-202852.png?cb=b7896f6da25f521f62e93e966e78529f) |
| Image                | Image → Region | Gleiche Umwandlung eines Bildes in eine **Region** mithilfe des Knotens *Color Threshold* . Die gewünschte Farbe wird zuvor im *Make Color* -Knoten definiert -- z. B. **Weiß** als Beispiel.                                                         |                  | ![image-20250901-202839.png](https://doku.evoviu.de/__attachments/a_331804d973024fc73725ff42f8fc93b21cdc460a5e5f1fe5323940443283c49d/image-20250901-202839.png?cb=03666f752993ae0eb8a69c7677fec69b) | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) |
| **Parameter**        | **Typ**        | **Beschreibung**                                                                                                                                                                                                                                      | **Wertebereich** | **Davor**                                                                                                                                                                     | **Danach**                                                                                                                                                                    |
| Detection Mode       | InnerContour   | Erkennt nur die inneren Konturen von Objekten. Dieser Modus ist nützlich, wenn Sie sich auf geschlossene Formen innerhalb eines binären Bereichs konzentrieren und die äußere Begrenzung ignorieren möchten.                                          |                  | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203704.png](https://doku.evoviu.de/__attachments/a_0a72f21ebb32f382bde3c6e6f2b85b94c1856ffa97911521b7cfd89cd7ffca01/image-20250901-203704.png?cb=56e37c406b5901f3ec3cda0c869f410a) |
|                      | OuterContour   | Erkennt nur die äußersten Konturen von Objekten. Dieser Modus eignet sich zum Isolieren der äußeren Grenzen von Objekten, ohne verschachtelte Strukturen zu berücksichtigen.                                                                          |                  | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203755.png](https://doku.evoviu.de/__attachments/a_a81e0b843fee28c1321c58b5ce10561250c4ee5a2888dec6c2864b0b6a257d64/image-20250901-203755.png?cb=8b09bc19b5d383ab1adc4e08db42f4f9) |
|                      | BothContours   | Erkennt sowohl die äußersten Konturen als auch alle verschachtelten inneren Konturen. Dieser Modus eignet sich ideal für die Analyse hierarchischer Beziehungen zwischen Konturen, beispielsweise wenn Objekte von anderen Objekten umschlossen sind. |                  | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203858.png](https://doku.evoviu.de/__attachments/a_0342fbd54376c9c1b793505f9a58ca1d9f67ef8836395b26c5fbf8e3c2a89b20/image-20250901-203858.png?cb=5d07a695c8450fac79a80dd31361ad3e) |

## Find Contour Advanced

Dieser Knoten erkennt und umrandet **Konturen** (weiße Bereiche) in einem **Binärbild** .

Damit er funktioniert, müssen die Objekte **weiß** sein -- falls nötig, kann zur Vorverarbeitung der Knoten *Invert Pixel* genutzt werden. Die erkannten Konturen werden **von groß nach klein sortiert** ausgegeben und können für die weitere Verarbeitung verwendet werden.  
Mit dem Knoten **Find Contour Advanced** lassen sich im Vergleich zum Knoten Find Contour Basic sowohl das **Verfahren** , und damit die **Verarbeitungsgeschwindigkeit** steuern, als auch die **Sortierung der ausgegebenen Konturen** gezielt beeinflussen.

### Flow

![image-20250901-205440.png](https://doku.evoviu.de/__attachments/a_a67d3466da7451b81b06388c9960d273e208ac22975ebb48eb17a36a9535ce56/image-20250901-205440.png?cb=d2eaa09ff6fbab5e65384f4d73c129f1)

### Parameterset

| **Bildvorbereitung** |       **Typ**       |                                                                                       **Beschreibung**                                                                                        |                                                                                   **Davor**                                                                                   |                                                                                  **Danach**                                                                                   |
|----------------------|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image                | Image → Region      | Umwandlung eines Bildes in eine **Region** mithilfe des Knotens *Color Threshold* . Die gewünschte Farbe wird zuvor im *Make Color* -Knoten definiert -- z. B. **Gelb** als Beispiel.         | ![image-20250901-202839.png](https://doku.evoviu.de/__attachments/a_331804d973024fc73725ff42f8fc93b21cdc460a5e5f1fe5323940443283c49d/image-20250901-202839.png?cb=03666f752993ae0eb8a69c7677fec69b) | ![image-20250901-202852.png](https://doku.evoviu.de/__attachments/a_e92bda6ad4686c7fe92eef09834c24376a73ec307e231faa064275d2e86aeb6d/image-20250901-202852.png?cb=b7896f6da25f521f62e93e966e78529f) |
| Image                | Image → Region      | Gleiche Umwandlung eines Bildes in eine **Region** mithilfe des Knotens *Color Threshold* . Die gewünschte Farbe wird zuvor im *Make Color* -Knoten definiert -- z. B. **Weiß** als Beispiel. | ![image-20250901-202839.png](https://doku.evoviu.de/__attachments/a_331804d973024fc73725ff42f8fc93b21cdc460a5e5f1fe5323940443283c49d/image-20250901-202839.png?cb=03666f752993ae0eb8a69c7677fec69b) | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) |
| **Parameter**        | **Typ**             | **Beschreibung**                                                                                                                                                                              | **Davor**                                                                                                                                                                     | **Danach**                                                                                                                                                                    |
| Detail Level         | ChainApprxNone      | Speichert **alle Punkte** der Kontur (sehr genau, aber speicherintensiv).                                                                                                                     | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203858.png](https://doku.evoviu.de/__attachments/a_0342fbd54376c9c1b793505f9a58ca1d9f67ef8836395b26c5fbf8e3c2a89b20/image-20250901-203858.png?cb=5d07a695c8450fac79a80dd31361ad3e) |
|                      | ChainApproxSimple   | Reduziert Punkte zu einer **Minimaldarstellung** (z. B. für ein Rechteck nur 4 Eckpunkte).                                                                                                    | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203858.png](https://doku.evoviu.de/__attachments/a_0342fbd54376c9c1b793505f9a58ca1d9f67ef8836395b26c5fbf8e3c2a89b20/image-20250901-203858.png?cb=5d07a695c8450fac79a80dd31361ad3e) |
|                      | ChainApproxTc89L1   | Eine **Douglas-Peucker-ähnliche Methode**, die Konturen mit weniger Punkten vereinfacht (genauer, aber kompakter).                                                                            | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203858.png](https://doku.evoviu.de/__attachments/a_0342fbd54376c9c1b793505f9a58ca1d9f67ef8836395b26c5fbf8e3c2a89b20/image-20250901-203858.png?cb=5d07a695c8450fac79a80dd31361ad3e) |
|                      | ChainApproxTc89Kcos | Ähnlich wie Tc89L1, nutzt jedoch eine **andere Heuristik** zur Vereinfachung (oft noch glattere Approximation).                                                                               | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203858.png](https://doku.evoviu.de/__attachments/a_0342fbd54376c9c1b793505f9a58ca1d9f67ef8836395b26c5fbf8e3c2a89b20/image-20250901-203858.png?cb=5d07a695c8450fac79a80dd31361ad3e) |
| Retrieval Mode       | ListByArea          | Gibt alle Konturen zurück und sortiert sie **nach Fläche** (von groß nach klein).                                                                                                             | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203858.png](https://doku.evoviu.de/__attachments/a_0342fbd54376c9c1b793505f9a58ca1d9f67ef8836395b26c5fbf8e3c2a89b20/image-20250901-203858.png?cb=5d07a695c8450fac79a80dd31361ad3e) |
|                      | External            | Gibt nur die **äußeren Konturen** zurück, innere Strukturen werden ignoriert.                                                                                                                 | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203755.png](https://doku.evoviu.de/__attachments/a_a81e0b843fee28c1321c58b5ce10561250c4ee5a2888dec6c2864b0b6a257d64/image-20250901-203755.png?cb=8b09bc19b5d383ab1adc4e08db42f4f9) |
|                      | Ccomp               | Erstellt eine **zweistufige Hierarchie**: äußere Konturen und deren direkt enthaltene Löcher.                                                                                                 | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203858.png](https://doku.evoviu.de/__attachments/a_0342fbd54376c9c1b793505f9a58ca1d9f67ef8836395b26c5fbf8e3c2a89b20/image-20250901-203858.png?cb=5d07a695c8450fac79a80dd31361ad3e) |
|                      | Tree                | Baut eine **Hierarchie** der Konturen auf (z. B. äußere Kontur und Löcher darin).                                                                                                             | ![image-20250901-203433.png](https://doku.evoviu.de/__attachments/a_f34fcd77b6f4ec18b71b6545cbce84d1c78e41b40df36b9a9d7dae1813e05239/image-20250901-203433.png?cb=e10dc8a66ffe1bfd84670d296fcf22d4) | ![image-20250901-203858.png](https://doku.evoviu.de/__attachments/a_0342fbd54376c9c1b793505f9a58ca1d9f67ef8836395b26c5fbf8e3c2a89b20/image-20250901-203858.png?cb=5d07a695c8450fac79a80dd31361ad3e) |

#### Hinweise zum Parameterset:

Detail Level

In 90% der Fälle ist `ChainApproxSimple` die richtige Wahl**.**Es ist schnell, speicherschonend und liefert stabile Eck-/Stützpunkte für die meisten Anwendungen.

Die anderen Optionen sind bei folgenden Gegebenheiten sinnvoll:

* `ChainApproxNone` -- wenn **jeder Pixelpunkt** benötigt wird (z. B. präzise Längen/Perimeter auf Pixelbasis, nachgelagerte Glättung/Resampling), was jedoch Speicher und Zeit kostet.

* `ChainApproxTc89L1 / Tc89Kcos` -- wenn Konturen **lang** sind oder ein **Rauschen** besitzen und eine **kompakte, glatte** Darstellung benötigt wird (Shape-Matching, Tracking). *Kcos* ist oft etwas „glatter", *L1* etwas „kantiger".

Retrieval Mode

Für die meisten Anwendungen ist `External` die empfohlene Einstellung, da damit die **äußeren Objektkonturen** zuverlässig erkannt werden und innere Strukturen ausgeblendet bleiben.

* Soll auch die **komplette Hierarchie** (z. B. äußere Kontur und alle Löcher/Unterkonturen) erfasst werden, eignet sich `Tree`.

* Für eine **vereinfachte Außen/Innen-Beziehung** genügt `Ccomp`.

* `ListByArea` ist nützlich, wenn gezielt die **größten oder kleinsten Konturen** weiterverarbeitet werden sollen.

👉 **Empfehlung:** `ListByArea`oder `External` als Standard, `Tree` wenn es auf innere Strukturen ankommt.

## Draw Contour

Mit diesem Knoten können **Konturen direkt im Bild dargestellt** werden. Dadurch lassen sich die Umrisse von Objekten oder Regionen, die zuvor erkannt wurden, leichter **sichtbar machen und überprüfen**.  
**Wichtig:** Vor der Nutzung dieses Knotens müssen zunächst Konturen gefunden werden. Verwenden Sie dazu den Knoten *Find Contours* und verbinden Sie dessen Ausgang mit dem **Contours-Eingang** dieses Knotens.

### Flow

![image-20250901-211930.png](https://doku.evoviu.de/__attachments/a_9e6fcfcfab9493d2b296d09170ec931d8bfcc3ed407ba7d80998f3ac1f1e2cfc/image-20250901-211930.png?cb=7f991b016eddf62e412f1c5a661f5ba8)

### Parameterset

|   **Parameter**   |      **Typ**      |                                                                                                                                      **Beschreibung**                                                                                                                                       |                                                                                   **Input**                                                                                   |                                                                                  **Return**                                                                                   |
|-------------------|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image             | Image → Input     | Das Bild, in dem Sie die Konturen zeichnen möchten.                                                                                                                                                                                                                                         | ![image-20250902-195908.png](https://doku.evoviu.de/__attachments/a_157c900df4ad332bdec279c2bdf9394d48bf0acb9504f07799805c60ab33ce94/image-20250902-195908.png?cb=4c69a44c697e0cb243747858c28f03f8) | ![image-20250902-195849.png](https://doku.evoviu.de/__attachments/a_d6f0898026a4058c5ad37b25d2126c035b999b4559ffc50641d83e9bd0c7e649/image-20250902-195849.png?cb=b87b0b44c2d7ed6987921b98ebc8c76e) |
| Contours          | Polyline Array    | Eine Polylinie ist eine durchgehende Linie, die aus mehreren miteinander verbundenen Segmenten besteht, die in einem Array gespeichert sind und die Umrisse oder Kanten von Konturen in einem Bild darstellen. Dafür muss zuvor ein "Find Contours Basic/Advanced" Knoten verwendet werden. |                                                                                                                                                                               |                                                                                                                                                                               |
| Color             | Beispiel 1: Green | Wählen Sie eine Farbe, um die Konturen hervorzuheben. Konturen werden in diesem Beispiel in der Farbe "Grün" gezeichnet. Weitere Farben: * Beige * Black * Blue * Green * YellowGreen * Red * White * Yellow                                                                                |                                                                                                                                                                               | ![image-20250902-195849.png](https://doku.evoviu.de/__attachments/a_d6f0898026a4058c5ad37b25d2126c035b999b4559ffc50641d83e9bd0c7e649/image-20250902-195849.png?cb=b87b0b44c2d7ed6987921b98ebc8c76e) |
|                   | Beispiel 2: Red   | Wählen Sie eine Farbe, um die Konturen hervorzuheben. Konturen werden in diesem Beispiel in der Farbe "Rot" gezeichnet. Weitere Farben: * Beige * Black * Blue * Green * YellowGreen * Red * White * Yellow                                                                                 |                                                                                                                                                                               | ![image-20250902-200055.png](https://doku.evoviu.de/__attachments/a_9d30da441871215a07f2a45b56ec8fe47fccf69e14aaf80d3cd24ca6ba91142a/image-20250902-200055.png?cb=0dec3026ebdfe8276bc22f0c8c07e6e8) |
| Thickness (Pixel) | Int32             | Wählen Sie den Grad der Linienstärke. Eine höhere Zahl ergibt eine dickere Kontur. Der Wert muss größer als 1 sein.                                                                                                                                                                         | ![image-20250902-200422.png](https://doku.evoviu.de/__attachments/a_599a8ec8747407ee36ffd0d040b48d2e33720c383d7cfe4c1868dc7bda21ad90/image-20250902-200422.png?cb=0afb0dc540a73c9911eb57e74cef99e8) | ![image-20250902-200444.png](https://doku.evoviu.de/__attachments/a_65434e71a915b9c9e20bb3a13fa4c457347aa4265c7b0f9e2410a1736f0960e1/image-20250902-200444.png?cb=589e6520c063bd21766c55ee769a2f98) |

## Find Pattern

Der Knoten „Find Pattern" dient der Mustererkennung in Bildern anhand von Konturen. Dazu werden eine Vorlagen-Polylinie und die erkannten Konturen als Polylinien-Array benötigt. Das Ergebnis liefert neben einem Score auch Konturdaten (ContourData), die Sie anschließend mit dem zugehörigen „Aufteilen"-Knoten weiterverarbeiten müssen.

### Flow

![Screenshot 2025-11-03 114906.png](https://doku.evoviu.de/__attachments/a_a26d47ad341039be1f16f1a4107aa82f4b6a572419df50c2ddd76279958ab4a3/Screenshot%202025-11-03%20114906.png?cb=9570463db263a0dbbda9103f3ba2bd49)

### Parameterset

|  **Parameter**   |       **Typ**       |                                                                                                     **Beschreibung**                                                                                                      |
|------------------|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Template Contour | Polyline            | Eine Polylinie ist eine durchgehende Linie, die aus mehreren verbundenen Segmenten besteht, die in einem Array gespeichert sind und die Umrisse oder Kanten von Konturen in einem Bild darstellen.                        |
| Contours         | Polyline \<Array\>  | Eine Polylinie ist eine durchgehende Linie, die aus mehreren verbundenen Segmenten besteht, die in einem Array gespeichert sind und die Umrisse oder Kanten von Konturen in einem Bild darstellen.                        |
| Match Mode       | PatternMatchingMode | Definiert den Formanpassungsmodus. Die Modi beziehen sich auf verschiedene Berechnungsmethoden für die Hu-Moment-Distanz. Verfügbare Optionen sind RelativeDistanceI1, AbsoluteDistanceI2 und WeightedAbsoluteDistanceI3. |
| Sorting Mode     | ContourSortMode     | Legt den Sortiermodus fest. Verfügbare Optionen sind Punktzahl, Größe, Winkel, Fläche.                                                                                                                                    |
| Max Score        | Single              | Definiert den Schwellenwert für die Übereinstimmung. Konturen mit höheren Übereinstimmungswerten werden nicht zurückgegeben.                                                                                              |
| Min Points       | Single              | Definiert den Längenschwellenwert. Konturen mit weniger Punkten werden nicht zurückgegeben.                                                                                                                               |
| Return           | Contour Data        | Ein Konturdaten-Array, das die Liste der Konturen darstellt, die der Vorlagenkontur entsprechen.                                                                                                                          |

## Get Contour By Index

Ruft Konturen aus einem Polylinien-Array für einen angegebenen Indexbereich ab. Die Indizierung erfolgt nach dem Abstand zum Bildursprung (0,0), wobei die nächste Kontur zuerst gezeichnet wird. Voraussetzung ist eine vorherige Konturensuche mit dem Knoten "Find Contours Basic" oder "Find Contours Advanced".  
Auf diese Weise lassen sich gezielt einzelne oder mehrere Konturen für die weitere Verarbeitung auswählen.

### Flow

![image-20250902-201757.png](https://doku.evoviu.de/__attachments/a_80cba78fcae8b2dbb7cc61ff7107086dea98910bcc75ccdece8984c9bebeb923/image-20250902-201757.png?cb=5cca1c076beb2c58ac921b97d2add614)

### Paramerterset

| **Parameter** |    **Typ**     |                                                                                                                                                 **Beschreibung**                                                                                                                                                 |
|---------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Contours      | Polyline Array | Eine Polylinie ist eine durchgehende Linie, die aus mehreren miteinander verbundenen Segmenten besteht, die in einem Array gespeichert sind und die Umrisse oder Kanten von Konturen in einem Bild darstellen. Dafür muss zuvor ein "Find Contours Basic" oder "Find Contours Advanced" Knoten verwendet werden. |
| Min Index     | Int32          | Minimaler Indexwert der abzurufenden Konturen. Der minimale Wert ist Konturlänge 0.                                                                                                                                                                                                                              |
| Max Index     | Int32          | Maximaler Indexwert der abzurufenden Konturen. Der maximale Wert ist Konturlänge - 1.                                                                                                                                                                                                                            |

## Get Contour By Area

Der Knoten filtert Konturen nach Fläche -- sortiert von größter zu kleinster Fläche. Dieser Knoten eignet sich dann am Besten, wenn sie eine bestimmte Flächengröße suchen oder aus den ganzen Konturen rausfiltern wollen. Voraussetzung ist eine vorherige Konturensuche mit dem Knoten "Find Contours Basic" oder "Find Contours Advanced".

### Flow

![image-20250902-204154.png](https://doku.evoviu.de/__attachments/a_c71b0195a7e5ff1ea072f3d9d7e100e670b9ffaece52998a177f78c44b0a7e81/image-20250902-204154.png?cb=7ce792bc93e4dad7ecec0c7119e7fa58)

### Parameterset

| **Parameter**  |    **Typ**     |                                                                                                                                                 **Beschreibung**                                                                                                                                                 |
|----------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Contours       | Polyline Array | Eine Polylinie ist eine durchgehende Linie, die aus mehreren miteinander verbundenen Segmenten besteht, die in einem Array gespeichert sind und die Umrisse oder Kanten von Konturen in einem Bild darstellen. Dafür muss zuvor ein "Find Contours Basic" oder "Find Contours Advanced" Knoten verwendet werden. |
| Min Area Pixel | Int32          | Mindestflächengröße der einzubeziehenden Konturen. Der Mindestwert ist 0.                                                                                                                                                                                                                                        |
| Max Area Pixel | Int32          | Maximale Flächengröße der einzubeziehenden Konturen.                                                                                                                                                                                                                                                             |

## Contours to Region

Dieser Knoten wandelt Konturen in ein Binärbild (`Region`) um -- nutzbar als Maske für weitere Verarbeitung. Voraussetzung ist eine vorherige Konturensuche mit dem Knoten "Find Contours Basic" oder "Find Contours Advanced".

### Flow

![image-20250902-204521.png](https://doku.evoviu.de/__attachments/a_c89f5e208bfca79c981618ec62c4abc29f570ec035027030102357a19ddf36d5/image-20250902-204521.png?cb=4f7d1c14a5da181c175c25147fd71117)  
Als Rückgabetyp liegt eine `Region` vor. Dieser Datentyp kann mit dem Knoten "Region To Image" wieder in ein Bildformat bzw. den Datentyp `Image` umgewandelt werden.

### Parameterset

|     **Parameter**     |    **Typ**     |                                                                                                                                                 **Beschreibung**                                                                                                                                                 |                                                                                             **Beispiel 1**                                                                                             |                                                                                              **Beispiel 2**                                                                                              |
|-----------------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Contours              | Polyline Array | Eine Polylinie ist eine durchgehende Linie, die aus mehreren miteinander verbundenen Segmenten besteht, die in einem Array gespeichert sind und die Umrisse oder Kanten von Konturen in einem Bild darstellen. Dafür muss zuvor ein "Find Contours Basic" oder "Find Contours Advanced" Knoten verwendet werden. |                                                                                                                                                                                                        |                                                                                                                                                                                                          |
| Region Width (Pixel)  | Int32          | Die Breite des Binärbildes, die die horizontale Größe der Maske oder des Bereichs bestimmt.                                                                                                                                                                                                                      | Width = 600 Heigth = 600 ![image-20250902-205408.png](https://doku.evoviu.de/__attachments/a_7fefe9dd003e3ccf12360310d0478d53fae939b53fd64c70f63d92afbb566a3b/image-20250902-205408.png?cb=1d7ad360f474c27a0c4005f6c5346a2d) | Width = 1200 Height = 1200 ![image-20250902-205242.png](https://doku.evoviu.de/__attachments/a_717ffdbfdc3e134a46ef41f7ecf1ae7965d2a6abd032f2799a4570f7258d0c2f/image-20250902-205242.png?cb=29643757df1e9d6466ad48bf6536858a) |
| Region Height (Pixel) | Int32          | Die Höhe des Binärbildes, die die vertikale Größe der Maske oder des Bereichs bestimmt.                                                                                                                                                                                                                          | Width = 600 Heigth = 600 ![image-20250902-205408.png](https://doku.evoviu.de/__attachments/a_7fefe9dd003e3ccf12360310d0478d53fae939b53fd64c70f63d92afbb566a3b/image-20250902-205408.png?cb=1d7ad360f474c27a0c4005f6c5346a2d) | Width = 1200 Height = 1200 ![image-20250902-205242.png](https://doku.evoviu.de/__attachments/a_717ffdbfdc3e134a46ef41f7ecf1ae7965d2a6abd032f2799a4570f7258d0c2f/image-20250902-205242.png?cb=29643757df1e9d6466ad48bf6536858a) |
| Mode                  | Enum: Fill     | Die Konturen werden mit weißer Farbe gefüllt, so dass ein fester Bereich entsteht.                                                                                                                                                                                                                               | ![image-20250902-205408.png](https://doku.evoviu.de/__attachments/a_7fefe9dd003e3ccf12360310d0478d53fae939b53fd64c70f63d92afbb566a3b/image-20250902-205408.png?cb=1d7ad360f474c27a0c4005f6c5346a2d)                          | ![image-20250902-205242.png](https://doku.evoviu.de/__attachments/a_717ffdbfdc3e134a46ef41f7ecf1ae7965d2a6abd032f2799a4570f7258d0c2f/image-20250902-205242.png?cb=29643757df1e9d6466ad48bf6536858a)                            |
|                       | Enum: Border   | Nur die Ränder der Konturen werden in Weiß gezeichnet.                                                                                                                                                                                                                                                           | ![image-20250902-205621.png](https://doku.evoviu.de/__attachments/a_bb0960c4971aeb75dff4d51085aa3b8d77536619afe2f23a63c14f267d67e22b/image-20250902-205621.png?cb=f0ee12f47bd0285b6ff50d80c9d4e885)                          | ![image-20250902-205717.png](https://doku.evoviu.de/__attachments/a_d2b8a9713b8dc3a76ca2eafa7817c6f1d0fbdf5376a192510adb1c58070f3fc0/image-20250902-205717.png?cb=84f0d049c8fc15ee35d58fa1fa6b8a5c)                            |
| Return                | Region         | Binäres Bild, das in schwarz-weiß verarbeitet wurde.                                                                                                                                                                                                                                                             |                                                                                                                                                                                                        |                                                                                                                                                                                                          |

## Enclosing Box (Contour)

Mit diesem Knoten können Sie eine Kontur in eine einzelne Box einschließen.

### Flow

![Screenshot 2026-01-22 080811.png](https://doku.evoviu.de/__attachments/a_eadf876a44c05377d5671cd65c20eae34a26d1d444d5858cfa21ee0ea253bb5e/Screenshot%202026-01-22%20080811.png?cb=6a30565d936cb18ba94e7684c141f34a)

### Parameterset

| **Parameter** |    **Typ**     |                                                                                                                                                 **Beschreibung**                                                                                                                                                 |
|---------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Polyline      | Polyline Array | Eine Polylinie ist eine durchgehende Linie, die aus mehreren miteinander verbundenen Segmenten besteht, die in einem Array gespeichert sind und die Umrisse oder Kanten von Konturen in einem Bild darstellen. Dafür muss zuvor ein "Find Contours Basic" oder "Find Contours Advanced" Knoten verwendet werden. |
| Return        | Box            | Einschließende Box innerhalb der Kontur.                                                                                                                                                                                                                                                                         |

## Enclosing Circle (Contour)

Mit diesem Knoten können Sie eine Kontur in einem einzelnen Kreis einschließen.

### Flow

![Screenshot 2026-01-22 080751.png](https://doku.evoviu.de/__attachments/a_f098f5cb10e3862f14b87188f3dd02af511c948be4d7a1c0b19ad7a911210059/Screenshot%202026-01-22%20080751.png?cb=5955cb11bfc57afebd5bdc5e967e48c0)

### Parameterset

| **Parameter** |    **Typ**     |                                                                                                                                                 **Beschreibung**                                                                                                                                                 |
|---------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Polyline      | Polyline Array | Eine Polylinie ist eine durchgehende Linie, die aus mehreren miteinander verbundenen Segmenten besteht, die in einem Array gespeichert sind und die Umrisse oder Kanten von Konturen in einem Bild darstellen. Dafür muss zuvor ein "Find Contours Basic" oder "Find Contours Advanced" Knoten verwendet werden. |
| Return        | Box            | Einschließender Kreis innerhalb der Kontur.                                                                                                                                                                                                                                                                      |

---
version: "8.6.0"
language: "de"
---
# Conversation

---
version: "8.6.0"
language: "de"
---
# CSV

Mit dem CSV-Knoten lassen sich Daten und Werte schnell und unkompliziert zwischenspeichern und anschließend an einen beliebigen Datenendpunkt übertragen. Auf der Kamera wird dabei stets eine CSV-Datei vorgehalten. Diese Anleitung zeigt, wie Sie in wenigen Schritten Daten in eine CSV-Datei schreiben können.

## Workflow Setup

### Anlegen einer CSV-Datei

1. Gehen Sie in Workflows unter Components auf ➕.

2. Suchen Sie nach der Komponente "CSV" und wählen Sie diesen Eintrag aus.

![image-20250806-103724.png](https://doku.evoviu.de/__attachments/a_dfadf130f10e0d69aeb9c77c6c04585c4d6ceca22e54fb1072dbe5d180216b17/image-20250806-103724.png?cb=cdc0bf63385f1d49102f3a47cb90f187)

3. Es erscheint eine neue Komponente mit dem Namen "CSV". Sie können diese Komponente jederzeit umbenennen, indem Sie einen Doppelklick auf dem Namen der Komponente vornehmen.

4. Geben Sie nun den Zielordner im System an und benennen Sie die Datei mit der Endung \***.csv**, damit sichergestellt ist, dass das richtige Dateiformat vorliegt.

![image-20250806-103839.png](https://doku.evoviu.de/__attachments/a_584da3997de13f4c1a3b4ae55c7af543e0eda1a28eb4b6a211a6fb722f27f6da/image-20250806-103839.png?cb=93e3d39bb049fbb0d2f8a9983e539054)

5. Öffnen Sie im Event Graph per Rechtsklick das Context-Menü, suchen Sie nach "Get CSV" und wählen Sie diesen Eintrag aus.

Herzlichen Glückwünsch! - Sie haben eine CSV Datei im Ordner Database mit dem Namen MyCsvFile.csv erfolgreich angelegt.

### Ablegen von Daten in der CSV-Datei

1. Bevor Sie die Daten ablegen können, müssen Sie zunächst eine Struktur für Ihre Spalten erzeugen. Das können Sie mit Structs erledigen. In unseren Beispiel verwenden wir Messwerte, iO-Ergebnisse, Nachrichten und den Zeitstempel als Daten. Die Spalten sind anschließend wie gewünscht angeordnet. Wir haben das Struct umbenannt in "CsvDatensatz".

![image-20250806-104745.png](https://doku.evoviu.de/__attachments/a_bb7f8ec333e7a64982e13df97c2409e76da2ea8a79d3e44670b96b03598da0ed/image-20250806-104745.png?cb=d7d256f6a17c561daaaaafee2c4a83c2)  
![image-20250806-104943.png](https://doku.evoviu.de/__attachments/a_3c5250ee50ff097403630301f885824d5d2065e940e714a748fa987625fd19a2/image-20250806-104943.png?cb=640b45dc19c8419ce77cf1d745292c8e)

2. Suchen Sie nun im Context-Menü nach dem Eintrag "Add To CSV (CsvDatensatz)", wählen Sie diesen aus und verbinden Sie diesen Knoten mit dem Knoten "Get CSV".

![image-20250806-105707.png](https://doku.evoviu.de/__attachments/a_6d153da1a331a3a69078ae4e4fdf1ea00a510fd16d78753417bfd1cf39502d50/image-20250806-105707.png?cb=048efd3a8ca67fac632b3c753187f354)

3. Suchen Sie anschließend im Context-Menü nach "Make CsvDatensatz". Wählen Sie den Eintrag aus und verbinden Sie den Struct-Output des Knotens mit dem Input des "Add To CSV (CsvDatensatz) Knotens.

![image-20250806-105857.png](https://doku.evoviu.de/__attachments/a_7441089095e01b09f07cad43e9b204f97fe99449b46ff4bce6513ac486abb8b7/image-20250806-105857.png?cb=0de4ef2fab3da438c58b1cc814e82127)

4. Platzieren Sie die Knoten nun an der Stelle im Flow, an der Sie die Daten wegspeichern wollen und verbinden Sie diese dementsprechend.

Es muss nicht wie im Beispiel gezeigt anhand von Get-Knoten erfolgen, es ist beliebig im Workflow integrierbar.  
![image-20250806-110358.png](https://doku.evoviu.de/__attachments/a_f40f936bc3ba15f076e265a83ddd070cf66fa6784b7b6f9f107d6b3f6616c9ec/image-20250806-110358.png?cb=b9fb42fed6595bae8c8b0479fad37ab5)  
![image-20250806-110508.png](https://doku.evoviu.de/__attachments/a_0ee6824c628470ed86d6d4427f653fb4a5effb2f3b8378734572ed72435df3a9/image-20250806-110508.png?cb=71da821f52d156c7cbbf5459b54c3a2b)  
Herzlichen Glückwunsch! Sie speichern jetzt je Iteration Daten in der CSV-Datei ab.

### Hochladen von CSV-Dateien an Endpunkt

1. Suchen Sie den gewünschten Endpunkt aus und wählen Sie die dazugehörige CSV-Variante im Context-Menü aus. Dieses Beispiel basiert auf dem Endpunkt SFTP. Unter [working FTP/SFTP](https://doku.evoviu.de/de/product-documentation/8.6.0/ftp-sftp.md) können Sie die Anlage der SFTP-Komponente nachlesen.

![image-20250806-111020.png](https://doku.evoviu.de/__attachments/a_5109e810cdf626d83077de86f62712cf7c3c299a66940978a079beaadb643dde/image-20250806-111020.png?cb=bd6a1f93cde365f63c77ff0be2315a1a)

2. Suchen Sie im Context-Menü nach "Make CSV Export Settings" - Diesen Knoten können Sie verwenden, falls Sie den Delimiter zwischen den Daten ändern wollen - z.B. von Komma auf Semikolon. Sie können hierüber ebenfalls die Datumsangabe steuern, falls ein Inputwert direkt als DateTime-Value vorliegt. Generell ist dieser Knoten aber nicht zwingend erforderlich.

![image-20250806-112559.png](https://doku.evoviu.de/__attachments/a_54427a210d3daeab4a40780cfded6b0c2a93996ff671365bb9fd5073130ed5aa/image-20250806-112559.png?cb=d539cc3684e833e40df0e9710465a0bc)

3. Suchen Sie im Context-Menü zusätzlich nach dem Eintrag "Start Header Row (CsvDatensatz)" um in der ersten Zeile der Datei auch beim Upload die Spaltennamen zu hinterlegen.

![image-20250806-112754.png](https://doku.evoviu.de/__attachments/a_a3700a2a1ea205d80dfbece9511d52809af89478ce41416342c3b29cb0414e21/image-20250806-112754.png?cb=d96ff417fdde8d0b463e87ff353cda2a)  
Herzlichen Glückwunsch! Sie können jetzt erfolgreich CSV-Dateien hochladen.

---
version: "8.6.0"
language: "de"
---
# Customization

In diesem Kapitel finden Sie allgemeine Informationen zur Individualisierung der Web-Anwendung der evoVIU-Kamera.

## Einleitung

Die Settings bieten mit dem Bereich Customization viele Möglichkeiten um das Verhalten Ihrer Kamera noch individueller zu gestalten. Neben einigen Anzeigemöglichkeiten in der Web-Anwendung können Sie auch den Zustand Ihres Displays oder das Bridging konfigurieren.  
![Screenshot 2026-03-02 083307.png](https://doku.evoviu.de/__attachments/a_0cce0dae114b4a81b1be4de7da3998d21a5c6ccd1db0d5056520a4c37a3a5824/Screenshot%202026-03-02%20083307.png?cb=67da19d397365591abe11b8214705094)

## Device Info Bottom Bar

In der Bottom App Bar können Sie bestimmte Informationen permanent anzeigen lassen, vollkommen egal an welchem Punkt Sie sich gerade in der Anwendung befinden. Wenn Sie bspw. jederzeit die Auslastung des RAM im Blick behalten wollen, dann können Sie auf der Seite Customization diese Anzeige-Einstellung setzen.  
![Screenshot 2026-03-02 084549.png](https://doku.evoviu.de/__attachments/a_d2fd9dbba35575d9f76601257e26c4826012c718988ada88356034bf2c2b9569/Screenshot%202026-03-02%20084549.png?cb=7fe7ef0dc4ea5620e08200c15c67f338)

Folgende Attribute stehen Ihnen hierbei zur Verfügung:

### Camera Name

Den von Ihnen gewählten Namen. Dieser Hinweis kann wichtig sein, um die richtige Kamera im Tab zu finden.

### Network Connection Type

Hier sehen Sie den **primär genutzten Netzwerkverbindungstyp** . Dies gibt Aufschluss über den **Hauptdatenfluss** Ihrer Anwendung. Falls ein Endpunkt nicht erreichbar ist -- beispielsweise, weil Sie über WLAN auf ein bestimmtes Netzwerksegment zugreifen -- kann die Ursache hier schnell erkannt werden.

### Software Version

Softwareversion VISIONWEB Ihrer evoVIU Smart Kamera  

|         **Version**          | **Stabilität** |  **Bezeichnung**  |                                 **Beschreibung**                                  |
|------------------------------|----------------|-------------------|-----------------------------------------------------------------------------------|
| 7.x.x                        | STABLE         | Master-VERSION    | Stabile getestet Masterversion                                                    |
| 7.5.x                        | STABLE         | MINOR-VERSION     | Stabile getestet Minorversion                                                     |
| 7.5.0                        | STABLE         | HOTFIX-VERSION    | Stabiler gestesteter Hotfix                                                       |
| 7.0.0-support-label          | STABLE         | Support-VERSION   | Stabile Support-Version mit Spezialfunktionen für einen definierten Kundenauftrag |
| 7.5.0.1234-dev0              | INSTABLE       | DEV-BUILD-VERSION | Development - Version zu Testzwecken bereitgestellt                               |
| 7.5.0.1234-feature-VIU-xxxxx | INSTABLE       | FEATURE-VERSION   | Feature - Version zu Testzwecken eines bestimmten Features bereitgestellt         |

### OS Version

Version des Betriebssystems VIU.OS Ihrer evoVIU Smart Kamera  

| **Version**  | **Stabilität** | **Bezeichnung** |                                                                                     **Beschreibung**                                                                                     |
|--------------|----------------|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 4.4.3        | STABLE         | Master-VERSION  | Stabile getestet Masterversion                                                                                                                                                           |
| 4.4.3-docker | STABLE         | DOCKER-VERSION  | Stabile getestet Masterversion inklusive einen über SSH zu erreichenden Bereich zur Bereitstellung von Docker-Containern. Bitte passen Sie das Passwort selbständig im Dockerbereich an. |

### Ethernet Speed

Geschwindigkeit Ihrer Ethernet Verbindung in Mb/s  
Sollten Sie ein 1000Mbit (1Gbit) Netzwerk haben aber die Kameras nur 100Mbit anzeigen, so stellen Sie bitte die Kabelverbindung und das verwendete Kabeltyp sicher.  

|  **Netzwerkgeschwindigkeiten**  |||
|----------|-----------|------------|
| 10Mbit/s | 100Mbit/s | 1000Mbit/s |

### Wifi Speed

Geschwindigkeit Ihrer Wlan-Verbindung

### Camera Type

Ihr Kamera-Typ

### Storage

Speicherauslastung Ihrer Kamera

### RAM Load

RAM-Auslastung  
Bei einer RAM-Auslastung \> 93% schaltet sich das laufende Workflow-Programm von selbst aus.

### CPU Load

CPU-Auslastung

### Date

Aktuelles Datum

### Time

Aktuelle Uhrzeit

## Display State

### Display on

Hier können Sie das Display Ihrer Kamera aus- oder anschalten. Damit können Sie beispielsweise verhindern, das ein Fremdeingriff oder eine Veränderung über das Display möglich ist.  
Im deaktivierten Zustand zeigt das Display "No Response from Driver".  
Bitte beachten Sie, dass bei deaktivierten Display im Fehlerfall keine rettenden Maßnahmen über das Display mehr möglich sind.  
![Screenshot 2026-03-02 084622.png](https://doku.evoviu.de/__attachments/a_bf35672a328b9277439ca84feddb4b3d1f5026dae7e99aa6696a37bc59f2ad03/Screenshot%202026-03-02%20084622.png?cb=65cf9fdcb26e2477442054a14ee2daae)

## Bridging / Isolation

Hier können Sie **Ethernet- oder WiFi-Bridging aktivieren** , um mehrere Netzwerke miteinander zu verbinden -- oder das Bridging deaktivieren. Beispielsweise kann im **WiFi-AP-Modus** der Kamera auf das angeschlossene Ethernet-Netzwerk zugegriffen werden. **Wenn dies nicht erwünscht ist, empfiehlt es sich, beide Bridging-Optionen zu deaktivieren.**  
Sie benötigen Admin-Rechte für das Bearbeiten der Einstellung. Admin-Rechte können im Bereich User Management für ausgewählte Nutzer vergeben werden.  
![Screenshot 2026-03-02 084645.png](https://doku.evoviu.de/__attachments/a_759c9649f6ecdab401149aa6de1d6f32049bcc6f1912e0c12887c1fc387aabc3/Screenshot%202026-03-02%20084645.png?cb=150a642f23f28b949f9eb28a5e71430e)

## Start Options

Hier können Sie auswählen, ob beim Öffnen der Webanwendung der **Home Screen** oder direkt das **Dashboard** angezeigt werden soll. Entscheiden Sie sich für das Dashboard, wird beim Start automatisch das Dashboard der aktuell aktiven Routine angezeigt. Ist keine Routine aktiv, wird stattdessen der normale Home Screen geladen. Diese Einstellung ist besonders hilfreich, wenn Sie schnell auf das Dashboard zugreifen möchten, ohne den Umweg über den Workflow-Bereich gehen zu müssen.  
![Screenshot 2026-03-02 084706.png](https://doku.evoviu.de/__attachments/a_d4825d2c71a1e49261cebe4f6034f47d7cd6fa06e21a32a04e038c9435bc0d89/Screenshot%202026-03-02%20084706.png?cb=6c6009483ce7952f900f844f182fae9c)

## Personalization

Mit den Personalisierungs-Optionen können Administratoren das Erscheinungsbild der VISIONWEB-Oberfläche individuell an das eigene Corporate Design anpassen. Dies umfasst die Auswahl von Design-Presets sowie das Setzen von individuellen Logos, Farben und dem Favicon.  
![Screenshot 2026-06-18 120159.png](https://doku.evoviu.de/__attachments/a_3e84a7311d9890f6644f3c7dddef7617a01b27372e1adcf16ad0147aa6e7fcff/Screenshot%202026-06-18%20120159.png?cb=a8e87caebc040310f1d0794c887d3718)

Um Einstellung vornehmen zu können, müssen Sie als **Administrator** angemeldet sein. Für eigene Grafiken (Logo/Icon) wird das Format **.png** benötigt.  
![Screenshot 2026-06-18 110631.png](https://doku.evoviu.de/__attachments/a_05c5d5743ffa2a9a2b99b79adf4fd4962ddfcbe8fdfbb1cbb9194f2ef4c6c46e/Screenshot%202026-06-18%20110631.png?cb=0bcd455c3e36c68ce82d6401dbe9840a)

### Branding-Presets auswählen

Sie können zwischen vordefinierten Stylings wählen oder eine vollständig eigene Konfiguration erstellen.

1. Navigieren Sie zu **Settings \> Customization \> Personalization**.

2. Wählen Sie im Dropdown-Menü **Personalization Options** eines der folgenden Presets aus:

   * **Evopro:** Das Standard-Styling der evoVIU.

   * **Bertrandt:** Ein optimiertes Design-Preset für Bertrandt-Umgebungen.

   * **Custom:** Ermöglicht die individuelle Konfiguration von Farben und Logos.

![Screenshot 2026-06-18 110659.png](https://doku.evoviu.de/__attachments/a_40bdcfbdd72ab496f8c0854edf1f9dd4270f4ac2b35dc0fa5c48ea2d0ef4841a/Screenshot%202026-06-18%20110659.png?cb=06c89dda92082dc13bb594bd86067699)

### Individuelles Styling (Preset "Custom")

Wenn Sie das Preset **Custom** wählen, erscheinen zusätzliche Optionen zur Feinabstimmung:

1. **Top App Bar Farbe:** Klicken Sie auf das Farbfeld rechts neben **Custom Color**, um über den Color-Picker die Hintergrundfarbe der oberen Programmleiste festzulegen.

2. **App Icon \& Favicon:**

   * Klicken Sie in der Sektion **App Icon** auf den gelben Upload-Button (Ordner-Icon), um eine Bilddatei aus dem Dateisystem auszuwählen.

   * **Hinweis:** Das hier hochgeladene App Icon wird automatisch auch als **Favicon** (das kleine Symbol im Browser-Tab) verwendet.

3. **App Logo:** Laden Sie über den Upload-Button in der Sektion **App Logo** das Logo hoch, welches links in der Top App Bar angezeigt werden soll, wenn das Menü ausgeklappt ist.

![Screenshot 2026-06-18 110719.png](https://doku.evoviu.de/__attachments/a_179d823b35e40c5459fff70aa734715d4a585aa3eba6a6d2b52f2cafef30fb49/Screenshot%202026-06-18%20110719.png?cb=a7948dd0227894859389f0f5c663fef8)

### Allgemeine Hinweise zum Abschnitt Personalization

* Alle Änderungen an Farben und Logos werden sofort systemweit für alle Nutzer übernommen.

* Über den grauen Löschen-Button (Mülleimer-Icon) neben den Upload-Feldern können Sie individuelle Icons oder Logos jederzeit entfernen und auf den Standard zurücksetzen.

* Nutzer ohne Administrator-Rechte können die gewählten Einstellungen zwar sehen, jedoch keine Änderungen vornehmen (die Schaltflächen sind für sie deaktiviert).

*** ** * ** ***

[4.3_Settings_Customization.mp4](https://doku.evoviu.de/__attachments/a_6b3e843093167a85cd7f598ed5be4fac0f6c8f004e84ab35691d4b3fa5d0508b/4.3_Settings_Customization.mp4.md)

---
version: "8.6.0"
language: "de"
---
# Dashboard

Mit dem Dashboard soll es möglich sein, den Prozessablauf und die Bildverarbeitung auf der evoVIU auf einen Blick nachzuverfolgen. Anhand von unterschiedlichsten Visualisierungstypen sollen in Echtzeit Informationen aufbereitet werden, damit jeder stets über den aktuellen Zustand im Bilde ist.

Grundlegend ist das Dashboard mit der Erstellung eines Workflows vorbereitet, aber leer. Sie können das Dashboard jedoch über wenige Klicks mit Leben befüllen, idealerweise indem Sie Ihre Dashboard Widgets mit Variablen aus Ihrem Workflow verknüpfen.

## Widgets

Wir umreißen zu Beginn ganz grob die zentralen Aufgaben der verfügbaren Widgets. Auf die Details gehen wir zu einem späteren Zeitpunkt ein.

### Alert

Zeigt die Zustände Error, Pending und Success einer Variable vom Typ boolean in Form von einer in rot, gelb oder grün gefärbten Box an.

#### Data Table

Ermöglicht die Darstellung von unterschiedlichen Werten in Tabellenform.

#### iFrame

Erlaubt Ihnen das Einbetten einer Webseite.

#### Image

Visualisiert bspw. das zuletzt aufgenommene Bild Ihres Workflows, sofern Sie das zuletzt aufgenommene Bilder einer Variable zugewiesen haben.

#### Label

Eignet sich hervorragend um einzelne Abschnitte Ihres Dashboard mit einer kurzen, prägnanten Beschreibung zu versehen.

#### Text

Dieses Widget lässt sich mit beliebigem Text befüllen. Zur Formatierung des Text stehen Ihnen etliche Formatierungsmöglichkeiten zur Verfügung.

#### Variant Control

Hier können Sie zur Laufzeit die gesetzte Variante wechseln.

#### Variant Editor

Ermöglicht Ihnen die Anpassung der Werte von einzelnen Parametern Ihrer Variante zur Laufzeit. Sie können somit in Echtzeit die Auswirkungen Ihrer Änderungen nachvollziehen ohne den Workflow stoppen und erneut starten zu müssen. Die Änderungen greifen automatisch mit der nächsten Iteration des Workflows.

#### Event Trigger

Mit diesem Widget können über das Dashboard Events im Workflow während der Laufzeit ausgelöst werden.

### Die Übersichtsseite

#### Aufruf der Übersichtsseite

In der Menüleiste können Sie auf "Logic" klicken und über das Dropdown Menü zum Dashboard wechseln.  
![Screenshot 2025-11-03 151709.png](https://doku.evoviu.de/__attachments/a_e40451dd1173892365a56bc041abed7a0ab48b2981e9350fe655829f06f484b8/Screenshot%202025-11-03%20151709.png?cb=41c9e1647fcf8483aca34d2419105142)  
![Screenshot 2024-10-23 154010.png](https://doku.evoviu.de/__attachments/a_95a532f4a10b65897e69ba98ec08a32c676996da8a71f94ad5a27133d9f2ac0c/Screenshot%202024-10-23%20154010.png?cb=3e563f6713f38d11dbd90c289c05b790)

Sie gelangen auf die Übersichtsseite des Dashboard. Wie bereits erwähnt ist die Übersicht initial leer. Sie sehen am oberen Bildschirmrand die in rot gefärbte Top App Bar zur Navigation innerhalb des Workflow-Bereichs. Sie können dort außerdem Ihren Workflow steuern, die Anzeige-Einstellungen ihres Bilds konfigurieren und vieles mehr, so wie Sie es auch aus anderen Bereichen der Anwendung gewöhnt sind. Bevor wir loslegen können gehen wir noch kurz auf den Ansichts- und Bearbeitungsmodus ein, der Ihnen vielleicht schon in der Top App Bar aufgefallen ist.

#### Dashboard Modi

Zur Nutzung des Dashboards stehen aktuell zwei Modi zur Verfügung:

* Viewer Mode

* Editor Mode

Initial wird das Dashboard immer im Viewer Mode aufgerufen. Dieser Anzeigemodus ist auf das Wesentliche beschränkt, zeigt Ihnen alles Wissenswerte auf einen Blick an und verhindert ungewollte Fehlkonfigurationen. Sobald Sie jedoch auf den Button "Viewer Mode" klicken, wechseln sie in den Editor Mode. Hier taucht am unteren Bildschirmrand die Bottom App Bar auf, welche Sie vielleicht schon von der Image Source oder anderen Bereichen der Anwendung kennen.  
![Screenshot 2024-10-23 160847.png](https://doku.evoviu.de/__attachments/a_9d278e5a716bbc13dd7c4efdcfb7822e5d1fda19c720a1799bb3210cd220dc2c/Screenshot%202024-10-23%20160847.png?cb=4ef896250198dce17df12610530c24a4)

#### Hinzufügen eines Widgets

Über den gelben Button mit dem Plus-Icon in der Bottom App Bar können Sie sogenannte Widgets hinzufügen, welche für die Visualisierung von Daten verantwortlich sind. Zunächst öffnet sich ein Dialog der Ihnen alle verfügbaren Widget-Typen auflistet. Indem Sie einen Eintrag anklicken, sorgen Sie dafür, dass das Widget Ihrem Dashboard hinzugefügt wird.  
![Screenshot 2024-10-23 161432.png](https://doku.evoviu.de/__attachments/a_67ae2ddf0e51a3b697b15667e74455fe16a597875e6093513f6c15c0046b78c3/Screenshot%202024-10-23%20161432.png?cb=1dc003bd98f0ba2fb557d502aba7fe51)

In unserem ersten Beispiel entscheiden wir uns für das Data Table Widget. Dieses wird auf der Zeichenfläche platziert und mit Inhalt befüllt. Grundlegend ist am oberen Ende des Widgets immer eine Leiste vorhanden, welche einen Button zum Verschieben des Widgets, ein Textfeld zur Vergabe einer Bezeichnung und ein Menü mit zusätzlichen Optionen und Einstellungsmöglichkeiten auf das Widgets bezogen, besitzt.  
![Screenshot 2024-10-24 131133.png](https://doku.evoviu.de/__attachments/a_d8b447d1a8c8f0a62feb106be2405613888485fa1dfea7892827ae373a1b597e/Screenshot%202024-10-24%20131133.png?cb=cb8d8fb91b3d52948694b41b402a8c36)  
Hier ist wichtig zu wissen, dass diese Konfigurationsmöglichkeiten nur im **Editor Mode** verfügbar sind. Wenn Sie das Dashboard im **Viewer Mode** betrachten werden sämtliche Konfigurationsmöglichkeiten ausgeblendet oder ausgegraut. Außerdem können Sie auch ein bereits vorhandenes Widget auswählen. Dieses erhält anschließend einen gelben Rahmen und soll die Auswahl visualisieren.  
![Screenshot 2024-10-24 131348.png](https://doku.evoviu.de/__attachments/a_f292d17053658581e3e917f96033edbae53e32309e86d0b84ea8af861dd449e1/Screenshot%202024-10-24%20131348.png?cb=3ad3a1652d10d922153ef5e35cd9dd84)

#### Verschieben des Widgets

In der linken oberen Ecke des Widgets befindet sich ein Icon mit 6 Punkten. Wenn Sie diesen Button gedrückt halten, können Sie das Widget an eine beliebige Position verschieben. Es wird automatisch am Raster ausgerichtet.  
![Screenshot 2024-10-24 133136.png](https://doku.evoviu.de/__attachments/a_145a86421d755ac05f35637d34dbaf30660c13455c3bd312f1a9b745ea314af6/Screenshot%202024-10-24%20133136.png?cb=50a5bfeb145c51cfff8884f9b1d8acdd)

#### Bezeichnen des Widgets

Mittig am oberen Ende des Widgets befindet sich ein Textfeld, welches Ihnen die Beschriftung des Widgets ermöglicht. Die Vergabe eines Labels ist jedoch kein Muss und kann auch unbefüllt bleiben.  
![Screenshot 2024-10-24 133219.png](https://doku.evoviu.de/__attachments/a_2f53f4f69316f97dee0c4563afeced2d534d0cdc544b7094282173d2a7c5b052/Screenshot%202024-10-24%20133219.png?cb=bf81c07b69826fb3069d17306e1a8e63)

#### Vergrößern / Verkleinern des Widgets

In der rechten unteren Ecke des Widgets befindet sich ein Icon mit 2 schrägen Strichen. Wenn Sie diesen Button gedrückt halten, können Sie die Größe des Widgets beliebig vergrößern bzw. verkleinern. Ihr Widget kann dabei beliebige Proportionen annehmen.  
![Screenshot 2024-10-24 133258.png](https://doku.evoviu.de/__attachments/a_e4b6c2f137832696e179f00e6cbcb7519ddce42efdf1772fe89fd1aa2a56e8e8/Screenshot%202024-10-24%20133258.png?cb=7fd1e33ee0bad58f6c663406e9ae8f07)

### Allgemeine Konfigurationsmöglichkeiten

#### Widget-Menü

Über das Dreipunkt-Menü in der rechten oberen Ecke des Widgets können Sie ein Menü öffnen. Dort befinden sich einige Optionen zur Verwaltung und Konfiguration des vorliegenden Widgets.  
![Screenshot 2025-05-19 162137.png](https://doku.evoviu.de/__attachments/a_4172625f01393008403115dcee091852526487c9147461131dc1511718fcfd03/Screenshot%202025-05-19%20162137.png?cb=4adca9cacb3313a9b2a433acbd43cadf)

#### Entfernen des Widgets

Über das Dreipunkt-Menü in der rechten oberen Ecke des Widgets steht Ihnen die Option "Remove Visualization" zur Verfügung. Diese Option entfernt das von Ihnen ausgewählte Widget.

#### Datenquelle leeren

Mit der Option "Clear data source" können Sie verlinkte Variablen, den sogenannten Context, entfernen und Ihr Widget in den Ursprungszustand zurücksetzen.

#### Duplizieren des Widgets

Es gibt ebenfalls die Option zum Duplizieren des Widgets. So können Sie innerhalb kürzester Zeit vorausgefüllte Widgets erstellen.

#### Hintergrundfarbe bearbeiten

Sobald Sie ein Widget hinzugefügt haben, enthält dieses immer eine Hintergrundfarbe. Über das Menü des Widgets können Sie mit der Option **"Remove background"** jedoch für einen "transparenten" Hintergrund sorgen. Wenn Sie diese Einstellung rückgängig machen wollen, nutzen Sie einfach das Menü des Widgets erneut. Die Option lautet nun **"Set background"** und sorgt dafür, dass der ursprüngliche Zustand wieder hergestellt wird.  

| ![Screenshot 2024-10-24 133422.png](https://doku.evoviu.de/__attachments/a_6777814ef8a00d1df32868fe7d671b1f9b6de58def9c79c68f77c94fed889b35/Screenshot%202024-10-24%20133422.png?cb=9c8781f7428fa8309cdc9869ebc3b1ff) | ![Screenshot 2024-10-24 133433.png](https://doku.evoviu.de/__attachments/a_7558c75185f35fac530507fadfeeb1a764ff8552c97a512e1b4fcbb4c923e936/Screenshot%202024-10-24%20133433.png?cb=bef5f3fb4f034af03c50ec6fcfdf22d8) |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Widget ohne Hintergrund im Editor Mode                                                                                                                                                          | Widget ohne Hintergrund im Viewer Mode                                                                                                                                                          |
| ![Screenshot 2024-10-24 133608.png](https://doku.evoviu.de/__attachments/a_3e62246d64b5a99adc332cbc621984787e33d3928655578d006c6e2e27a3d42c/Screenshot%202024-10-24%20133608.png?cb=74449ec7ef57a4a383a82be2e3562722) | ![Screenshot 2024-10-24 133620.png](https://doku.evoviu.de/__attachments/a_225d935dc8bba1ba81c38928e8978a51f627f1da0be2628c654358ccff29916f/Screenshot%202024-10-24%20133620.png?cb=781c50cbcff6746ce6a2b42e6c5abf14) |
| Widget mit Hintergrund im Editor Mode                                                                                                                                                           | Widget mit Hintergrund im Viewer Mode                                                                                                                                                           |

#### Ergebnisbezogenen Rahmen setzen

Im dieses Feature nutzen zu können, müssen Sie in Ihrem Workflow bei mindestens einer Variable vom Typ boolean die Einstellung "Publish value" aktivieren.

Über das Dreipunkt-Menü in der rechten oberen Ecke des Widgets steht Ihnen die Option **"Set result-related border"** zur Verfügung. Dies ermöglicht Ihnen eine visuelle Ergebnisanzeige in Form eines rot, gelb bzw. grün eingefärbten Rahmens. Alles was hierfür benötigt wird ist die Auswahl einer Variable vom Typ boolean.  
![Screenshot 2024-10-24 134008.png](https://doku.evoviu.de/__attachments/a_a130ad33b38d0785cadcf9b1db3e8904c36f0d97632ffa4ba8b199f6c0882b8b/Screenshot%202024-10-24%20134008.png?cb=243c759fee645ff850e5d9ee74221264)

Wenn Sie diese Einstellung vornehmen möchten, öffnet sich ein Dialog der Ihnen alle passenden Variablen auflistet. Sie können die Suchfunktion benutzen, einen bestimmten Type wählen oder auch bereits benutzte Variablen ausblenden. Mit einem Klick auf den "Confirm"-Button bestätigen Sie Ihre Auswahl, der Dialog wird geschlossen und die Einstellung wird gesetzt. Sobald der nächste Durchlauf stattfindet, wird der Rahmen des Widgets dementsprechend gefärbt.  
![Screenshot 2024-10-24 135331.png](https://doku.evoviu.de/__attachments/a_13fd2a6d93f214a800aa0af55aea3d255c69b591cb29219b3e7919a7f3ee7dcb/Screenshot%202024-10-24%20135331.png?cb=492337b03d651f2570672a846d68e5c8)

---
version: "8.6.0"
language: "de"
---
# Data Table Widget

## Data Table Widget

Dieses Widget ermöglicht Ihnen die Anzeige von Daten in Tabellenform. Nach dem Hinzufügen des Widgets ist dieses zunächst leer und besitzt optisch auch noch nicht viele Hinweise auf eine Tabelle. Sobald Sie jedoch mit der Konfiguration Ihres Widgets starten und den gelben Button "Add Column" klicken, startet der Aufbau der Tabelle.  
![Screenshot 2024-10-25 130059.png](https://doku.evoviu.de/__attachments/a_ace794f3bf4e9b741cb3ff04c6db29e0d78fd9c26a6d084e43ec59d2ee4eac52/Screenshot%202024-10-25%20130059.png?cb=dff5f0055ebe527fd35b302e24b1ffdb)

Es wird zunächst eine erste Spalte angelegt. Dabei handelt es sich zudem um die Kopfzeile. Sie können hier nicht nur weitere Spalten anlegen, sondern auch zusätzliche Zeilen. Außerdem ist über eine Spalte in der Kopfzeile bzw. dem zugehörigen Menü das Konfigurieren bzw. Typisieren der Spalte möglich.  
![Screenshot 2024-10-25 145645.png](https://doku.evoviu.de/__attachments/a_b935e5be145ac706379c4584fc841f9f5911a48dbe1e3eb2b84d8b001a1a6d31/Screenshot%202024-10-25%20145645.png?cb=5ca617e592cec38981ec75428fa21df8)

Sobald Sie eine Zeile angelegt haben, können Sie diese über den Button mit dem "Mülleimer"-Icon Zeilen auch wieder entfernen. Für das Entfernen einer Spalte müssen Sie in der Kopfzeile über das Dreipunkt-Menü zur Option "Remove" navigieren.  
![Screenshot 2024-10-25 145716.png](https://doku.evoviu.de/__attachments/a_4fa6fe70ac9904622e25c475a08a03c833514bed995a9b64c1eeece206d1a17e/Screenshot%202024-10-25%20145716.png?cb=ea2268cbdb9266e056b2735e051e26c0)

Im Dreipunkt-Menü der Spalten finden Sie die Optionen "Remove" zum Löschen der Spalte, "Type" um eine Typisierung vorzunehmen, und "Format mask", womit Sie die Formatierung Ihrer Werte festlegen können.  
![Screenshot 2024-10-25 145739.png](https://doku.evoviu.de/__attachments/a_f45653f19fe6175e95a88cc89bae748cef22fef133dc8bd28396332beaca15cd/Screenshot%202024-10-25%20145739.png?cb=b538571862464b34a42beda00aa12b0c)

Die Option "Type" bietet Ihnen die Auswahlmöglichkeiten Text, Number und Boolean an.  
![Screenshot 2024-10-25 145800.png](https://doku.evoviu.de/__attachments/a_84dec31cfc1df37e73d934a310cb04803c38379246e4ffa2bbacc3ce0242dea5/Screenshot%202024-10-25%20145800.png?cb=a49f1fdbbf4d42c4cf26a42896785629)

Wenn Sie sich für den Type "Text" entschieden haben, können Sie über die Option "Format mask" festlegen, ob Ihr Text als Einzeiler über den Wert "Single-Line" oder in einem Textfeld über den Wert "Textarea" dargestellt werden soll.  
![Screenshot 2024-10-25 145820.png](https://doku.evoviu.de/__attachments/a_89e4636a8cc7f50e5057a2a5428f58e6a65754f7205beccea29d6afdcf22933e/Screenshot%202024-10-25%20145820.png?cb=359eebf9b517763f9e88b0b4d5430255)

Falls Sie sich jedoch für den Type "Boolean" entschieden haben, dann können Sie über die Option "Format mask" festlegen, ob Ihr Datensatz über den Wert "Checkbox" als Kästchen angezeigt wird, oder ob über den Wert "OkNok" die Angabe in Textform erfolgen soll.  
![Screenshot 2024-10-25 145924.png](https://doku.evoviu.de/__attachments/a_f69af40d2820c761eccba418cc2160455478b774cc822f6fe3b7d3ce1d742e3b/Screenshot%202024-10-25%20145924.png?cb=9a23d66c5e63f8ae85cf1bcb09646edc)

Sie haben außerdem die Möglichkeit eine Zelle individuell zu konfigurieren, indem Sie bspw. eine Variable verlinken und somit als Kontext setzen.  
![Screenshot 2024-10-25 145953.png](https://doku.evoviu.de/__attachments/a_b45a5283168beca56d03955154b7b5c83c913ebd273e27f5ae0e586011e049d5/Screenshot%202024-10-25%20145953.png?cb=151c8eee66c1f9e142c07ede3b1f1ede)

Wenn Sie im Menü auf die Option "Link with context" klicken, erscheint der bereits zuvor erwähnte Dialog mit dem Titel "Link variable with context". Dort werden Ihnen alle Variablen vom Typ boolean angezeigt, wobei Sie exakt einen über eine Checkbox für das Widget aktivieren können. Schließen Sie nach der Auswahl einer Variable den Dialog indem Sie den Button "Confirm" klicken.  
![Screenshot 2024-10-25 150138.png](https://doku.evoviu.de/__attachments/a_6f50c309520553b66a1cce96c7676f4b036eeec2ffaf6418f9d4eac159cc740b/Screenshot%202024-10-25%20150138.png?cb=8ebbde00da4128acb41bd7834756b749)

Sobald Sie Ihrem Widget einen Context zugewiesen haben, wird die Zelle zur Laufzeit Ihres Workflow mit einem Wert befüllt.

---
version: "8.6.0"
language: "de"
---
# Date & Time

In diesem Kapitel finden Sie allgemeine Informationen zum Setzen der Datums- und Zeiteinstellungen der evoVIU-Kamera.

## Einleitung

Unter diesem Einstellungspunkt können Sie die richtige Uhrzeit und das richtige Datum überprüfen und einstellen.  
**Wichtig: Bisher ist noch**keine Realtime-Clock in der Kamera verbaut. Bei einem Neustart kann es daher sein, dass die beim Herunterfahren zuletzt gespeicherte Zeit wieder dargestellt wird. Nutzen Sie einen NTP-Server, damit sich auch beim Neustart die Uhrzeit mit der Anlage synchronisiert.  
Die Änderung von Datum und Zeit ist nur dann möglich, wenn keine Konfiguration aktiv ist.

## Date \& Time

Über den Button Set Device Time können Sie über einen Dialog die auf Ihrem Gerät eingestellte Zeit konfigurieren.  
![Screenshot 2026-03-02 084759.png](https://doku.evoviu.de/__attachments/a_374e48a0d06df102c5079a8665067556539d426f9100736c1311e52cb0388fec/Screenshot%202026-03-02%20084759.png?cb=2889e6933ee1a4c979f9e565e54697a4)

## Synchronisation

Zur Synchronisation von Datum und Uhrzeit können Sie entweder Ihr System als Referenz nutzen oder sich auf eine NTP-Serveradresse beziehen. Diese Einstellung ist gerade dann Notwendig um bei Ereignissen die gleiche Uhrzeit wie andere Teilnehmer zu haben.

### System

Wenn Sie sich für System als Modus zur Synchronisation entscheiden, dann greifen Sie auf die unter Date And Time gesetzten Einstellungen zurück.  
![Screenshot 2026-03-02 084824.png](https://doku.evoviu.de/__attachments/a_1a54871e9e139499e387db6eda7f4759cc5a4202771ea07417d1e1ed0d1c4879/Screenshot%202026-03-02%20084824.png?cb=1ae53fa1fe8d029537979088ed9966c3)

### NTP

![Screenshot 2026-03-02 084848.png](https://doku.evoviu.de/__attachments/a_92575e7f84315eb064590dedd245b0b04bd03c2e84237189aabf32f44b11d3bf/Screenshot%202026-03-02%20084848.png?cb=f1f59d1477ab820ece8af50e919770cf)

#### NTP server address

Im Eingabefeld sind folgende Angaben möglich:

* IP-Adresse: Eingabe der IP-Adresse im IPv4-Format: Beispiel: 192.168.9.1

* Domain: Eingabe der NTP-Domain: Beispiel: [http://time1.google.com](http://time1.google.com/)

**Wichtig:** Durch die Eingabe der IP-Adresse Ihres NTP-Servers synchronisiert sich die Kamera automatisch mit der aktuellen Uhrzeit des Servers bzw. der Anlage. **Sie sehen anhand der angepassten Uhrzeit, dass die Synchronisation erfolgreich war.**  
**Neustart nach Einstellung des NTP-Servers:**Es ist zu empfehlen, nach dem Einstellen des NTP-Servers die Kamera neu zu starten. Dabei wird sichergestellt, dass sich alle Teile der Kamera mit der neuen Uhrzeit synchronisieren. Gehen Sie dazu einfach auf "System \> Restart" und laden Sie nach ca. 1 Minute den Browser neu.  
**Primary Routing:**Vergewissern Sie sich, dass Ihre NTP-Server Adresse (Domain / IP-Adresse) am priorisierten Routing-Port verfügbar ist. Beispiel: NTP-Server ist über eine Domain (DNS-Adresse) am Ethernet-Port verfügbar, so muss diese als priorisierte Routing-Adresse ausgewählt werden. Gehen Sie dazu einfach auf "Ethernet \> Use as primary routing". Der Vorgang kann 30 Sekunden dauern.

---
version: "8.6.0"
language: "de"
---
# Date Time

## Now (DateTime)

Mit diesem Knoten können Sie das aktuelle Datum und die aktuelle Uhrzeit zusammen mit einem Zeitversatz übergeben. Ein Zeitversatz ist die Differenz in Stunden und Minuten zwischen einer bestimmten Zeitzone und der koordinierten Weltzeit (UTC).

### Parameterset

| **Parameter** |    **Typ**     |         **Beschreibung**         |
|---------------|----------------|----------------------------------|
| Return        | DateTimeOffset | Aktuelles Datum / aktuelle Zeit. |

## Utc Now (DateTime)

Mit diesem Knoten können Sie das aktuelle Datum und die Uhrzeit in UTC übermitteln. UTC ist eine standardisierte, weltweit gültige Zeitangabe, die als Referenzpunkt für die Zeitsynchronisation in verschiedenen Regionen dient.

### Parameterset

| **Parameter** |    **Typ**     |            **Beschreibung**             |
|---------------|----------------|-----------------------------------------|
| Return        | DateTimeOffset | Aktuelles Datum / aktuelle Zeit in UTC. |

## Day (DateTime)

Mit diesem Knoten können Sie den aktuellen Tag weitergeben.

### Parameterset

| **Parameter** |    **Typ**     |                        **Beschreibung**                        |
|---------------|----------------|----------------------------------------------------------------|
| Date Time     | DateTimeOffset | Aktuelles Datum / aktuelle Zeit (vom Knoten Now oder Utc Now). |
| Return        | Int32          | Aktueller Tag.                                                 |

## Month (DateTime)

Mit diesem Knoten können Sie den aktuellen Monat weitergeben.

### Parameterset

| **Parameter** |    **Typ**     |                        **Beschreibung**                        |
|---------------|----------------|----------------------------------------------------------------|
| Date Time     | DateTimeOffset | Aktuelles Datum / aktuelle Zeit (vom Knoten Now oder Utc Now). |
| Return        | Int32          | Aktueller Monat.                                               |

## Year (DateTime)

Mit diesem Knoten können Sie das aktuelle Jahr weitergeben.

### Parameterset

| **Parameter** |    **Typ**     |                        **Beschreibung**                        |
|---------------|----------------|----------------------------------------------------------------|
| Date Time     | DateTimeOffset | Aktuelles Datum / aktuelle Zeit (vom Knoten Now oder Utc Now). |
| Return        | Int32          | Aktuelles Jahr.                                                |

## Hour (DateTime)

Mit diesem Knoten können Sie die aktuelle Stunde weitergeben.

### Parameterset

| **Parameter** |    **Typ**     |                        **Beschreibung**                        |
|---------------|----------------|----------------------------------------------------------------|
| Date Time     | DateTimeOffset | Aktuelles Datum / aktuelle Zeit (vom Knoten Now oder Utc Now). |
| Return        | Int32          | Aktuelle Stunde.                                               |

## Minute (DateTime)

Mit diesem Knoten können Sie die aktuelle Minute weitergeben.

Parameterset  

| **Parameter** |    **Typ**     |                        **Beschreibung**                        |
|---------------|----------------|----------------------------------------------------------------|
| Date Time     | DateTimeOffset | Aktuelles Datum / aktuelle Zeit (vom Knoten Now oder Utc Now). |
| Return        | Int32          | Aktuelle Minute.                                               |

## Second (DateTime)

Mit diesem Knoten können Sie die aktuelle Sekunde weitergeben.

### Parameterset

| **Parameter** |    **Typ**     |                        **Beschreibung**                        |
|---------------|----------------|----------------------------------------------------------------|
| Date Time     | DateTimeOffset | Aktuelles Datum / aktuelle Zeit (vom Knoten Now oder Utc Now). |
| Return        | Int32          | Aktuelle Sekunde.                                              |

## Millisecond (DateTime)

Mit diesem Knoten können Sie die aktuelle Millisekunde weitergeben.

### Parameterset

| **Parameter** |    **Typ**     |                        **Beschreibung**                        |
|---------------|----------------|----------------------------------------------------------------|
| Date Time     | DateTimeOffset | Aktuelles Datum / aktuelle Zeit (vom Knoten Now oder Utc Now). |
| Return        | Int32          | Aktuelle Millisekunde.                                         |

## To Unix Time Seconds (DateTime)

Mit diesem Knoten können Sie das aktuelle Datum und die aktuelle Uhrzeit in Unix-Zeit umrechnen. Dies entspricht der Anzahl der Sekunden, die seit dem 1. Januar 1970 (Unix-Epoche) vergangen sind.

### Flow

![Screenshot 2026-01-15 113417.png](https://doku.evoviu.de/__attachments/a_9b1f77b570f0707de09af7cc05f5495b56389d658c8cb3366e0ff3c7b7b86e8a/Screenshot%202026-01-15%20113417.png?cb=2590b01c4cdc7b90a0a058fb15212438)

### Parameterset

| **Parameter** |    **Typ**     |                     **Beschreibung**                     |
|---------------|----------------|----------------------------------------------------------|
| Date Time     | DateTimeOffset | Aktuelles Datum und Uhrzeit (von Node Now oder UTC Now). |
| Return        | Int32          | Unix Zeit in Sekunden.                                   |

## From Unix Time Seconds (DateTime)

Mit diesem Knoten können Sie die Unix-Zeit in das aktuelle Datum und die aktuelle Uhrzeit umrechnen. Der eingegebene Wert entspricht der Anzahl der Sekunden, die seit dem 1. Januar 1970 (Unix-Epoche) vergangen sind.

### Flow

![Screenshot 2026-01-15 113357.png](https://doku.evoviu.de/__attachments/a_98fb479698ea292bd834a913efb6aa90641d1c3a8346206a3db1d7d2702fe9c2/Screenshot%202026-01-15%20113357.png?cb=3af176f01eb32e62c2a02a429ef907f6)

### Parameterset

| **Parameter** |    **Typ**     |                     **Beschreibung**                     |
|---------------|----------------|----------------------------------------------------------|
| Seconds       | Int32          | Unix Zeit in Sekunden.                                   |
| Return        | DateTimeOffset | Aktuelles Datum und Uhrzeit (von Node Now oder UTC Now). |

## To String (DateTime)

Mit diesem Knoten können Sie das aktuelle Datum und die Uhrzeit als Zeichenkette übergeben. Dies ist hilfreich, wenn Sie den Wert an einen anderen Knoten weitergeben oder Datum und Uhrzeit im Dashboard anzeigen möchten.

### Parameterset

| **Parameter** | **Typ** |                                                                                                                                                                                                                                                                                 **Beschreibung**                                                                                                                                                                                                                                                                                  |
|---------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Text          | String  | Dies ist ein textbasiertes Datum.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Format        | String  | Hier können Sie das Format für die Anzeige von Datum und Uhrzeit festlegen. Verwenden Sie „HH" für die Stunde im 24-Stunden-Format (00--23) oder „hh" für die Stunde im 12-Stunden-Format (01--12). Bei Verwendung von „hh" wird üblicherweise „tt" für die AM/PM-Angabe hinzugefügt. Datum und Uhrzeit: "yyyy-MM-dd HH:mm:ss", "dd/MM/yyyy HH:mm:ss" oder "MMMM dd, yyyy HH:mm:ss" Nur Datum: "yyyy-MM-dd", "dd/MM/yyyy" oder "MMMM dd, yyyy" Nur Uhrzeit: "HH:mm:ss" oder "hh:mm tt" Benutzerdefinierte Kombinationen: "yyyy-MM-dd hh:mm tt" oder "MMMM dd, yyyy 'at' HH:mm:ss" |
| Return        | String  | Gibt die Zeichenkettendarstellung des aktuellen Datums und der aktuellen Uhrzeit aus.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

## Make (DateTime)

Mit diesem Knoten können Sie beliebige Datums- und Uhrzeitangaben erstellen.  
Hinweis: Es wird die Zeitzone der Kamera verwendet, wenn kein Offset angewendet wird.

### Flow

![Screenshot 2026-01-15 113256.png](https://doku.evoviu.de/__attachments/a_49c5910ed21fd9b7d417cd180a6cb950e7f4e3552e38962dd26a903b08c83319/Screenshot%202026-01-15%20113256.png?cb=c226120a8021c14b0482d8ab4d7aa33c)

### Parameterset

| **Parameter** |    **Typ**     |                                          **Beschreibung**                                          |
|---------------|----------------|----------------------------------------------------------------------------------------------------|
| Year          | Int32          | Stellt das Jahr dar. Gültige Werte liegen zwischen 0 und x.                                        |
| Month         | Int32          | Steht für den Monat. Gültige Werte liegen zwischen 1 und 12.                                       |
| Day           | Int32          | Stellt den Tag dar. Gültige Werte liegen zwischen 1 und 31. Beachten Sie Monate mit weniger Tagen. |
| Hour          | Int32          | Stellt die Stunde dar. Gültige Werte liegen zwischen 0 und 23.                                     |
| Minute        | Int32          | Stellt die Minute dar. Gültige Werte liegen zwischen 0 und 59.                                     |
| Seconds       | Int32          | Stellt den zweiten Wert dar. Gültige Werte liegen zwischen 0 und 59.                               |
| Offset        | TimeSpan       |                                                                                                    |
| Return        | DateTimeOffset | Aktuelles Datum und Uhrzeit (von Node Now oder UTC Now).                                           |

## Parse (DateTime)

Mit diesem Knoten können Sie eine Zeichenkette in einen Datums-/Zeitversatz umwandeln, sofern dies aufgrund ihres Formats möglich ist.

### Flow

![Screenshot 2026-01-15 113143.png](https://doku.evoviu.de/__attachments/a_f609398bb261039e0913dc8f79bf72676f1b3369b5555df239e06f86b2f8982e/Screenshot%202026-01-15%20113143.png?cb=c65d4fa0f2e8a04cd263baa569fa5475)

### Parameterset

| **Parameter** | **Typ** |                                                                                                                                                                                                                                                                                 **Beschreibung**                                                                                                                                                                                                                                                                                  |
|---------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Text          | String  | Dies ist ein textbasiertes Datum.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Format        | String  | Hier können Sie das Format für die Anzeige von Datum und Uhrzeit festlegen. Verwenden Sie „HH" für die Stunde im 24-Stunden-Format (00--23) oder „hh" für die Stunde im 12-Stunden-Format (01--12). Bei Verwendung von „hh" wird üblicherweise „tt" für die AM/PM-Angabe hinzugefügt. Datum und Uhrzeit: "yyyy-MM-dd HH:mm:ss", "dd/MM/yyyy HH:mm:ss" oder "MMMM dd, yyyy HH:mm:ss" Nur Datum: "yyyy-MM-dd", "dd/MM/yyyy" oder "MMMM dd, yyyy" Nur Uhrzeit: "HH:mm:ss" oder "hh:mm tt" Benutzerdefinierte Kombinationen: "yyyy-MM-dd hh:mm tt" oder "MMMM dd, yyyy 'at' HH:mm:ss" |

---
version: "8.6.0"
language: "de"
---
# Datenspeicher

VISIONWEB bietet flexible Speicheroptionen für Daten, Bilder und Konfigurationsdateien. Je nach Einsatzbereich können verschiedene Speicherorte angebunden werden -- lokal oder netzwerkbasiert.  

|       **Datenspeicher**        |                                                                         **Beschreibung**                                                                          |                                **Anleitung**                                |
|--------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|
| SFTP / FTP                     | VISIONWEB überträgt Daten sicher per SFTP oder klassisch per FTP an externe Server -- ideal zur Archivierung oder externen Weiterverarbeitung.                    | [working FTP/SFTP](https://doku.evoviu.de/de/product-documentation/8.6.0/ftp-sftp.md)             |
| NAS (Network Attached Storage) | Netzwerkspeicher ermöglichen eine zentrale, skalierbare Datenablage. VISIONWEB kann direkt auf freigegebenen NAS-Verzeichnissen schreiben oder davon lesen.       | [working NAS - SMB](https://doku.evoviu.de/de/product-documentation/8.6.0/nas-smb.md)             |
| Gerätespeicher (lokal)         | Der interne Speicher dient zur temporären oder dauerhaften Ablage von Bildern und anderen Files. Sie können so auch bei Netzwerkausfall auf Ihre Daten zugreifen. | [working Gerätespeicher](https://doku.evoviu.de/de/product-documentation/8.6.0/geratespeicher.md) |

---
version: "8.6.0"
language: "de"
---
# Digital Input / Output

Neben den **Kommunikationsprotokollen** kann **VISIONWEB** ebenfalls auf **digitale Ein- und Ausgänge** reagieren. Dadurch lassen sich Workflows nicht nur über Nachrichten oder Netzwerkprotokolle, sondern auch direkt über Hardware-Signale anstoßen oder steuern.

Die evoVIU-Kamera verfügt derzeit über **einen digitalen Eingang** sowie **zwei digitale Ausgänge**, die nach außen geführt werden.

* Der **digitale Eingang** dient als **Trigger**, über den externe Sensoren oder Steuerungen (z. B. SPS, Lichtschranken oder Taster) unmittelbar mit der Kamera interagieren können. Ereignisse werden so zuverlässig und in Echtzeit als Auslöser für Workflows nutzbar.

* Die **digitalen Ausgänge** können aus einem Workflow heraus gezielt geschaltet werden. Neben **Statusmeldungen oder Rückmeldesignalen** lassen sich hierüber auch **externe Lichter oder Aktoren** direkt ansteuern. Damit können beispielsweise Prüfbereiche ausgeleuchtet oder Maschinenzustände sichtbar signalisiert werden.

Auf diese Weise lassen sich Kamera, Beleuchtung und externe Peripherie nahtlos in **bestehende Automatisierungsumgebungen** integrieren.

## Digital Input

Der **digitale Eingang** dient in Visionweb in der Regel dazu, einen **Trigger-Event** im Workflow auszulösen. Sobald am **Pin 5 des 5-poligen M12-Steckers** eine gewünschte **Spannungsflanke** (steigend oder fallend) anliegt, wird der zugehörige Event aktiviert und der angebundene Flow gestartet.

Der digitale Input wird unter **Components** über das **„+"-Symbol** angelegt und kann anschließend im **Kontextmenü des Event Graph** ausgewählt und mit Flows verbunden werden. Damit lassen sich externe Signale, z. B. von einer SPS, einem Taster oder einer Lichtschranke, direkt in die Workflow-Logik integrieren. Mehr Infos hierzu sind unter [working Hardware-Events](https://doku.evoviu.de/de/product-documentation/8.6.0/hardware-events.md) beschrieben.

## Digital Output

Die beiden **digitalen Ausgänge** der evoVIU-Kamera können aus einem Workflow heraus gezielt angesteuert werden. Damit lassen sich externe Geräte oder Systeme direkt schalten. Typische Anwendungen sind das **Ausgeben von Statussignalen** an eine SPS, das **Ansteuern von Relais oder Aktoren** oder die **Steuerung externer Beleuchtung**.

In Visionweb wird der Ausgang über die Komponente **Digital Write** realisiert. Diese lässt sich unter **Components** einfach über das **„+"-Symbol** anlegen.  
![image-20250831-194755.png](https://doku.evoviu.de/__attachments/a_7894be9e685401f890ebdcc3182e89a3c9bd71bc3d30fd467828d02ce8e11c1c/image-20250831-194755.png?cb=7ce959d8b7747132d61375863ed94041)

Die angelegten Ausgänge können zudem individuell **umbenannt** werden -- entweder nach ihrer physischen Pin-Nummer (z. B. *Pin2* , *Pin4* ) oder nach ihrer **Funktion im Workflow** (z. B. *ResultOk* , *Busy*). Damit bleibt die Belegung für den Anwender übersichtlich und nachvollziehbar.  
![image-20250831-195056.png](https://doku.evoviu.de/__attachments/a_12882ad1bd9763bf4e94b143543d4a51a3df889b84b07a4eded69a7d3d7d0eab/image-20250831-195056.png?cb=4ffee251b8565305545de6ded957631d)

Für die Einstellung der Komponente kann anschließend die entsprechende Pin-Nummer eingegeben werden. Derzeit sind nur Pin 2 und 4 möglich  
![image-20250831-195257.png](https://doku.evoviu.de/__attachments/a_6b17cca1dc9e1b32034cc985bb497dd176b06856cca15910b18c973f1ed5d509/image-20250831-195257.png?cb=5c98e6684ec046b6ae57114cfd3daef9)

Über den Knoten **Set Pin** im **Kontextmenü des Event Graph** können die gewünschten Pins mit Flows verbunden und so flexibel eingesetzt werden.

Das folgende Beispiel zeigt die Verwendung eines Workflows zur **Bildaufnahme** in Kombination mit der **Steuerung einer externen Beleuchtung**:

* Vor der Bildaufnahme wird über **Digital Write** ein Ausgang aktiviert, um eine angeschlossene Lampe einzuschalten.

* Nach Abschluss der Aufnahme wird der Pin wieder zurückgesetzt, sodass die Beleuchtung abgeschaltet wird.

![image-20250831-195703.png](https://doku.evoviu.de/__attachments/a_f55b422f6edd4b9cd8a23e9fb4309499b076b9711cf32e6c42d53952e42db2c7/image-20250831-195703.png?cb=df1af5e9e42382761834b08309dd9375)

Durch diese direkte Anbindung können Ausgänge mit Bedingungen im Workflow verknüpft werden -- etwa um bei erfolgreicher Bildauswertung ein **OK-Signal** zu setzen oder im Fehlerfall eine **Warnlampe** zu aktivieren. Ebenso kann Beleuchtung gezielt nur während der Bildaufnahme eingeschaltet werden, um optimale Aufnahmebedingungen sicherzustellen.

---
version: "8.6.0"
language: "de"
---
# Dokumente

Das Visionweb bietet eine benutzerfreundliche und leistungsstarke Plattform zur Verwaltung, Verarbeitung und Bereitstellung industrieller Bildverarbeitungsdaten. Ein zentraler Bestandteil vieler automatisierter Workflows ist dabei der Export von Daten in strukturierten Formaten -- insbesondere als **CSV-Dokumente** (Comma-Separated Values). CSV-Dateien sind leichtgewichtig, plattformunabhängig und ermöglichen den einfachen Austausch von Messergebnissen, Parametern oder Metadaten mit Drittsystemen wie MES-, ERP- oder QS-Lösungen.

Im Visionweb können CSV-Dateien direkt im Anschluss an eine Bildaufnahme oder eine Analyse automatisch erzeugt, benannt und an definierten Speicherorten (z. B. SMB-Freigaben, Cloud-Speicher oder NAS-Systeme) abgelegt werden. Dabei lassen sich sowohl der Inhalt als auch das Format der CSV-Dokumente individuell konfigurieren -- je nach Anwendungsfall. Unterstützt wird die Ausgabe von numerischen Werten, Zeichenketten, Zeitstempeln und Statusinformationen.

Diese Anleitung zeigt Schritt für Schritt, wie Sie CSV-Dokumente im Visionweb erzeugen, konfigurieren und sicher speichern. Zudem erhalten Sie Hinweise zur dynamischen Benennung, zum Einfügen von Variablenwerten und zur Integration in bestehenden Datenflüssen. So stellen Sie sicher, dass Ihre Daten genau dort landen, wo sie gebraucht werden -- strukturiert, nachvollziehbar und automatisiert.

---
version: "8.6.0"
language: "de"
---
# Draw

## Get Text Size

Berechnet die Breite und Höhe einer Textzeichenfolge für eine bestimmte Schriftart sowie Skalierung und Linienstärke. Verwende diesen Knoten, um den benötigten Platz zu ermitteln, bevor du Text mit dem Knoten „Plot Text" zeichnest.

### Flow

![Screenshot 2026-04-23 164611.png](https://doku.evoviu.de/__attachments/a_bf0a160ef302d926172ec7587df1dbfe18fc5426110db4aaa045e2db9cb905da/Screenshot%202026-04-23%20164611.png?cb=7374e3de3d5fa258cf15fac8be058dd2)

### Parameterset

|   **Parameter**   | **Typ**  |            **Beschreibung**             |
|-------------------|----------|-----------------------------------------|
| Text              | String   | Der zu vermessende Text.                |
| Font Scale        | Float    | Der Skalierungsfaktor der Schriftgröße. |
| Thickness (Pixel) | Integer  | Die Liniendicke der Schrift in Pixel.   |
| Font Face         | FontType | Die verwendete Schriftart.              |
| Width             | Integer  | Die Breite des Textes in Pixel.         |
| Height            | Integer  | Die Höhe des Textes in Pixel.           |

---
version: "8.6.0"
language: "de"
---
# Entsorgung & Umweltschutz

## Entsorgung von Elektro- und Elektronikgeräten (ElektroG)

Dieses Produkt (evoVIU IoT Edge Camera) fällt unter das deutsche Elektro- und Elektronikgerätegesetz (ElektroG). Es wurde ausschließlich für die gewerbliche Nutzung (B2B) entwickelt und darf nicht über den Hausmüll entsorgt werden.  
![image-20251111-065608.png](https://doku.evoviu.de/__attachments/a_57dbbfe4e65d830112fb644595024404d748f45a6722c5a048c8bccc37941dcf/image-20251111-065608.png?cb=1ea38bed6d9b03586f02c442f22bf5a6)

Das dargestellte Symbol bedeutet, dass Elektro- und Elektronikgeräte getrennt vom allgemeinen Abfall entsorgt werden müssen.

Bitte geben Sie Altgeräte an uns zurück, damit sie einer umweltgerechten Wiederverwendung oder Verwertung zugeführt werden können.

## Rückgabe von Altgeräten

**Gewerbliche Endnutzer** können ausgediente evoVIU-Geräte zur fachgerechten Entsorgung an folgende Adresse zurückgeben:

**evopro systems engineering AG**

Abteilung Produktentwicklung - Rücknahme evoVIU Altgeräte

Im Gewerbepark A71

93059 Regesburg, Deutschland

📧 **E-Mail:** [disposal@evoviu.de](mailto:disposal@evoviu.de)

🌐 **Web:** [http://doku.evoviu.de](http://doku.evoviu.de/)

Die fachgerechte Entsorgung erfolgt über einen **zertifizierten Entsorgungsfachbetrieb** gemäß § 19 ElektroG und § 56 KrWG.

*** ** * ** ***

### 🌍 Umwelthinweis

Bitte unterstützen Sie den Umweltschutz, indem Sie dieses Produkt nach Nutzungsende **nicht unsortiert entsorgen**. Durch die Rückgabe tragen Sie dazu bei, wertvolle Materialien zu recyceln und Schadstoffe sicher zu beseitigen.

*** ** * ** ***

### 🔖 Herstellerangaben

**Hersteller:** evopro systems engineering AG

**Marke:** evoVIU

**Adresse:** Im Gewerbepark A52

**WEEE-Reg.-Nr.:** DE 40384607

**Produkt:** Smart Camera (Industrie-Bildverarbeitung)

**Kategorie:** Kleingeräte für die ausschließliche Nutzung in anderen als privaten Haushalten

---
version: "8.6.0"
language: "de"
---
# Entwicklungsprozess von KI-Lösungen

In diesem Kapitel erfahren Sie die relevanten Schritte und Informationen zur Entwicklung einer KI-Lösung in VISIONWEB.

## YOLO

VISIONWEB ermöglicht KI-basierte Bildverarbeitung durch die Integration von [Ultralytics YOLO-Modellen](https://docs.ultralytics.com/de/models/).

### Unterstützte Aufgabentypen

Ultralytics bietet Modelle für fünf grundlegende Aufgabentypen an, in VISIONWEB werden aktuell vier davon unterstützt:

* **Objekterkennung**: Beschreibt das Lokalisieren und Klassifizieren von Objekten in einem Bild. Objekte werden dabei üblicherweise mithilfe einer Bounding Box lokalisiert.

* **Orientierte Objekterkennung**: Im Gegensatz zur normalen Objekterkennung sind bei der orientierten Erkennung die Bounding Boxes nicht achsenparallel, sondern gedreht, um das Objekt möglichst genau zu lokalisieren.

* **Instanzsegmentierung**: Zusätzlich zu der groben Lokalisierung des Objekts durch eine Bounding Box werden pixelgenaue Masken des Objekts erstellt und zurückgegeben.

* **Klassifikation**: Ordnet das gesamte Bild einer oder mehreren Klassen zu.

Ultralytics bietet für jeden der fünf Aufgabentypen fünf Modellgrößen an. Je größer das Modell, desto genauer ist es, jedoch auf Kosten der Geschwindigkeit. Zudem erfordern größere Modelle in der Regel eine umfangreichere Datengrundlage.

Neben den vier erwähnten Aufgabentypen wird in VISIONWEB zusätzlich die Codeerkennung angeboten. Diese basiert auf einem normalen Objekterkennungsmodell, das auf Lasercodes trainiert wird. Die Codeerkennung gibt die einzelnen erkannten Zeichen als erkannte Objekte zurück, sowie den gelesenen Code.

### Unterstützte YOLO-Versionen

In VISIONWEB werden YOLOv8 und YOLO11 sicher unterstützt. Andere YOLO-Versionen ab YOLOv5 sind potenziell kompatibel, wurden jedoch nicht umfassend getestet.

### Lizenz

Um YOLO-Modelle kommerziell nutzen zu dürfen muss eine [Unternehmenslizenz](https://www.ultralytics.com/legal/enterprise-software-license) von Ultralytics erworben werden, ansonsten muss entsprechend der AGPL 3.0 Software-Lizenz der Sourcecode veröffentlicht werden. Die Einhaltung der Lizenzbedingungen und eventuell notwendige Beschaffung einer Unternehmenslizenz liegt in der Verantwortung des Nutzers.

## Bildaufnahme und -vorverarbeitung

Die Grundlage für die Entwicklung eines Modells ist ein ausreichend umfangreicher und qualitativ hochwertiger Datensatz. Hierfür bietet sich die Bildaufnahme der evoVIU an. Genauere Informationen zur Einrichtung der Image Source und Möglichkeiten der Datenspeicherung finden Sie auf folgenden Seiten:

* [working Bildaufnahme](https://doku.evoviu.de/de/product-documentation/8.6.0/bildaufnahme.md)

* [working Datenspeicher](https://doku.evoviu.de/de/product-documentation/8.6.0/datenspeicher.md)

* [working Cloudspeicher](https://doku.evoviu.de/de/product-documentation/8.6.0/cloudspeicher.md)

Falls nötig kann vor dem Speichern der Bilder bereits eine erste Vorverarbeitung vorgenommen werden, wie Kontrast- oder Helligkeitskorrekturen.  
Alle hier vorgenommen Vorverarbeitungsschritte müssen so auch vor der Eingabe der Bilder in die Inferenz durchgeführt werden.

## Bildannotation

Nachdem ausreichend Daten generiert und entsprechend vorverarbeitet wurden, müssen Annotationen erstellt werden. Hierfür eignen sich Tools wie [LabelStudio](https://labelstud.io/?utm_adgroup=&utm_source=google&utm_medium=paidsearch&utm_campaign=LabelStudio-Brand&utm_term=label%20studio&hsa_acc=5127568629&hsa_cam=20302203335&hsa_grp=201384670464&hsa_ad=801648174200&hsa_src=g&hsa_tgt=kwd-331146738604&hsa_kw=label%20studio&hsa_mt=e&hsa_net=adwords&hsa_ver=3&gad_source=1&gad_campaignid=20302203335&gclid=CjwKCAjw1tLOBhAMEiwAiPkRHl-KH_9zWD12Yu6ATLt-HWe9-IvWQk05KFMw-4ODQL_-4sWryeLL1RoCH1sQAvD_BwE).  
LabelStudio bietet die Möglichkeit, Bilder mit einem bereits trainierten YOLO-Modell vorzuannotieren. Dadurch kann der Labelingprozess erheblich beschleunigt werden.  
Die Präzision des späteren Modells kann maßgeblich durch die Qualität der Annotationen beeinflusst werden.  
![example LabelStudio-20260401-130445.png](https://doku.evoviu.de/__attachments/a_d27b512e51dbafa0900147d329b49fe5297e71980439ba938e2d176550b8ed11/example%20LabelStudio-20260401-130445.png?cb=fb6f5bd31938d22ee73cdc221e2b6cf9)

Für das Training mit Ultralytics müssen die Annotationen für jedes Bild in einer gleichnamigen \*.txt Datei gespeichert werden. Dabei referenziert jede Zeile ein Objekt im Bild und folgt diesem Schema:

*class_id x_center y_center width height*

Die Koordinaten der Bounding Box müssen auf Werte zwischen 0.0 und 1.0 normalisiert werden. Genauere Informationen zum Aufbau der Labeldatei können der [Dokumentation von Ultralytics](https://docs.ultralytics.com/datasets/detect/) entnommen werden. LabelStudio unterstützt bereits den Export der Annotationen in ein YOLO-kompatibles Format, sodass hier keine weiteren Anpassungen mehr notwendig wären.

## Modelltraining

Das Modelltraining kann in Python mit der Ultralytics-Bibliothek durchgeführt werden. Dabei gibt es auch die Option, Transferlernen zu nutzen. Hierbei können auf großen Datensätzen vortrainierte Modelle auf den eigenen Daten optimiert werden. Dies kann zu einer Beschleunigung der Trainingsgeschwindigkeit und insbesondere bei einer geringen Datengrundlage zu einer Stabilisierung des Modells führen.

Das Training kann über eine YAML-Datei konfiguriert werden. Dabei können Hyperparameter wie die Epochenanzahl oder Lernrate gesetzt werden. Zudem können Parameter zur Datenaugmentierung angepasst werden. Genauere Information zu Konfiguration und Durchführung des Trainings sind in der [Ultralytics Dokumentation](https://docs.ultralytics.com/modes/train/#key-features-of-train-mode) zu finden.

Ultralytics führt eine automatische Vorverarbeitung der Bilder durch. Dabei werden die Bilder unter Verwendung einer Letterbox auf die angegebene Eingabegröße skaliert.

Es ist zu empfehlen den Datensatz in Trainings-, Validierungs- und Testdaten zu unterteilen. Eine übliche Aufteilung sind dabei:

* 70% Trainingsdaten

* 15% Validierungsdaten

* 15% Testdaten

Die Pfade zu den einzelnen Datensätzen und die Definition der möglichen Klassen, werden wiederum in einer YAML-Datei angegeben. Das Modell wird dann auf dem Trainingsdatensatz trainiert und währenddessen immer wieder anhand des Validierungsdatensatzes validiert.

Es empfiehlt sich das Modell nach abgeschlossenem Training auf dem Testdatensatz zu validieren. Auch hierfür bietet Ultralytics eine [Methode](https://docs.ultralytics.com/modes/val/) an.

## Modellexport und Quantisierung

Für die Nutzung von YOLO-Modellen auf einer evoVIU gibt es zwei Möglichkeiten. Die Durchführung der Inferenz auf der CPU mit einem *ONNX* -Modell, oder alternativ auf der NPU mit einem *TFLite*-Modell. Die Nutzung der NPU ermöglicht eine erheblich beschleunigte Inferenz, setzt jedoch eine Quantisierung voraus, die zu Präzisionsverlusten des Modells führen kann.

### ONNX

Falls das Modell mit Ultralytics trainiert wurde, muss das daraus resultierende PyTorch-Modell (.pt) in das ONNX-Format exportiert werden. Ultralytics bietet hierfür eine [Exportfunktion](https://docs.ultralytics.com/modes/export/) an.

### TFLite

Für eine Nutzung des Modells auf der NPU muss das Modell in das TFLite-Format exportiert und dabei uint8-quantisiert werden. Dafür muss das [De-Girum](https://github.com/DeGirum/ultralytics_yolov8) Repository verwendet werden.

Nachdem das Repository geklont und aufgesetzt wurde, können über einen CLI-Befehl die Quantisierung und der Export des Modells gestartet werden. Für den Quantisierungsprozess werden Bilder zur Kalibrierung benötigt. Hierfür kann dieselbe YAML-Datei angegeben werden, die für das Training verwendet wurde.  
Es werden mehrere TFLite-Modelle erstellt. Für den Einsatz auf der evoVIU ist ausschließlich die Datei *best_full_integer_quant.tflite* relevant.

**Möglicher CLI-Befehl:**

`python3 dg_export.py --weights path/to/your/best.pt --format tflite --quantize --data path/to/your/data.yaml --img-size 640 --max_ncalib_imgs 648`

## Inferenz in VISIONWEB

Für jede Aufgabe und Modellart gibt es entsprechende Knoten und Komponenten im Workflow. Die Knoten und Komponenten befinden sich jeweils unter *Applications\|ONNX* oder *Applications\|NPU*.

### Komponenten

Über die Komponenten können Einstellungen für die Inferenz und Nachbearbeitung der Ergebnisse getroffen werden. Verfügbare Komponenten sind:

* ONNX Yolo Detection

* NPU Yolo Detection

* ONNX Yolo Classification

* NPU Yolo Classification

* ONNX Yolo Segmentation

* NPU Yolo Segmentation

* ONNX Code Detection

* NPU Code Detection

Die unterschiedlichen Komponenten ähneln sich in den grundlegenden Einstellungen, variieren aber zu Teilen entsprechend der durchzuführenden Objekterkennungsaufgabe.

#### Inference Settings

* ++Model File Path++: Gibt den Pfad zu dem ONNX- oder TFLite-Modell an, das für die Inferenz genutzt werden soll.

Achten Sie darauf, dass die gewählte Komponente und das Modell in Bezug auf Aufgabenstellung und Hardware übereinstimmen.

* ++Number Of Threads++: Bestimmt die Auslastung der NPU/CPU.

#### Output Parsing Settings

* ++Oriented Boxes++ ++*(Detection)*++: Gibt an ob orientierte oder normale Objekterkennung durchgeführt werden soll.

Es muss entsprechend das passende Modell angegeben werden!

* ++Confidence Threshold:++ Gibt den minimalen Confidence-Wert an. Detektionen unterhalb dieses Werts werden aussortiert. Ein üblicher Wert ist *0.6*.

* ++Mask Threshold++ ++*(Segmentation)*++ ++:++ Gibt an ab welchem Confidence-Wert Pixel als Teil der Maske angesehen werden. Ein üblicher Wert ist *0.5*.

* ++IoU Threshold++ ++*(Detection, Segmentation)*++ ++:++ Gibt an wie hoch die Überlappung zwischen zwei erkannten Objekten sein darf. Dadurch werden Detektionen die das gleiche Objekt referenzieren aussortiert. Ein üblicher Wert ist *0.45*.

* ++Maximal Number Of Detections:++ Gibt an wie viele Detektionen maximal zurückgegeben werden.

#### Processed Image Settings *(Detection, Segmentation)*

Diese Einstellungen betreffen die Ausgabe des verarbeiteten Bildes. Auf diesem werden die erkannten Objekte, deren Confidence-Werte und Klassen angezeigt. Aus Übersichtsgründen kann die Beschriftung der erkannten Objekte deaktiviert werden. Eine Bounding Box wird immer eingezeichnet. Bei der Klassifikation wird nichts eingezeichnet, da das ganze Bild klassifiziert wird.

#### Npu Inference Settings *(NPU)*

Einstellungen, die nur bei der Inferenz auf der NPU relevant sind:

* ++Bilinear Interpolation++ ++*(Segmentation):*++ Interpoliert die Masken der erkannten Objekte. Das führt zu genaueren Konturen.

* ++Classes File Path:++ Pfad zu einer JSON-Datei, die die möglichen Klassen mit Id und Namen definiert. Der Aufbau der JSON sollte diesem Format entsprechen:

      {
        "categories": [
          { "id": 0, "name": "dog" },
          { "id": 1, "name": "cat" },
          ...
        ]
      }

Alle Klassen, auf denen das Modell trainiert wurde, müssen in der JSON-Datei enthalten sein!

* ++Return Preprocessed Image:++ Gibt an, ob das vorverarbeitete Bild zurückgegeben weden soll. Aus Laufzeitgründen ist diese Option standardmäßig deaktiviert.

![example_settings1-20260401-121015.png](https://doku.evoviu.de/__attachments/a_38892099092bb411224200ff85572f51198c9616e4cb8329d0173015c38b9a00/example_settings1-20260401-121015.png?cb=ae30ea4ed55386b718d78862ad4d4e15)  
![example_settings2-20260401-120835.png](https://doku.evoviu.de/__attachments/a_2ba52f81956471aef4764ae9a7505b7ec0b22d84d71e68df19023a8405ce5028/example_settings2-20260401-120835.png?cb=60a9e62be8acb51133ad9e91f4e3c779)
Beispielkonfiguration einer 'NPU Yolo Segmentation' Komponente

### Knoten

Im Workflow werden acht unterschiedliche Knoten zur Verfügung gestellt:

* Detect Objects (ONNX)

* Detect Objects (NPU)

* Classify Image (ONNX)

* Classify Image (NPU)

* Segment Instances (ONNX)

* Segment Instances (NPU)

* Detect Code (ONNX)

* Detect Code (NPU)

An diese müssen die entsprechenden Komponenten übergeben werden, sowie ein oder mehrere Bilder.  
Die Bilder sollten unter ähnlichen Bedingungen aufgenommen werden wie die Trainingsdaten. Angewendete Vorverarbeitungsschritte vor dem Training sollten auch auf die Bilder vor der Eingabe in den Inferenzknoten durchgeführt werden.

Jeder der Knoten gibt nach der Inferenz die gefundenen Klassen aller eingegebenen Bilder, sowie Meldungen bezüglich des Inferenzergebnisses zurück. Zudem wird für jedes eingegebene Bild ein sogenanntes *Raw Result* erstellt. Diese unterscheiden sich entsprechend der durchgeführten Aufgabe:

* Inference Detection Result

  ![grafik-20260401-115726.png](https://doku.evoviu.de/__attachments/a_d2a8618e4fdbb04f9d4333c245f62e88d5044e6f2bc8b554559e29c23ed7a99f/grafik-20260401-115726.png?cb=4ff5c75bb6c3e81055aea2b1a7ef1935)
* Inference Classification Result

  ![grafik-20260401-115810.png](https://doku.evoviu.de/__attachments/a_c0146f8acba2b4828b84664e713b31e97247d9e26b3e61f2e814ecb54a7d7b01/grafik-20260401-115810.png?cb=573963d3a2209468b7cee5230490a903)
* Inference Segmentation Result

  ![grafik-20260401-115857.png](https://doku.evoviu.de/__attachments/a_5023d2c7532cc2738eb7985bbe28c82a46ba7573edba5e9da1136da7c163a173/grafik-20260401-115857.png?cb=f9157996af4b6e6c257514ce0c2e59b1)
* Inference Code Detection Result

  ![grafik-20260401-132625.png](https://doku.evoviu.de/__attachments/a_6be89bb2c9e1aa2370d7ad4067b1088d99b019e3943b8e7d54eee68a09232272/grafik-20260401-132625.png?cb=75a59c575902a1c1d32e9bc716a4cc88)

Die *Raw Results* enthalten alle validen Detektionen. Dabei kann es sich um Bounding Boxes, Objektklassen und zugehörige Confidence-Werte handeln, oder im Falle der Instanzsegmentierung um Masken der gefundenen Objekte. Zusätzlich wird das vorverarbeitete Bild und das eingegebene Bild mit eingezeichneten Bounding Boxes und Beschriftungen zurückgegeben. Analog zum Training mit Ultralytics werden die Eingabebilder automatisch auf die benötigte Größe unter Verwendung einer Letterbox skaliert. Das daraus resultierende Bild kann im *Preprocessed Image*eingesehen werden.  
![grafik-20260401-120153.png](https://doku.evoviu.de/__attachments/a_02acf8aebb1f7319ed4aa6699a9b09252f45fbe0616ffbae55aab50568dfd215/grafik-20260401-120153.png?cb=c7bece2c9b1822043697ad38ed50ba18)

Der folgende Workflow zeigt beispielhaft die Verwendung eines YOLO-Modells zur Objekterkennung auf der NPU, sowie der anschließenden Speicherung der Ergebnisse in entsprechenden Variablen.  
![example_workflow-20260407-112236.jpg](https://doku.evoviu.de/__attachments/a_0db1beaca7089d671d21558093eb6bea3755afac93a0efa0f1810f5d2eaea37d/example_workflow-20260407-112236.jpg?cb=7128124ef7cfd39dc9f8dab24321e7cf)

---
version: "8.6.0"
language: "de"
---
# Enums

## Einleitung

Erstellen Sie Enumerationen mit einer beliebigen Anzahl an Membern und integrieren Sie diese im Workflow, indem Sie das Enum als Datentyp eine Variable setzen.

## Verwaltung von Enums

Zur Nutzung und Verwaltung von Enums müssen Sie zum einen sicherstellen, dass Sie als aktiver Editor eingeloggt sind, und zum anderen prüfen, dass der Workflow nicht aktiv ist.

### Hinzufügen von Enums

In der "My Workflow"-Sektion können Sie Enums erstellen. Diese Enums können über Get- und Set-Knoten im Workflow integriert werden.

### Entfernen von Enums

Wenn Sie mit der Maus über einen Eintrag fahren, taucht auf der rechten Seite ein "Mülleimer"-Icon auf. Mit einem Klick auf dieses wird ein Dialog geöffnet, in dem Sie den Löschvorgang bestätigen müssen.  
**Wichtig:** Enums können nur entfernt werden, wenn Sie nicht als Knoten im Workflow verwendet werden. Falls eine Usage vorliegt, so müssen Sie zuerst den Knoten im Workflow entfernen, bevor Sie anschließend auch das Enum entfernen können.

### Sortieren von Enums

In der Auflistung der Enums finden Sie bei jedem Eintrag auf der linken Seite ein Icon mit zwei waagrechten Strichen vor. Wenn Sie darauf klicken und die Taste gedrückt halten, können Sie Einträge innerhalb des Bereichs der Enums verschieben. Dies ermöglicht Ihnen einen besseren Überblick.

### Duplizieren von Enums

Wenn Sie mit der Maus über einen Eintrag fahren, taucht auf der rechten Seite links neben dem "Mülleimer"-Icon ein weiteres Icon auf. Mit einem Klick auf dieses können Sie das Enum mit allen Bestandteilen duplizieren.

### Usages von Enums

Sobald Sie ein Enum im Event Graph als Knoten hinzufügen, liegt eine Usage vor. Diese erkennen Sie an einem Icon neben der Bezeichnung des Enums. Wenn Sie auf dieses Icon klicken, öffnet sich ein Dialog in dem die Verwendung des Enums mit einigen Details aufgelistet wird.

## Konfigurationsmöglichkeiten

### Hinzufügen von Membern

Im Details Tab des zugehörigen Enums können Sie Member hinzufügen. Dafür müssen Sie lediglich auf das Plus-Icon in der Überschrift klicken.

### Entfernen von Membern

Wenn Sie mit der Maus über einen Eintrag fahren, taucht auf der rechten Seite ein "Mülleimer"-Icon auf. Mit einem Klick auf dieses wird der Eintrag sofort entfernt.

### Sortieren von Membern

In der Auflistung der Member finden Sie bei jedem Eintrag auf der linken Seite ein Icon mit zwei waagrechten Strichen vor. Wenn Sie darauf klicken und die Taste gedrückt halten, können Sie Einträge innerhalb des Bereichs der Member verschieben. Dies ermöglicht Ihnen einen besseren Überblick.

## Nutzung im Workflow

Knoten, in denen Enums verwendet werden sind beispielsweise der To String, Literal oder der Select Knoten. Um ein Enum über die Set- oder Get-Methode dem Event-Graph hinzuzufügen, können Sie Ihr benutzerdefiniertes Enum in einer Variable abspeichern. Dazu geben Sie Ihr Enum als Datentyp Ihrer Variable an.

---
version: "8.6.0"
language: "de"
---
# Erste Schritte im VISIONWEB

In diesem Kapitel wird die Weboberfläche behandelt. Erfahren Sie, wie diese aufgebaut ist und welche Möglichkeiten sie Ihnen bietet.

## Home Screen

Standardmäßig landen Sie auf dem Home-Screen. Von hier aus ist es einfach, zu anderen Menüs zu wechseln. Die Kacheln auf der Startseite ermöglichen Ihnen ebenso den Zugriff auf weitere Menüpunkte.  
![Screenshot 2026-05-13 100831.png](https://doku.evoviu.de/__attachments/a_bea4b8ce08533f775895403c1d47eaeb1d99ae826253fc826e3c3190bb46b9c1/Screenshot%202026-05-13%20100831.png?cb=fa13ec24b2709cbd2b1b60d6e1b50a6f)

## Header

Im rechten oberen Eck können Sie den Edit-Modus für sich beanspruchen. Erst nachdem Sie auf das *Edit-Icon* geklickt haben, können Sie Aktionen durchführen.

Links daneben wird Ihnen angezeigt, wie viele Nutzer sich aktuell auf der Kamera befinden.

Bei dem Icon daneben können Sie Einstellungen zum Bildformat und zur Bildqualität vornehmen. Das bezieht sich auf die Aufnahme in der Image Source.

Ganz rechts, durch einen vertikalen Strich abgetrennt, befindet sich der Button zum Anmelden als Nutzer. Wenn Sie bspw. eine Aktion durchführen möchten, für die Administrator-Rechte benötigt werden, können Sie den Anmelde-Dialog über diesen Button öffnen.  
![Screenshot 2026-05-13 100905.png](https://doku.evoviu.de/__attachments/a_390bcaa3c62198053da349caa8e04dfc8b8da83b781e6009ca0d4821c08181ed/Screenshot%202026-05-13%20100905.png?cb=e98c81492f9a06d9e0fe49a018320371)

Befinden Sie sich gerade nicht auf dem Home Screen, sondern in einem der anderen Bereiche, dann können Sie weitere Icons sehen. Diese werden in den jeweiligen Unterpunkten genauer erläutert.

Links oben sehen Sie, in welchem Menüpunkt Sie sich befinden. Auf dem Icon links daneben können Sie das Menü ein- und ausklappen  
![Screenshot 2025-12-02 083805.png](https://doku.evoviu.de/__attachments/a_7d00a0dbb7c9348bd07600539e1104030efbd834ab9acfff65c267175c0d0cb8/Screenshot%202025-12-02%20083805.png?cb=7bae07b82c7909037869001b8180ba33)

## Menü

Im Menü können Sie zwischen allen Punkten navigieren, die Sie brauchen, um Ihre Smart Kamera optimal nutzen zu können. Die einzelnen Menüpunkte werden Ihnen unter den jeweiligen Kapiteln in diesem Wiki näher erklärt.  
![Screenshot 2025-12-02 083833.png](https://doku.evoviu.de/__attachments/a_da800a8da5811961ef8a9cecb39fc889fa6204f1ab2e738b4f8db758b23f5528/Screenshot%202025-12-02%20083833.png?cb=2b2d26bc8e79c6504b9731acc3dcf277)

## Aktuelle Stream Übersicht

Links unten finden Sie eine Übersicht, die Ihnen anzeigt, welcher Stream und welche Konfiguration aktuell aktiv ist.  
![Screenshot 2025-12-02 083849.png](https://doku.evoviu.de/__attachments/a_3ad31a92e6e66adbea1485a0077937ad49be2ba5258559dde94a7c8e9b22b894/Screenshot%202025-12-02%20083849.png?cb=1781f0f3a1eae207450581eaa354b3e3)

Mit dem Pause-Symbol können Sie den aktuellen Stream stoppen und mit dem Symbol links daneben können Sie direkt auf Ihren aktiven Stream gelangen.

## Footer

Hier werden Ihnen Informationen zu Ihrer Kamera angezeigt. Dazu gehören zum Beispiel die Software- oder Betriebssystemversion, der Name der Kamera oder die aktuelle Auslastung. Welche Informationen Sie hier genau sehen wollen, können Sie in den Settings unter Customization einstellen.  
![DOC_VIU-18585.png](https://doku.evoviu.de/__attachments/a_a744fa323493d09a1cb5190996fa22eb4dd3bde319e3ddcc2bb26fbafe8039c3/DOC_VIU-18585.png?cb=53e69523d6214f56a50d1f7634af350e)  
[Erste Schritte_V2.mp4](https://doku.evoviu.de/__attachments/a_309fd7009f5eea23f99250ecce307415903983e7f881979820ba82a93504e618/Erste%2520Schritte_V2.mp4.md)

---
version: "8.6.0"
language: "de"
---
# Erste Schritte mit evoVIU

In diesen Kapitel werden die Ersten Schritte beschrieben, die beim Erhalt der Kamera durchlaufen werden sollten.

**Herzlichen Glückwunsch!**

Mit dem Erwerb der evoVIU Smart-Kamera haben Sie einen wichtigen Schritt in Richtung Digitalisierung und Prozessoptimierung Ihrer Produktion getan.

Sie haben sich für ein zukunftsorientiertes Produkt entschieden, das mit Ihren Anforderungen wächst -- flexibel, leistungsstark und zuverlässig.

Alles aus einer Hand -- alles *Made in Bavaria.*

## Aufpacken - Loslegen!

1. Öffnen Sie zunächst Ihre evoVIU Verpackung. Folgende Teile sollten Sie vorfinden:

   1. evoVIU - Kamerasystem ihrer bestellten Variante

   2. WLAN-Antenne

   3. First Steps-Anleitung

   4. OverVIU Information

2. Prüfen Sie zunächst, ob alle Komponenten vorhanden sind und keinerlei Versandbeschädigungen aufweisen.

3. Prüfen Sie bitte, ob die Kamera-Variante der bestellten Kameravariante entspricht.

[Unboxing_final_klein.mp4](https://doku.evoviu.de/__attachments/a_561ec68f39ebab4950cc196085755adcad6560a7eca910ea7f930fc560c26111/Unboxing_final_klein.mp4.md)

### Anschließen - Ready-to-Go!

1. Je nach Kameraversion können Sie Ihre evoVIU Smart-Kamera schnell und unkompliziert in Betrieb nehmen. Dafür stehen Ihnen zwei verschiedene Steckverbindungen zur Auswahl, sodass Sie flexibel auf Ihre individuellen Anforderungen reagieren können.

   ![image-20250812-081817.png](https://doku.evoviu.de/__attachments/a_588c58b82033d1222dafc7532483282806b2650c49bb13da3b7f79c5e5bcc45d/image-20250812-081817.png?cb=e6652605f5fc90917bfe0ecaacdf0c78)

   1. **Versorgung**

      VIU1: WiFI-SMA \| M12-A-5pin \| M12-X-COD

      VIU2: WiFI-SMA \| M12-A-5pin \| M12-X-PoE

   2. **Netzwerk-Anbindung**

      VIU1: WiFI-SMA \| M12-A-5pin \| M12-X-COD

      VIU2: WiFI-SMA \| M12-A-5pin \| M12-X-PoE

   3. **Wifi-Anbindung**

      VIU1: WiFI-SMA \| M12-A-5pin \| M12-X-COD

      VIU2: WiFI-SMA \| M12-A-5pin \| M12-X-PoE

2. Während des Startvorgangs wird der Bootprozess der Kamera auf dem integrierten Display angezeigt. Sobald das Display aktiv ist, wurde die Kamera erfolgreich hochgefahren.

   Sollte das Display zunächst dunkel bleiben, drücken Sie eine beliebige Taste -- die Anzeige sollte daraufhin erscheinen.

### Verbindung zur Kamera aufbauen

1. Datenanbindung über X-coded Netzwerkkabel

   1. Unter „OverVIU-Information" sind alle Werkseinstellungen der Kamera aufgelistet.

   2. Über den **Info-Button** im Display können Sie die aktuell eingestellte IP-Adresse einsehen. Bei Bedarf lässt sich diese dort auch direkt ändern.

   3. Schließen Sie die Kamera am gewünschten Netzwerkport an. Passen Sie anschließend entweder die Netzwerkeinstellungen an die vorhandene IP-Adresse der Kamera an oder ändern Sie die IP-Adresse am Gerät über das Display entsprechend dem vorhandenen Netzwerk.

   4. Öffnen Sie nun Ihren Browser und geben Sie die gewünschte IP-Adresse in die Adresszeile ein.

Damit die IP-Adresse der Kamera angezeigt werden kann, muss diese physisch mit einem Netzwerk verbunden sein. Ohne aktive Netzwerkverbindung bleibt der Ethernet-Port deaktiviert.

Ob die Netzwerkeinstellungen der Kamera mit denen des Netzwerks übereinstimmen, spielt dabei keine Rolle -- die physische Verbindung wird trotzdem erkannt.

Ein aktiver Ethernet-Anschluss wird im Display durch ein fett dargestelltes **ETH**-Symbol oben rechts angezeigt.  
![image-20250812-075343.png](https://doku.evoviu.de/__attachments/a_597df4a018bf9ee99c8e6f3dd00fb4a5d1fed39fc5505241e19fa9ed405117cc/image-20250812-075343.png?cb=21651e7ec9d8e8518e33e4135396137c)  
Herzlichen Glückwunsch - Sie sind nun auf der Kameraoberfläche. Los gehts!

2. Datenanbindung über Wifi-Accesspoint

   1. Stellen Sie sicher das der Wifi-Access-Point aktiviert ist. Dazu können Sie in den Display-Settings nachsehen. Wenn der Toggle-Button grün ist sollten Sie die Kamera über Ihre WLAN-Schnittstelle sehen können. (Siehe auch: [working VIUx: Display](https://doku.evoviu.de/de/product-documentation/8.6.0/viux-display.md))

   2. Stellen Sie ebenfalls sicher, dass die Antenne an der Kameras aufgeschraubt ist.

   3. Gehen Sie nun auf den Laptop und suchen Sie nach dem gewünschten Accesspoint

      ![image-20250812-065111.png](/__attachments/a_75fe7b58e82a243a01065ae3eb3160cebf9cf89939ce0852ef19d69aa830c995/image-20250812-065111.png?cb=236fdac1e4d4b47f9858d71831e07559)
      Suchen Sie nach Ihrer evoVIU Kamera   
   4. Wählen Sie aus, ob Sie die in Zukunft sich automatisch verbinden wollen oder nicht.

      ![image-20250812-065410.png](/__attachments/a_8a12de7fee443827718eb1d4448d04df1a05d88537a39f3dd2e38cfe960a46e5/image-20250812-065410.png?cb=f7b4f9b1c48ccbd2e96286eda9015b58)
      Verbindung mit einen evoVIU Hotspot herstellen   
   5. Im ersten Schritt frägt Windows nach einem Pin - diesen Punkt können Sie mit Klicken auf "Stellen Sie stattdessen die Verbindung mithilfe eines Passworts her" übergehen. Diese Funktion wird aktuell noch nicht genutzt

      ![image-20250812-065632.png](/__attachments/a_88ea99ad57da5dbb1c62a5b0a2ea46448eb5dc60f6a19535116f99590614b71e/image-20250812-065632.png?cb=4fde11111d327790e8f52819c9ea413c)
      Bitte überspringen Sie die Pin-Anfrage
   6. Geben Sie bei der ersten Verbindung das initiale Passwort auf Ihrer Overviu-Information ein.

      ![image-20250812-065759.png](/__attachments/a_668615d1f4fe8672eb5c289eff2ef47a14990c77ef2b7573875e24e710f06410/image-20250812-065759.png?cb=bf7107c36ef70eb364fbcc0827b27527)
      Eingabe des Initialpassworts

Windows versucht standardmäßig, über den Access Point eine Internetverbindung herzustellen. Dadurch kann es etwas länger dauern, bis der Verbindungsaufbau als „Erfolgreich" angezeigt wird. Sie müssen jedoch nicht warten -- öffnen Sie einfach direkt Ihren Browser, um fortzufahren.

Bitte wundern Sie sich nicht, wenn in den Windows-Netzwerkeinstellungen „Keine Verbindung" angezeigt wird. Diese Meldung bezieht sich auf den Versuch, eine Internetverbindung herzustellen, und hat **keinen Einfluss** auf die Verbindung zur Kamera.

g. Geben Sie die IP-Adresse des Access-Points in die Browser-Adresse nun ein.  
![image-20250812-075537.png](https://doku.evoviu.de/__attachments/a_3c4416de82015702223b8f9f964f3ab29d6aaa1ea0b1a391968fefee8cfb843f/image-20250812-075537.png?cb=bb368c5ed517247655c1addab4baecd7)  
Herzlichen Glückwunsch - Sie sind nun über Accesspoint auf der Kameraoberfläche.  
[Integration_evoVIU_short_final_color.mp4](https://doku.evoviu.de/__attachments/a_36b847061c5cd7878a8b63c4f05edbc68813b54a633188e09ec18a37c8963828/Integration_evoVIU_short_final_color.mp4.md)

TIPP: Um die Kamera für das gewünschte Netzwerk über Ethernet einzustellen, empfiehlt es sich, zunächst über den Access Point auf die Benutzeroberfläche zuzugreifen.

Soll die Kamera hingegen in das vorhandene WLAN eingebunden werden, empfiehlt es sich, umgekehrt lokal über das Ethernet-Kabel auf die Anwendung zuzugreifen. (Siehe auch [working Netzwerkeinstellungen](https://doku.evoviu.de/de/product-documentation/8.6.0/netzwerkeinstellungen.md) )

---
version: "8.6.0"
language: "de"
---
# Event-Trigger

Jeder **Event Graph** und jeder **Flow** benötigt ein auslösendes Ereignis, um gestartet und abgearbeitet zu werden. Das einfachste Beispiel ist ein **Start-Event**, das automatisch beim Initialisieren eines Workflows ausgelöst wird.  
![image-20250827-121027.png](https://doku.evoviu.de/__attachments/a_045633001b1b847365b767519e1dc647c58bf14156498626a1bd71e60fddb604/image-20250827-121027.png?cb=0f6176f0b3ec81e48011d15a8a7797c6)
Start-Event

In der Praxis sollen Workflows jedoch meist **reaktiv** auf bestimmte Ereignisse reagieren. Dafür stellt Visionweb eine Vielzahl von **Event-Typen** bereit:

* **Start- und Basis-Events**: Grundlegende Auslöser, direkt im Kontextmenü verfügbar.

* **Timer- und Scheduler-Events**: Starten Aktionen zu festgelegten Zeiten oder Intervallen.

* **Hardware-Events**: Reagieren auf physikalische Signale wie Eingänge oder Sensorwerte.

* **Protokoll-Events**: Werden durch eingehende Nachrichten oder Systemänderungen aktiviert und können Daten zur weiteren Verarbeitung mitführen.

Mehrere unterschiedliche Events können parallel an einen **Flow** angebunden werden. So lässt sich derselbe Flow beispielsweise sowohl über einen Button-Event als auch über ein Protokoll-Event starten.  
![image-20250827-122234.png](https://doku.evoviu.de/__attachments/a_c1c08c809a9f10b73ed845a4bd62e065db47eb2d79011a38f79b7a487b9731d7/image-20250827-122234.png?cb=a02730a5e360c2ebd3bfe8f10e59e070)
Beispiel löst einen Flow beim Start, zu einen bestimmten Zeit oder bei einen TCP-Befehl aus

## Abarbeitung \& Systemverhalten

Zur Sicherung einer **taktzeitstabilen Verarbeitung** werden Events **sequentiell** abgearbeitet; eine parallele Ausführung ist architekturbedingt nicht möglich. Eingehende Ereignisse werden in einer **Eventqueue** gepuffert, die bis zu **10 Events** aufnehmen kann. Weitere Events werden verworfen.

In bestimmten Komponenten können eingehende Ereignisse so lange **ignoriert** werden, bis der aktuelle Event Graph vollständig abgeschlossen ist. Dadurch bleibt die Prozessausführung stabil, nachvollziehbar und zuverlässig.

---
version: "8.6.0"
language: "de"
---
# Event Trigger Widget

## Event Trigger Widget

Fügen Sie auf dem Dashboard das Widget "Event Trigger" über den "Add"-Button hinzu. Wechseln sie gegebenfalls erst in den Editor Mode.  
![grafik-20250925-140542.png](https://doku.evoviu.de/__attachments/a_33606b860065ac3099515d971b9be7f559107a66c469cb9237f799cca81a0387/grafik-20250925-140542.png?cb=c0f01afd1d977360bb79c9b64571c6f4)

Mit Klick auf den Button "select one" können bestehende Button Events hinzugefügt werden.  
![grafik-20250926-065858.png](https://doku.evoviu.de/__attachments/a_d55390fe544319262df769fd87199e421f5bca01e8b8f657365f79ca3c1246fa/grafik-20250926-065858.png?cb=e570007804a2f7b7267a61a16659699d)

Wählen Sie im Dialog "Choose Event Components" einen Button Event aus der Liste aus. Setzen Sie dazu das Häckchen rechts neben dem Button Event Namen. Es kann nur ein Button Event gesetzt werden. Wenn sie parallel einen weiteren Button Event im Dashboard verwenden möchten, muss ein seperates Event Trigger Widget erzeugt werden. Das ausgewählte Button Event wird nun im Widget mit einem Button und dem Namen des Button Events angezeigt. Ist der Workflow nicht gestartet ist der Button zunächst ausgegraut. Wird der Workflow gestartet, wird der Button aktiviert und kann geklickt werden um das Event im Workflow auszulösen.  
![grafik-20250925-141713.png](https://doku.evoviu.de/__attachments/a_980366c827053469863c1ba1af908a56b0fb50b3fc1ebf9a1bf154056d83ccf2/grafik-20250925-141713.png?cb=f51afd31a07751981066d518c74fce7c)

---
version: "8.6.0"
language: "de"
---
# File Image Source

In diesem Kapitel finden Sie allgemeine Informationen zu der Bedienung der File Image Source.

## Einleitung

Wenn Sie eine neue Bildquelle erstellen, können Sie den Typ festlegen. In den meisten Fällen wird wohl der Typ Hardware genutzt werden, in speziellen Szenarien kann es jedoch auch sinnvoll sein auf eine bestimmte Datenquelle zurückzugreifen. Hier kommt die Bildquelle vom Typ File ins Spiel. Verweisen Sie hier auf einen Ordner im Dateisystem und zeigen Sie die darin enthaltenen Bilder in der Bildquelle an.

## Auto Update

Im Bereich General Settings befindet sich die Einstellungsmöglichkeit zur automatischen Übernahme von Änderungen in der Bildquelle. Per default ist diese Einstellung aktiv. Wenn Sie Änderungen in der Bildquelle nicht automatisch speichern möchten, dann können Sie hier diese Einstellung deaktivieren. Stattdessen sehen Sie dann einen Button zur Übernahme der neuen Werte sobald Änderungen vorliegen.  
![Screenshot 2026-02-20 143646.png](https://doku.evoviu.de/__attachments/a_cdcf55e86302111e21236e240d26f2e94ae762a560495ed423aad68636da7bbc/Screenshot%202026-02-20%20143646.png?cb=2bd9fea3c839b34820e1aebf86bc9482)

## Acquisition

### Mode

In den Bildaufnahme-Einstellungen können Sie zwischen den vier verschiedenen Aufnahme-Modi wählen: Manual, Free Run, Hardware und Remote. Zusätzlich dazu können Einstellungen zum Belichtungsmodus, zur Belichtungszeit und zur Frame Rate gemacht werden. Je nach Modus gibt es weitere Einstellungsmöglichkeiten.

### Modus 1: Manual

Standardmäßig ist der Manual-Modus eingestellt. In diesem Modus können Sie über den gelben Button in der Image Source Control Bar manuell ein Bild aufnehmen.  
![Screenshot 2026-03-02 081025.png](https://doku.evoviu.de/__attachments/a_efb5b814603d6cac4c924fea9dc18ae1fd114757cc4058ca606713d4493741fb/Screenshot%202026-03-02%20081025.png?cb=74ff909d5704c53b67034459749c8c98)

### Modus 2: Free Run

Ihre Bilder werden beim Free Run-Modus kontinuierlich aufgenommen. Sie haben hier die gleichen Einstellungsmöglichkeiten wie beim Manual Modus und eine weitere.  
![Screenshot 2026-03-02 081039.png](https://doku.evoviu.de/__attachments/a_37ee9fedd79389a3c14c58fcd532398459334967b65457f48e56b7f8acb92d29/Screenshot%202026-03-02%20081039.png?cb=abafb8f40e3057ba871a7dc2f8a2beb5)

**Frame Rate**

Sie können auswählen, wie viele Bilder pro Sekunde aufgenommen werden sollen. Wählen Sie einen Wert zwischen 1 und 30 fps. Eine hohe Framerate kann negative Auswirkungen auf die Leistung der Kamera haben.

### Modus 3: Hardware

Beim Hardware-Modus löst ein Hardware Trigger über den Trigger Pin Ihres Docker-Anschlusses der Smart Kamera die Aufnahme aus. Zu den bereits bekannten Einstellungen vom Manual Modus kommen drei weitere hinzu.  
![Screenshot 2026-03-02 081055.png](https://doku.evoviu.de/__attachments/a_9978214981661a74a99a295f068d209cb7738ab7fd99af092d179dcf176221ab/Screenshot%202026-03-02%20081055.png?cb=81ac5b6874a77aab005a34a8e1a9f38c)

#### Delay

Bei Delay können Sie einen Wert zwischen 0 und 5000 Millisekunden einstellen. Je nach Eingabewert verzögert sich die Bildaufnahme nach dem Trigger.

#### Bouncing Time

Bei der Bouncing Time können Sie einen Wert zwischen 0 und 1000 wählen. Das ist die Zeit, die nach einem Trigger abgewartet wird, bis erneut auf einen Trigger reagiert wird. So kann vermieden werden, dass zwischendurch mehrere Aufnahmen durch fehlerhafte Trigger gemacht werden.

#### Edge

Hier können Sie einstellen, ob das Bild aufgenommen werden soll, sobald der Trigger ausgelöst wird (rising) oder sobald der Trigger nicht mehr wahrzunehmen ist (falling).

### Modus 4: Remote

Mit dem Remote-Modus können Sie die Bilder auch manuell aufnehmen, allerdings nicht über die Weboberfläche, sondern über die http-Rest Schnittstelle. Die Einstellungsmöglichkeiten sind die gleichen wie beim Manual Modus.  
![Screenshot 2026-03-02 081209.png](https://doku.evoviu.de/__attachments/a_e9546800d3138fae9bc5470fe4ed7646e6be5f68ed60a2d4fe898ee05eb5ee31/Screenshot%202026-03-02%20081209.png?cb=0dcf17ee6e2dee53f84a9346001c714d)

## Source

In diesem Bereich können Sie die Image Source inhaltlich und hinsichtlich der Anzeigeeinstellungen konfigurieren.  
![Screenshot 2026-03-02 081229.png](https://doku.evoviu.de/__attachments/a_68e1f99c4037b7d03003225374fd06738130d8072cd6769a243b743798fb5d8d/Screenshot%202026-03-02%20081229.png?cb=cff1fab86079f56f70f6148bce98d320)

### Path

Wenn Sie auf das Ordner-Symbol klicken, öffnet sich ein Dialog. Dieser zeigt Ihnen alle verfügbaren Ordner an. Sie können an dieser Stelle sogar weitere Ordner erstellen und Dateien hochladen. Wenn Sie sich für einen Ordner entschieden haben, bestätigen Sie den Dialog und Ihre Auswahl wird übernommen.

### Color

An dieser Stelle können Sie zwischen der Bildanzeige im Farb- oder Graustufenmodus wählen.

### Cycle Images

Über den Regler können Sie festlegen, ob der Durchlauf am Ende des Ordner stoppen oder wieder von vorne beginnen soll.

### Include Subfolders

Über diesen Regler können Sie auch Unterordner mit einbeziehen.

### Loading Strategy

An dieser Stelle können Sie entscheiden, ob zu Beginn alle Bilder geladen werden sollen oder jedes Bild beim Aufruf einzeln. Wenn Sie die Bilder mittels Single separat laden, werden die Bilder schneller verarbeitet und angezeigt.

---
version: "8.6.0"
language: "de"
---
# File System

In diesem Kapitel erfahren Sie, wofür Sie das File System nutzen können und welche Funktionen Ihnen geboten werden.

## Einleitung

Im File System können Sie eine beliebige Anzahl von Dateien und Ordnern hinterlegen, solange Sie die auf Ihrer Kamera vorhandene Speicherkapazität nicht überschreiten. Sie können eigene Bildaufnahmen im File System abspeichern oder aber auch mit Beispielbildern Machbarkeitsanalysen durchführen. Inzwischen können Sie sogar Videos in diesem Bereich anschauen.

Auf der linken Seite sehen Sie alle aktuellen Ordner und darunter einzelne Files, die sich nicht in einem Ordner befinden. Auf der rechten Seite sehen Sie die Ordner bzw. die Files in den Ordnern. Wenn noch keine Ordner oder Dateien auf Ihrer Kamera vorhanden sind, werden Sie einen leeren Bildschirm vorfinden. Mit wenigen Klicks können jedoch auch Sie Ihrem File System Leben einhauchen, wie wir Ihnen in den nächsten Schritten zeigen werden.  
![Screenshot 2026-02-23 071044.png](https://doku.evoviu.de/__attachments/a_bfa0bbd123d93095b7a4833bbc4013bf48f0469520a5be7f8f790d39bfb2eca9/Screenshot%202026-02-23%20071044.png?cb=5d4e522bd01aeea19b227e0edb3d91da)

## Speicherbereiche verwalten

Mit der Speicherbereichs-Auswahl können Sie zwischen dem internen Speicher Ihrer evoVIU-Kamera und einem externen Speichermedium (z. B. einer SD-Karte) wechseln. So verwalten Sie Ihre Dateien in getrennten Bereichen und behalten stets den Überblick über die Herkunft Ihrer Daten.

### Auswahl des Speicherbereichs

In der **Top App Bar** finden Sie neben der Bezeichnung **Files** eine Auswahlkomponente, über die Sie zwischen **Int. Storage** (interner Speicher) und **Ext. Storage** (externer Speicher) wechseln können. Die Gestaltung und Interaktionslogik entspricht der Ihnen bereits bekannten Workflow-Auswahl.

Beim Öffnen des File Store ist standardmäßig **Int. Storage** aktiv. Sie sehen ausschließlich die Dateien und Ordner des internen Speichers.  
![DOC_VIU-14832.png](https://doku.evoviu.de/__attachments/a_8f118876315f72c13c75dd6d283ac2f55e1728ad12aef8daa9628157ed654e51/DOC_VIU-14832.png?cb=bbcc7035c69deed0a828f15443f91006)

### Wechsel zwischen Speicherbereichen

Um zwischen den Speicherbereichen zu wechseln, gehen Sie wie folgt vor:

1. Klicken Sie in der **Top App Bar** auf **Ext. Storage** oder **Int. Storage**.

2. Die Ansicht wechselt ohne Neuladen der gesamten Anwendung zum gewählten Speicherbereich.

3. Es werden ausschließlich die Inhalte des ausgewählten Bereichs angezeigt.

**Wichtig:** Eine gemischte Anzeige von internen und externen Dateien ist ausgeschlossen. Der Wechsel erfolgt ohne Layout-Sprünge oder Flackereffekte.

### Füllstandsanzeige

Am unteren Bildschirmrand des File-System-Bereichs (untere linke Ecke) finden Sie eine Füllstandsanzeige. Diese zeigt Ihnen auf einen Blick, wie viel Speicherplatz auf dem aktuell ausgewählten Speichermedium belegt und frei ist. So erkennen Sie frühzeitig drohende Speicherengpässe und können rechtzeitig reagieren.  
![DOC-VIU-17898-pic1.png](https://doku.evoviu.de/__attachments/a_068322974f1478409d9fb29ac8157a735fbc76a30475ead881de60ec25f02afa/DOC-VIU-17898-pic1.png?cb=ba23263333b46bfbafd0dde6ba351ff8)

#### Angezeigte Informationen

Die Füllstandsanzeige enthält folgende Kennzahlen, bezogen auf das aktuell aktive Speichermedium:  

| **Kennzahl** |          **Beschreibung**           | **Beispiel** |
|--------------|-------------------------------------|--------------|
| Used (%)     | Prozentual belegter Speicherplatz   | 32 %         |
| Free (GB)    | Freier Speicher in Gigabyte         | 5.44 GB      |
| Total (GB)   | Gesamtkapazität des Speichermediums | 8.00 GB      |

Die Textdarstellung im Footer-Bereich erfolgt in der Form:
> `{Used GB} of {Total GB} used.`

**Beispiel:** „2.56 GB of 8.00 GB used."

Die Werte sind in sich konsistent: Used (GB) + Free (GB) = Total (GB) (innerhalb einer sinnvollen Rundungstoleranz).

### Ordnerstruktur auf externem Speicher

Die Ordnerstruktur auf dem externen Speichermedium entspricht der Ihnen bekannten Struktur des internen Speichers. Folgende Verzeichnisse sind auf dem externen Speicher vorhanden:  

| **Verzeichnis** |           **Beschreibung**           |
|-----------------|--------------------------------------|
| Store           | Nutzergenerierte Dateien und Ordner  |
| System          | Vom System verwaltete Dateien        |
| Bin             | Gelöschte Dateien zur Nachverfolgung |

Diese konsistente Struktur gewährleistet, dass Sie sich unabhängig vom gewählten Speicherbereich sofort orientieren können.

### Verhalten bei fehlendem externen Speicher

Falls kein externes Speichermedium erkannt wird (z. B. keine SD-Karte eingesteckt), zeigt die Anwendung bei Auswahl von **Ext. Storage** einen Empty-State an:

* **Titel:** „No external storage available"

* **Hinweistext:** „No external storage device was detected. Please connect an external device and reload the view."

In diesem Zustand werden keine Dateien oder Ordner angezeigt. Erst nach dem Einstecken eines Speichermediums und einem manuellen Neuladen der Seite werden die Inhalte sichtbar.

## Befüllen des File Systems

### Navigation

In der Navigation auf der linken Bildschirmseite werden alle vorhandenen Ordner und Dateien aufgelistet. Zusätzlich können Sie dort Ordner erstellen und Dateien hochladen. Falls Sie sich bereits in einem Ordner befinden, können Sie so jederzeit zum Ausgangspukt zurück navigieren.

### Bottom App Bar

Im Tab Files sehen Sie am unteren Bildschirmrand eine Leiste mit einem gelben Button und Plus-Icon. Wenn Sie diesen Button benutzen, öffnet sich ein Dialog in dem Sie eine Datei von Ihrem eigenen System auswählen und hochladen können. Des Weiteren können Sie in der Bottom App Bar noch die Ansicht ändern und zwischen der Grid- und Tabellenansicht wechseln.  
![Screenshot 2026-02-23 071121.png](https://doku.evoviu.de/__attachments/a_cbb3088066478097eeec588aeda5b074756889176d7ef4caa0c741cea2deb8d5/Screenshot%202026-02-23%20071121.png?cb=4dfd51f9364a950b4b15e86484c341df)

## Speichern von Dateien

Sie können Dateien auf unterschiedliche Art und Weise speichern und verwalten. Im nächsten Schritt zeigen wir Ihnen im Detail wie Sie Dateien im File System hinterlegen können.  
![Screenshot 2026-02-23 070029.png](https://doku.evoviu.de/__attachments/a_f0de78da1eb716ee509304e4ff8f861b2f3df985eef74dbc320228dc34b9c21c/Screenshot%202026-02-23%20070029.png?cb=733ee4cc87895d44135afd14489ad133)

### Anlegen von Ordnern

#### Nutzergenerierte Ordner

Wie bereits zuvor erwähnt können Sie über die Navigation selbst Ordner erstellen. Dazu klicken Sie einfach auf das Ordner-Symbol mit dem Plus. Bitte stellen Sie hierbei sicher, dass die Bezeichnung Ihres Ordner einzigartig ist, nur gültige Zeichen verwendet und innerhalb der erlaubten Mindest- bzw. Maximallänge liegt.  
![Screenshot 2026-03-02 082310.png](https://doku.evoviu.de/__attachments/a_eaebe10a7f02bc6c149ad206a2874cb1096fc46ccbe51ef37db3dcf69311c102/Screenshot%202026-03-02%20082310.png?cb=26aa7734ab3e31d74b9ef6d5df2c48f1)

#### Automatisierte Ordner

Ordner für Image Sources werden nicht beim Anlegen der Bildquelle erstellt, sondern erst dann, wenn das erste Bild tatsächlich gespeichert wird. Dieses Verhalten wird als „Just-in-Time-Ordnererstellung" bezeichnet und hält Ihr Dateisystem schlank, indem ausschließlich genutzte Verzeichnisse existieren.

##### Funktionsweise

Wenn Sie eine neue Image Source erstellen, geschieht im File System zunächst nichts. Erst beim ersten erfolgreichen Speichern eines Bildes prüft das System automatisch, ob der zugehörige Zielordner auf dem konfigurierten Speichermedium existiert:

* **Ordner nicht vorhanden:** Das System erstellt den Ordner automatisch und speichert das Bild darin ab.

* **Ordner bereits vorhanden:** Das System verwendet den bestehenden Ordner weiter. Es wird kein neuer Ordner angelegt.

Dieses Verhalten gilt gleichermaßen für **Int. Storage** und **Ext. Storage**.  
![Screenshot 2026-02-23 070122.png](https://doku.evoviu.de/__attachments/a_d2b18ecb72a52c4752e3063913916cfd80dd358bfd4b47c8cf1d25886949451d/Screenshot%202026-02-23%20070122.png?cb=a175661093a8c06bc95a99f12ffa2d67)

##### Verhalten bei Speicherort-Wechsel

Wenn Sie den konfigurierten Speicherort einer bestehenden Image Source nachträglich ändern (z. B. von **Int. Storage** auf **Ext. Storage** oder umgekehrt), wird auf dem neuen Speichermedium **kein Ordner vorab** erstellt. Die Just-in-Time-Logik greift auch hier:

1. Sie ändern den Speicherort der Image Source in den Einstellungen.

2. Beim nächsten Speichern eines Bildes prüft das System, ob der Zielordner auf dem neuen Medium existiert.

3. Falls nicht vorhanden, wird der Ordner automatisch erstellt und das Bild darin abgelegt.

4. Falls bereits vorhanden, wird der existierende Ordner wiederverwendet.

**Wichtig:** Bestehende Ordner auf dem vorherigen Speichermedium bleiben erhalten und werden nicht automatisch gelöscht oder verschoben.

##### Ordnerkennzeichnung in der Navigation

Dort, wo in der Navigation die verfügbaren Ordner aufgelistet werden, finden Sie neben der Ordner-Bezeichnung eine Beschreibung. Der Hinweis „Directory from image source" kennzeichnet alle Ordner, die durch eine Image Source erstellt wurden -- unabhängig davon, ob die Erstellung sofort oder just-in-time erfolgte.

##### Fehlerverhalten

Falls beim automatischen Erstellen des Ordners ein Fehler auftritt, wird das Bild nicht gespeichert. Mögliche Ursachen sind:  

|                        **Fehlersituation**                        |                      **Verhalten**                      |
|-------------------------------------------------------------------|---------------------------------------------------------|
| Externes Speichermedium nicht verfügbar (z. B. SD-Karte entfernt) | Fehlermeldung wird angezeigt; kein Ordner wird erstellt |
| Fehlende Schreibberechtigung auf dem Speichermedium               | Fehlermeldung wird angezeigt; kein Ordner wird erstellt |
| Speichermedium voll                                               | Fehlermeldung wird angezeigt; kein Ordner wird erstellt |

In allen Fällen erhalten Sie eine Fehlermeldung über die Anwendung. Ihre bestehenden Daten und Ordner bleiben unberührt.

### Upload von Dateien

Das Hochladen von Dateien im File System ist wie bereits erwähnt über die Bottom App Bar oder das Menü in der Navigation möglich. Zusätzlich können Sie per Drag \& Drop im Tab Files Dateien ablegen. Diese Funktion ist sowohl allgemein als auch in einem von Ihnen selektierten Ordner möglich.  
![Screenshot 2026-02-23 070441.png](https://doku.evoviu.de/__attachments/a_f98cb0c05e9292180c9d9fd95f3ae5fc0094c87726789d96b67fd74b27079cb9/Screenshot%202026-02-23%20070441.png?cb=cb6463889b51e66234050771eb1dab80)

## Funktionen innerhalb des Dateisystems

### Verwaltung von Ordnern

Um Ordner verwalten zu können, müssen Sie vorab einen Ordner auswählen. Anschließend erscheint in der Navigation innerhalb der unteren Leiste rechts ein Icon mit drei vertikal ausgerichteten Punkten. Dahinter verbirgt sich das Menü des Ordners. Über dieses Menü können Sie die Bezeichnung Ihres Ordners anpassen, den Inhalt des Ordners herunterladen oder den Ordner entfernen.  
![Screenshot 2026-02-23 070524.png](https://doku.evoviu.de/__attachments/a_59edb7ba0d9d4f81d090440159311fc1280447a1b0dde109b275e8c0d6c7d103/Screenshot%202026-02-23%20070524.png?cb=64e2c07eee71757a7119509fde7ce32a)

### Verwaltung von Dateien

Sobald Sie eine Datei hochgeladen haben, wird diese im Tab Files angezeigt. Über das Menü mit den drei vertikal angeordneten Punkten können Sie sich um die Verwaltung der Dateien kümmern. Sie haben die Möglichkeit den Dateinamen zu bearbeiten, die Datei zu entfernen, sie herunterzuladen oder im Vorschaumodus zu betrachten.  
![Screenshot 2026-03-02 082355.png](https://doku.evoviu.de/__attachments/a_9ffdf56bea6bdbe27edec137e7b962ac12bc445c1ae13c8f07a0f99f28bd0474/Screenshot%202026-03-02%20082355.png?cb=e621cae2531d4509d0fd6003c350570b)

### Vorschaumodus

Für Bild- und Videodateien existiert aktuell zusätzlich ein Vorschaumodus. Hier wird das Bild groß dargestellt. Des Weiteren können Sie auch hierüber die Datei herunterladen oder entfernen. Wenn Sie das Bild über die Image Source aufgenommen haben, können Sie am rechten Bildschirmrand zusätzlich noch die Einstellungen während der Bildaufnahme nachvollziehen.  
![Screenshot 2025-09-25 131720-20250925-111724.png](https://doku.evoviu.de/__attachments/a_edd5616aa8fbcc31ae92385fef523bff9dc7be9e7a44c95768129aa317bb4875/Screenshot%202025-09-25%20131720-20250925-111724.png?cb=b0b64de37fe9e32cb8e88abf3cacec19)

### Favoriten-Markierung von Dateien

Mit der Favoriten-Funktion können Sie wichtige Dateien im File System markieren, um diese schneller wiederzufinden. Ein gelb ausgefüllter Stern signalisiert Ihnen auf einen Blick, welche Dateien Sie als Favoriten gespeichert haben. Um Dateien als Favorit markieren zu können, müssen Sie als Editor aktiv sein. Falls Sie nicht die notwendigen Schreibberechtigungen besitzen, ist die Funktion deaktiviert und die Schaltfläche ausgegraut.  
![Screenshot 2026-06-18 111501.png](https://doku.evoviu.de/__attachments/a_b124e480a4af42da39c2f147accc1aa40d7307853e71053fceee7469b0b940e6/Screenshot%202026-06-18%20111501.png?cb=6cd8ca6bd4f4acd19aab70c1b6fd6f87)

**Schritt-für-Schritt Anleitung:**

1. Navigieren Sie im Hauptmenü zum Bereich **Files**.

2. Wählen Sie ggf. einen Ordner aus, um die darin enthaltenen Dateien in der Kachelansicht anzuzeigen.

3. In jeder Datei-Kachel befinden sich im oberen Bereich zwei kreisförmige Schaltflächen:

   * **Oben links:** Die Favoriten-Schaltfläche (Stern-Icon).

   * **Oben rechts:** Das Menü für weitere Aktionen (Drei-Punkte-Icon).

4. Klicken Sie auf den **Stern oben links**, um die Datei als Favorit zu markieren.

   * **Visuelles Feedback:** Der Stern wird **gelb ausgefüllt** innerhalb des dunklen Kreises dargestellt.

   * **Bestätigung:** Am unteren Bildschirmrand erscheint kurzzeitig eine Bestätigungsmeldung (Snackbar) mit dem Text: „Successfully marked as favorite."

5. Um eine Markierung wieder zu entfernen, klicken Sie erneut auf den gelben Stern. Das Symbol wechselt daraufhin wieder zur Ansicht eines nicht ausgefüllten Stern-Umrisses.

## Verwendung der Dateien

Wenn Sie an einer anderen Stelle der Anwendung auf die Dateien zugreifen möchten, können Sie an entsprechenden Stellen auf das Ordner-Symbol klicken. Sie finden dieses Symbol beispielsweise im Workflow, wenn Sie eine **File Image Source**-Komponente konfigurieren oder eine Annotation bearbeiten möchten.  
![Screenshot 2025-05-26 161922.png](https://doku.evoviu.de/__attachments/a_1754dac8d0c7247acec5f95011f288bc71627f8e8602d2785dfc9c452da3dd94/Screenshot%202025-05-26%20161922.png?cb=f61e5e9944995f7efd81b3beda8f533c)

### Speicherauswahl im File Picker

Beim Öffnen des File Picker Dialogs können Sie über einen Segmented Button am oberen Rand des Fensters festlegen, aus welchem Speicherbereich Sie Dateien laden möchten.  
![DOC_VIU-14833_pic1.png](https://doku.evoviu.de/__attachments/a_3f5b04d3402a65699324612c2eba2297bbf88656fd929d9eb6c39aba7f134974/DOC_VIU-14833_pic1.png?cb=fa099a3a9de6d0b59813aac52804e5a7)
*File Picker Dialog mit Auswahl des internen Speichers*

Folgende Optionen stehen zur Verfügung:

* **Internal:** Zeigt alle Ordner und Dateien des internen Speichers an (Standardeinstellung beim Öffnen).

* **External:** Zeigt die Inhalte eines angeschlossenen externen Speichermediums (z. B. SD-Karte).

![DOC_VIU-14833_pic2.png](https://doku.evoviu.de/__attachments/a_ea8f993117abc35465ac5b6304680e828a7db53128372924adaada054dfaf584/DOC_VIU-14833_pic2.png?cb=11bb4d1d456823acbe94c5ae670d0ade)
*File Picker Dialog mit Auswahl des externen Speichers*

Um den Speicherbereich zu wechseln, klicken Sie einfach auf die entsprechende Schaltfläche im Segmented Button. Die Dateiliste wird sofort aktualisiert und zeigt ausschließlich die Inhalte des gewählten Mediums an.  
Die Option External ist nur dann anwählbar, wenn das System ein gültiges externen Speichermedium erkannt hat. Ist kein Medium angeschlossen, wird die Schaltfläche ausgegraut (disabled) dargestellt.

Sie können zur Auswahl eines Ordners auch die Suchfunktion im Dialog nutzen. Sobald Sie in einen Ordner hinein navigieren, setzt sich die Eingabe in der Suchfunktion automatisch zurück, um die Anzeige der darin vorhandenen Dateien zu gewährleisten.

## Scan Files

### Versteckte Dateien / System

Falls Sie nicht alle Ordner und Dateien über die Web-Anwendung auf dem Kamerasystem abgelegt haben, dann können Sie über den Tab System weiteren Dateien Ihrem File System hinzufügen. Nutzen Sie zunächst den "Start Scanning"-Button in der unteren Leiste um nach versteckten Dateien zu suchen. Sobald Ordner oder Dateien entdeckt wurden, können Sie diese auswählen und über die Buttons in der Leiste am unteren Bildschirmrand entweder dem File System hinzufügen oder vom Kamerasystem entfernen.  
![Screenshot 2026-02-23 070910.png](https://doku.evoviu.de/__attachments/a_b2060bf60bde4ce36855f51e0419b2544372b6ae46a40e5274bc425bf171e413/Screenshot%202026-02-23%20070910.png?cb=70d714db230f4c7f5931982b8f58b1b4)

### Gelöschte Dateien / Bin

Falls Sie Ordner oder Dateien über die Web-Anwendung erstellt, aber über das Kamerasystem gelöscht haben, dann können Sie über den Tab Bin die entfernten Ordner oder Dateien nachvollziehen. Nutzen Sie für die Detektion von gelöschten Dateien ebenfalls den "Start Scanning"-Button in der unteren Leiste des Tabs.  
![Screenshot 2026-02-23 070931.png](https://doku.evoviu.de/__attachments/a_25567b2a061a477356624ccf606e60cdb1a8504f7ee97e53a0af2fee8bfc1195/Screenshot%202026-02-23%20070931.png?cb=5dc608dafd50e884613a2a04285bd133)

---
version: "8.6.0"
language: "de"
---
# Filter

## Arithmetic

**Arithmetische Algorithmen** verändern Bilder durch mathematische Operationen auf den Pixelwerten. Sie dienen nicht der Glättung, sondern der Anpassung von Kontrast, Helligkeit oder Schärfe:

* **Deviation** hebt Abweichungen hervor und macht Unterschiede im Bild sichtbar.

* **Emphasize** verstärkt bestimmte Bildbereiche oder Merkmale.

* **Sharpening** betont Kanten und Details für ein schärferes Erscheinungsbild.

* **Gamma Correction** korrigiert Helligkeit und Kontrast in Abhängigkeit der Bilddarstellung (z. B. Monitoranpassung).

* **Subtract** hebt Unterschiede zwischen zwei Bildern oder Versionen hervor.

* **Pow (Potenztransformation)** verändert die Helligkeitsverteilung gezielt, um dunkle oder helle Bereiche zu betonen.

Diese Verfahren eignen sich, je nach Vorhaben, zur **Bildverbesserung, Analyse** und **Anpassung**.

### Deviation

Ermittelt Abweichungen vom Sollwert im Bild -- hebt Bereiche hervor, die vom erwarteten Muster abweichen.

#### Flow

![image-20250903-055040.png](https://doku.evoviu.de/__attachments/a_2360584a26a3d53e63bc5d905a0690e325159d3780b12aa4a42fe9af691134de/image-20250903-055040.png?cb=9eebeac6a87f7f65cac611efa1a8793c)  
Damit Ergebnisse möglich sind, muss das Farbbild zwingend in ein Graustufenbild umgewandelt werden. Dazu kann der Knoten "To Grayscale (Image)" verwendt werden.

#### Parameterset

|    **Parameter**    | **Typ** |                                                                                            **Beschreibung**                                                                                            | **Wertebereich** |                                                                                            **Effekt Min**                                                                                             |                                                                                              **Effekt Max**                                                                                              |
|---------------------|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image               | Image   | Ein Graustufenbild ist erforderlich. Sie können den Knoten "To Grayscale (Image)" verwenden.                                                                                                           |                  | ![image-20250903-055420.png](https://doku.evoviu.de/__attachments/a_900c863c546c58a73ef24996a427681f18feda5153a1f78a37217101dff23f9b/image-20250903-055420.png?cb=de0043e07c56f512bfc684bc4c98e0ee)                         | ![image-20250903-055441.png](https://doku.evoviu.de/__attachments/a_b8f45534639d307548d9b67fce5d4b275c5058e7634cf9cd63226a0739faa78a/image-20250903-055441.png?cb=1d44b5f0264318417c4d133fa6d89152)                            |
| Mask Width (Pixel)  | Int32   | Legen Sie die Breite der für die Abweichungsberechnung verwendeten Maske fest. Größere Werte decken einen größeren Bereich ab, was bei der Erkennung größerer oder signifikanterer Abweichungen hilft. |                  | Width: 5px Height: 5px ![image-20250903-055550.png](https://doku.evoviu.de/__attachments/a_26f21fc348802abfaefcca53bd8e7d35bc3ae63ea66787cf180217b2dc1c01a7/image-20250903-055550.png?cb=89245e505ef333bd90c59f143a25d5c3)  | Width: 200px Height: 200px ![image-20250903-055627.png](https://doku.evoviu.de/__attachments/a_db2f97aa8bbb182b3a9dea501a19b0b3d83752c167f65d5b4640a922dfbbffb5/image-20250903-055627.png?cb=b7af1843a6ae3b442b1bfb0a46cf9ac6) |
| Mask Height (Pixel) | Int32   | Legen Sie die Höhe der für die Abweichungsberechnung verwendeten Maske fest. Größere Werte decken einen größeren Bereich ab, was bei der Erkennung größerer oder signifikanterer Abweichungen hilft.   |                  | Width: 10px Height: 2px ![image-20250903-055816.png](https://doku.evoviu.de/__attachments/a_904334b74c14de93722cd477aeefa7fd18e67ff7ad6341722620c6e66b903525/image-20250903-055816.png?cb=9580543c3425ec85ea7300bbc0c968d8) | Width: 2px Height: 10px ![image-20250903-055900.png](https://doku.evoviu.de/__attachments/a_7c4a94ac0dae4edc7f097b9823fd97f560a7d8f10a810d338ce4eccf86a7c079/image-20250903-055900.png?cb=62a55184b81d65cb41f346e3b9727b57)    |
| Return              | Region  | Ein binäres Bild in Schwarz-Weiß, in dem Abweichungen vom erwarteten Muster hervorgehoben werden. Dies ist nützlich, um Anomalien oder Unstimmigkeiten im Bild zu erkennen.                            |                  |                                                                                                                                                                                                       |                                                                                                                                                                                                          |

### Emphasize

Passt Kontrast und Helligkeit eines Bildes an -- verbessert Darstellung und Sichtbarkeit von Details.

#### Flow

![image-20250903-084047.png](https://doku.evoviu.de/__attachments/a_5b596caf99cd7ef6c988183ee82a647a58f37f94893e278181af0ec8a5c17f75/image-20250903-084047.png?cb=c993d15d41dceec8766a0d2b18bc8781)

#### Parameterset

| **Parameter** |    **Typ**    |                                                                                             **Beschreibung**                                                                                              | **Wertebereich** |                                                                                **Effekt Min**                                                                                 |                                                                                **Effekt Max**                                                                                 |
|---------------|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image → Input | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. |                  |                                                                                                                                                                               |                                                                                                                                                                               |
| Contrast      | Single        | Anpassungsfaktor zur Verstärkung oder Verringerung des Bildkontrasts. Ein höherer Wert hebt die Unterschiede zwischen hellen und dunklen Bereichen hervor.                                                | \> 0.01          | ![image-20250903-083437.png](https://doku.evoviu.de/__attachments/a_60ae015e6c77e85c3baf0ebeedcf6343889a9337b6a1fc0a952d8f1268f8798b/image-20250903-083437.png?cb=f658037d6f3c92821683404c8cda7ba2) | ![image-20250903-083416.png](https://doku.evoviu.de/__attachments/a_df353858d526a2f2bd4577751fd1bd315dc25caf55bbb426f1d7e7c51c90a8b0/image-20250903-083416.png?cb=f32bf4fc4267120dbfb33fce8330dc77) |
| Brightness    | Int32         | Höhere Werte erhöhen die Gesamthelligkeit und machen das Bild heller.                                                                                                                                     | \>= 0            | ![image-20250903-083933.png](https://doku.evoviu.de/__attachments/a_1012c3212bc584594e504002cab07492cdb071b2ef3e95251870c1733f725221/image-20250903-083933.png?cb=7cee57108b6aba5fa6f0166409402e48) | ![image-20250903-084013.png](https://doku.evoviu.de/__attachments/a_eb6ef86831f118dab0f86a549aa7aaad9e94c519d4a8358680ae4fa21f908362/image-20250903-084013.png?cb=7f2a1a47d0ed6a962e444d0c6fd05489) |

### Sharpening

Schärft ein Bild durch Erhöhung des Kontrasts zwischen benachbarten Pixeln -- verbessert Details und Klarheit.

#### Flow

![image-20250903-084554.png](https://doku.evoviu.de/__attachments/a_28db2a5b342222744d385bdb7a8405aae6f1f4c15a825bed0daa7ab0aaa5e264/image-20250903-084554.png?cb=8c03976827fc897a7dbcb8943f448092)

#### Parameterset

| **Parameter** |    **Typ**     |                                                                                             **Beschreibung**                                                                                              |                                                                               **Effekt - Mono**                                                                               |                                                                             **Effekt - Farbbild**                                                                             |
|---------------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image → Input  | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. | ![image-20250903-085003.png](https://doku.evoviu.de/__attachments/a_f1cd9fa8a3ca4bf12bfb268d0e1ceaf3c0b05d9ba198287952f23117327098b1/image-20250903-085003.png?cb=59fd61cf761d5cb513f3d456feec2ccd) | ![image-20250903-084500.png](https://doku.evoviu.de/__attachments/a_d0d362cfac43e9c589c5913d0b824ba9b487c1403d37ec19d5a1bbd4e11f9825/image-20250903-084500.png?cb=d2410637632a7f6c0515668c5096c4c4) |
| Image         | Image → Output | Transformiertes Bild mit verbesserter Schärfe.                                                                                                                                                            | ![image-20250903-085228.png](https://doku.evoviu.de/__attachments/a_b899289c1055434cc6d34ed677265177e7c51e282b8d9b1540d2c5f51fcd4576/image-20250903-085228.png?cb=472d72877fd08b4844d79ecd9f8f9648) | ![image-20250903-084526.png](https://doku.evoviu.de/__attachments/a_68d2d71e7974ba9e800b4ea3d3070df425d06473c6af79075d64bc707ca504dd/image-20250903-084526.png?cb=eba711df9de899c7661ad9d2392d7757) |

### Gamma Correction

Passt den Gammawert des Bildes an -- steuert Helligkeit und Kontrast für eine optimierte Darstellung.

#### Flow

![image-20250903-084731.png](https://doku.evoviu.de/__attachments/a_df4fe94ae67f1c280bb2bc5856d5dbb1d1509f9a900d777790071f68b0000204/image-20250903-084731.png?cb=30b246ea538a9bdb7567b38cd56f4fa3)

#### Parameterset

| **Parameter** |    **Typ**     |                                                                                             **Beschreibung**                                                                                              |                                                                               **Effekt - Mono**                                                                               |                                                                             **Effekt - Farbbild**                                                                             |
|---------------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image → Input  | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. | ![image-20250903-085003.png](https://doku.evoviu.de/__attachments/a_f1cd9fa8a3ca4bf12bfb268d0e1ceaf3c0b05d9ba198287952f23117327098b1/image-20250903-085003.png?cb=59fd61cf761d5cb513f3d456feec2ccd) | ![image-20250903-084500.png](https://doku.evoviu.de/__attachments/a_d0d362cfac43e9c589c5913d0b824ba9b487c1403d37ec19d5a1bbd4e11f9825/image-20250903-084500.png?cb=d2410637632a7f6c0515668c5096c4c4) |
| Image         | Image → Output | Höhere Werte erhöhen die Gammakorrektur. Dadurch werden dunkle Pixel hervorgehoben und helle Bereiche abgeschwächt, was eine bessere Segmentierung in dunkleren Bildbereichen ermöglicht.                 | ![image-20250903-085031.png](https://doku.evoviu.de/__attachments/a_d4e4bd26acee4fe653213eb58bc7d7df6230765914eb748585cb97d76ab65939/image-20250903-085031.png?cb=a1f6af00bcaaf94f6052e6748ac74780) | ![image-20250903-084802.png](https://doku.evoviu.de/__attachments/a_a2574caaa0ee611ea716546318515d6f43d43062e6e4b636d0c322101d7f7ab7/image-20250903-084802.png?cb=fde14e603ff39de1df94f75b382145e3) |

### Substract

Subtrahiert Pixelwerte eines Bildes von einem anderen -- hebt Unterschiede zwischen beiden Bildern hervor.

#### Flow

![image-20250903-091020.png](https://doku.evoviu.de/__attachments/a_84dbf49ade7e3c5c006d0ec6056ed8fa2f305b57619f3e9108296d0fb6a246b3/image-20250903-091020.png?cb=e3cd8428e907ebe2236c9852da8d2aeb)

#### Parameterset

| **Parameter** | **Typ** |                                                              **Beschreibung**                                                              |                                                                               **Effekt - Mono**                                                                               |                                                                               **Effekt Farbe**                                                                                |
|---------------|---------|--------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image 1       | Image   | Das erste Bild, von dem die Pixelwerte subtrahiert werden                                                                                  | ![image-20250903-090852.png](https://doku.evoviu.de/__attachments/a_f4b7e2a8900e147a612ce6a0c3bc399f5b0cc62acad0e42a4a1f4ab113de131e/image-20250903-090852.png?cb=e17f10ad318e88dd979cc842a1ee0be2) | ![image-20250903-090740.png](https://doku.evoviu.de/__attachments/a_f20f7dbe7353a788473f2ad2d4c778ecc20d9f16975dd9c682258ab6bccafb23/image-20250903-090740.png?cb=77b05f6039512ae8be40efa0f9deacc5) |
| Image 2       | Image   | Das zweite Bild, das vom ersten Bild subtrahiert wird.                                                                                     | ![image-20250903-090904.png](https://doku.evoviu.de/__attachments/a_372ce4aa878d0fdcdc2e31fdfa465923cffa0207b3c961e7d749d54de6d5b1e0/image-20250903-090904.png?cb=56e2ded466a1ba5aff24877446d0aba4) | ![image-20250903-090751.png](https://doku.evoviu.de/__attachments/a_4e76c50080c454609aa19385f5d617b5422fd0c03de12dcb5f4246ea98112581/image-20250903-090751.png?cb=f5c31115b785a4637af2384aa9896e42) |
| Return        | Image   | Ein neues Bild, welches das Ergebnis der pixelweisen Subtraktion zeigt und die Unterschiede zwischen den beiden Eingabebildern hervorhebt. | ![image-20250903-090919.png](https://doku.evoviu.de/__attachments/a_68d2d8bb6ed44dbff542cb9748ff03762816f584fb9b8030b7bbe2a279f82eae/image-20250903-090919.png?cb=3c1035485b38ce812283a4f780155b16) | ![image-20250903-090804.png](https://doku.evoviu.de/__attachments/a_14efb13a58318d7b70d3b07955a4252fdf44f4840b669dd41071cebd9fb93917/image-20250903-090804.png?cb=8232ddada2a7dd6b2d93e5774d6c6223) |

### Pow

Hebt Pixelwerte auf eine Potenz -- erhöht oder verringert Helligkeit zur Kontraststeigerung oder Detailbetonung.

#### Flow

![image-20250903-091252.png](https://doku.evoviu.de/__attachments/a_8d9528856bee896af4a47e1581d489b78a00825110389644c3772f345e5faf17/image-20250903-091252.png?cb=d3de709b9193655a406f852b09c8a8f9)

#### Parameterset

| **Parameter** |      **Typ**      |                                                                                             **Beschreibung**                                                                                              |                                                                               **Effekt - Mono**                                                                               |                                                                             **Effekt - Farbbild**                                                                             |
|---------------|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image → Input     | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. | ![image-20250903-090852.png](https://doku.evoviu.de/__attachments/a_f4b7e2a8900e147a612ce6a0c3bc399f5b0cc62acad0e42a4a1f4ab113de131e/image-20250903-090852.png?cb=e17f10ad318e88dd979cc842a1ee0be2) | ![image-20250903-090740.png](https://doku.evoviu.de/__attachments/a_f20f7dbe7353a788473f2ad2d4c778ecc20d9f16975dd9c682258ab6bccafb23/image-20250903-090740.png?cb=77b05f6039512ae8be40efa0f9deacc5) |
| Power         | Single Beispiel 1 | Der Exponent, mit dem jeder Pixelwert erhöht wird - Beispiel mit Power = 1.1                                                                                                                              | ![image-20250903-091711.png](https://doku.evoviu.de/__attachments/a_6e67829c64e4defaab98f4f36778915105871deffc51420c9911607e68a0013b/image-20250903-091711.png?cb=a9329a575ef3b7ba7e1d3835bd139756) | ![image-20250903-091527.png](https://doku.evoviu.de/__attachments/a_1b599954b7c35e0da32c7953809a6f78c8b9c82726e7febf310f7623d3ccbba3/image-20250903-091527.png?cb=ccaf70d72e9a6d8f62dba07d8fcc5060) |
| Power         | Single Beispiel 2 | Beispiel mit Power = 1.5                                                                                                                                                                                  | ![image-20250903-091736.png](https://doku.evoviu.de/__attachments/a_e10a70c669cbe0fcf0712125792691c08229e3a0db5a5c2d56d4b09a4bfcd51c/image-20250903-091736.png?cb=19013cba98dc4ee83c29f7e5fb567ff2) | ![image-20250903-091602.png](https://doku.evoviu.de/__attachments/a_a529e6f61e6b10d3954f664f18a84f1afcb6a8b37af52fb71c846c9ffa0c4189/image-20250903-091602.png?cb=067da5d52b2595c0d4e7483b2d6b136a) |
| Return        | Image             | Siehe Bilder von Power Beispiel 1 und 2                                                                                                                                                                   |                                                                                                                                                                               |                                                                                                                                                                               |

## Smoothing

**Glättungsalgorithmen (Smoothing)** werden eingesetzt, um Rauschen in Bildern zu reduzieren und Flächen gleichmäßiger erscheinen zu lassen. Je nach Verfahren unterscheiden sie sich darin, wie stark Details oder Kanten erhalten bleiben:

* Der **Average-Filter** berechnet den Mittelwert der Nachbarschaft und erzeugt eine einfache Weichzeichnung

* Der **Bilateral-Filter** kombiniert räumliche Nähe und Farbähnlichkeit und glättet Flächen, während Kanten erhalten bleiben

* Der **Gauss-Filter** gewichtet nahe Pixel stärker und sorgt für eine sanfte, gleichmäßige Glättung

* Der **Median-Filter** ersetzt jeden Pixel durch den Median der Umgebung und entfernt besonders effektiv punktförmiges Rauschen

### Average

Wendet einen Mittelwertfilter an -- glättet das Bild und reduziert Bildrauschen bzw. körnige Strukturen.  
Bitte nur positive und Ungerade Parameter verwenden: 1,3,5,7 ...

#### Flow

![image-20250903-093212.png](https://doku.evoviu.de/__attachments/a_28adbf548fa510f45ae1417dad2301d8a69c583e4b59b7a32b7335ab34e2790b/image-20250903-093212.png?cb=6d797daa7e7bcad9f43da61dfa9d3501)

#### Parameterset

|     **Parameter**     |    **Typ**    |                                                                                             **Beschreibung**                                                                                              |                                                                                           **Effekt - Min**                                                                                           |                                                                                           **Effekt - Max**                                                                                           |
|-----------------------|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image                 | Image → Input | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. | ![image-20250903-084500.png](https://doku.evoviu.de/__attachments/a_d0d362cfac43e9c589c5913d0b824ba9b487c1403d37ec19d5a1bbd4e11f9825/image-20250903-084500.png?cb=d2410637632a7f6c0515668c5096c4c4)                        | ![image-20250903-085003.png](https://doku.evoviu.de/__attachments/a_f1cd9fa8a3ca4bf12bfb268d0e1ceaf3c0b05d9ba198287952f23117327098b1/image-20250903-085003.png?cb=59fd61cf761d5cb513f3d456feec2ccd)                        |
| Kernel Width (Pixel)  | Int32         | Breite, der für die Mittelwertbildung verwendeten Nachbarschaft. Höhere Werte erhöhen die Glättung, können aber Details verwischen. Der Wert muss positiv und ungerade sein.                              | ![image-20250903-093742.png](https://doku.evoviu.de/__attachments/a_c6e2d2d71adc3fb75ef0311a1e1dbb6c9d62f56b5a5dfc9c5aecba54c85148c9/image-20250903-093742.png?cb=3123aa4279837548eeeb3d27292ef841) Width: 3px Heigth: 3px | ![image-20250903-094030.png](https://doku.evoviu.de/__attachments/a_42b7aa3b5f6c68530ffd2d34d33d8d92c6faa9b32f313460ea196e46aed914dd/image-20250903-094030.png?cb=49b70f00e72fb49310ef967529a69993) Width: 9px Heigth: 3px |
| Kernel Height (Pixel) | Int32         | Höhe, der für die Mittelwertbildung verwendeten Nachbarschaft. Höhere Werte erhöhen die Glättung, können aber Details verwischen. Der Wert muss positiv und ungerade sein.                                | ![image-20250903-094131.png](https://doku.evoviu.de/__attachments/a_2646e654a776c82faf5d20519a31a6f1b0d23b110a5907038623ee2288702154/image-20250903-094131.png?cb=0d26a057e309e4fb169da67a882c8504) Width: 3px Heigth: 9px | ![image-20250903-093823.png](https://doku.evoviu.de/__attachments/a_f2356108c4aa51e99cb7675cef105e76d628a8f80b0f0ad974f395377c4f5126/image-20250903-093823.png?cb=8cc9c97687e4aa863f7461e5b77f2965) Width: 9px Heigth: 9px |

### Bilateral

Die bilaterale Glättung ist ein Filter zur Rauschreduzierung, der Flächen glättet und gleichzeitig Kanten erhält. Im Unterschied zu einfachen Weichzeichnern berücksichtigt er sowohl den Abstand der Pixel zueinander als auch deren Farbähnlichkeit.

#### Flow

![Screenshot 2026-02-25 092943.png](https://doku.evoviu.de/__attachments/a_aee07bdf1c0664d24ce0f8852c7bf6ad30f8fb980f9bba8f15681741227bcbe5/Screenshot%202026-02-25%20092943.png?cb=4ed10d8d343f942ff67df42576620628)

#### Parameterset

| **Parameter** | **Typ** |                                                                                                                                                                                                                                        **Beschreibung**                                                                                                                                                                                                                                        | **Wertebereich** |                                                                                                        **Effekt Min**                                                                                                        |                                                                                                          **Effekt Max**                                                                                                           |
|---------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image   | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden.                                                                                                                                                                                                                                                                                      |                  | ![image-20250901-091538.png](https://doku.evoviu.de/__attachments/a_bc79464ca8cb5419141f2d91f720bd4acd788f6157525d3751a65caa4f992b31/image-20250901-091538.png?cb=451c03fdee6262a19b91f96b8e2138bf)                                                | ![image-20250901-091643.png](https://doku.evoviu.de/__attachments/a_e1f68686e89ace63e68a61b74738a6cfd25004105d09540662ea027108835dc8/image-20250901-091643.png?cb=dc860d4505e17052161f774ef9067862)                                                     |
| Diameter      | Int32   | Durchmesser jeder Pixel-Nachbarschaft, die beim Filtern verwendet wird. Bei höheren Werten wird die Glättung verstärkt. **Diameter** bestimmt die Größe des berücksichtigten Bereichs: * ein kleiner Wert wirkt nur lokal * ein großer Wert glättet großflächiger und ist rechenintensiver Nutzen Sie den Parameter SigmaSpace, wenn der Durchmesser dem Wert 0 entspricht.                                                                                                                    | \>0              | ![image-20250903-200716.png](https://doku.evoviu.de/__attachments/a_db0b836385edf8cd08c81f345dbad8a5a52226b33b80049a88337de50fae2446/image-20250903-200716.png?cb=3868a1a78a5dac35fa4b4626539dced5) Diameter:5 SigmaColor 75 SigmaSpace 125 t=95ms | ![image-20250903-200824.png](https://doku.evoviu.de/__attachments/a_f872b2ac8a6f7eb2644eb36e272bfe29d068ac626948e7fc9f491769b1db3049/image-20250903-200824.png?cb=2ec44ad510ccbdb822ef9f26de087b7e) Diameter:25 SigmaColor 75 SigmaSpace 125 t=485Minms |
| Sigma Color   | Int32   | Standardabweichung des Farbraums, die sich darauf auswirkt, wie stark der Filter Intensitätsunterschiede zwischen den Pixeln berücksichtigt. Höhere Werte erhöhen die allgemeine Glättung. **SigmaColor** steuert die Empfindlichkeit gegenüber Farbunterschieden: * bei kleinen Werten werden nur sehr ähnliche Farben gemittelt (Kanten bleiben scharf) * bei großen Werten werden auch unterschiedliche Farben deutlich (stärkere Weichzeichnung)                                           | 0 - 254          | ![image-20250903-200940.png](https://doku.evoviu.de/__attachments/a_59c349d1ac2cb9c3a52a4fc1221e0265be49384b7ff575b59009b7853568345a/image-20250903-200940.png?cb=cd71614d834a6b80d2701f101388a13f) Diameter:5 SigmaColor: 25 SigmaSpace: 125      | ![image-20250903-201002.png](https://doku.evoviu.de/__attachments/a_f9c04b865422989ccc992f38b524235df506e9f2b6d992566d5488fc1db5007f/image-20250903-201002.png?cb=ff5b1263f9161f236cda1535db9bb22d) Diameter:5 SigmaColor: 125 SigmaSpace: 125          |
| Sigma Space   | Single  | Standardabweichung des räumlichen Abstands, die sich darauf auswirkt, wie stark der Filter die Nähe der Pixel berücksichtigt. Bei höheren Werten können weiter entfernte Pixel die Glättung beeinflussen. SigmaSpace legt fest, wie stark der räumliche Abstand zählt: * kleine Werte begrenzen die Wirkung auf nahe Pixel * große Werte beziehen auch weiter entfernte Pixel ein und verstärken die Glättung Nutzen Sie den Parameter SigmaSpace, wenn der Durchmesser dem Wert 0 entspricht. | 0.254            | ![image-20250903-201057.png](https://doku.evoviu.de/__attachments/a_2f3e810962478392358b6fac673d4a8dfb264a266a1eadc8e5a34373f42a68e2/image-20250903-201057.png?cb=39d5e172dd72c4a494efa5b9d7de579a) Diameter:5 SigmaColor: 75 SigmaSpace: 25       | ![image-20250903-201121.png](https://doku.evoviu.de/__attachments/a_f1c9e5c2fc218bfb10824c0f5382afef47997cc0974fc9e566f60a4581cdcaf6/image-20250903-201121.png?cb=77adbe7cb70fd7fb415235a83bbe47f2) Diameter:5 SigmaColor: 75 SigmaSpace: 200           |

### Gauss

Wendet einen Gauss-Filter auf ein Bild an und glättet es durch Mittelwertbildung der Pixelwerte innerhalb einer bestimmten Gauss-Kernelgröße.

Der **Gauss-Filter** eignet sich für eine gleichmäßige Weichzeichnung und zur Reduktion von feinem Rauschen. Er wird vor allem als Vorverarbeitungsschritt genutzt, z. B. vor der Kantenerkennung.

#### Flow

![image-20250903-202246.png](https://doku.evoviu.de/__attachments/a_017408c935d558146cfd9640214b8f612ac5124a8084163efbb038376e6bbf81/image-20250903-202246.png?cb=75d28e53791ad16c7ae04d663b86072d)

#### Parameterset

|     **Parameter**     |    **Typ**    |                                                                                             **Beschreibung**                                                                                              |                                                                                           **Effekt - Min**                                                                                           |                                                                                           **Effekt - Max**                                                                                           |
|-----------------------|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image                 | Image → Input | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. | ![image-20250903-084500.png](https://doku.evoviu.de/__attachments/a_d0d362cfac43e9c589c5913d0b824ba9b487c1403d37ec19d5a1bbd4e11f9825/image-20250903-084500.png?cb=d2410637632a7f6c0515668c5096c4c4)                        |                                                                                                                                                                                                      |
| Kernel Width (Pixel)  | Int32         | Breite des Gaußschen Kerns. Höhere Werte erhöhen die Glättung, können aber Details verwischen. Der Wert muss positiv und ungerade sein.                                                                   | ![image-20250903-202403.png](https://doku.evoviu.de/__attachments/a_4ffcd3c9222a8982cb2276c5c097049bb03ab55688f5d6d028fd25012dcd439c/image-20250903-202403.png?cb=0e6af5ee2294d3182a4ae83252402d20) Width: 3px Heigth: 3px | ![image-20250903-202434.png](https://doku.evoviu.de/__attachments/a_1d8b4784619358405ebb6e0b2254ca9101c70e5e1bc1eda0899a3dbe59d3129e/image-20250903-202434.png?cb=cfdb2e39040e9236a0154ca97a9580fd) Width: 9px Heigth: 3px |
| Kernel Height (Pixel) | Int32         | Höhe des Gaußschen Kerns. Höhere Werte erhöhen die Glättung, können aber Details verwischen. Der Wert muss positiv und ungerade sein.                                                                     | ![image-20250903-202505.png](https://doku.evoviu.de/__attachments/a_2d65e33bc1ff940974d5723c5863cdde8dfe85feaff4192a2b86041fe04b68f9/image-20250903-202505.png?cb=a6dca08617f303d6c851248598d68d91) Width: 3px Heigth: 9px | ![image-20250903-202616.png](https://doku.evoviu.de/__attachments/a_af09f025c9a9242085a8451a1fc01e79299b854b7d6280736521848bfe23fb4e/image-20250903-202616.png?cb=1947966b8005b5dd160e9195bed19286) Width: 9px Heigth: 9px |

### Median

Mit diesem Knoten können Sie einen Median-Filter auf ein Bild anwenden, der das Rauschen reduziert, indem er jeden Pixelwert durch den Medianwert seiner Nachbarschaft ersetzt.

Der **Median-Filter** eignet sich besonders zur Entfernung von punktförmigem „Salz-und-Pfeffer"-Rauschen. Er glättet Störungen, ohne Kanten so stark zu verwischen wie Durchschnitts- oder Gauss-Filter.

#### Flow

![image-20250903-202956.png](https://doku.evoviu.de/__attachments/a_250309c9c07dfc8307f875a742b0eb0e652347212e12e1eb803b466351ed6af3/image-20250903-202956.png?cb=61ec0cb0c616edd5e08e81eeee5ebbfc)

#### Parameterset

|    **Parameter**    | **Typ** |                                                                                                     **Beschreibung**                                                                                                      |                                                                                        **Effekt Min**                                                                                        |                                                                                        **Effekt Max**                                                                                         |
|---------------------|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image               | Image   | Ein Graustufenbild ist erforderlich. Sie können den Knoten "To Grayscale (Image)" verwenden.                                                                                                                              | ![image-20250901-091538.png](https://doku.evoviu.de/__attachments/a_bc79464ca8cb5419141f2d91f720bd4acd788f6157525d3751a65caa4f992b31/image-20250901-091538.png?cb=451c03fdee6262a19b91f96b8e2138bf)                |                                                                                                                                                                                               |
| Kernel Size (Pixel) | Int32   | Bereich der benachbarten Pixel, der für die Berechnung des Medians verwendet wird. Höhere Werte erhöhen die Rauschunterdrückung, können aber feine Details verwischen. Der Wert muss positiv, ungerade und größer 1 sein. | ![image-20250903-203538.png](https://doku.evoviu.de/__attachments/a_27089b9fdf055f087579ace2c72b8b63c721ab2bd7118f2eca4843f9bb0be985/image-20250903-203538.png?cb=1998289ac9eb18defec0434d892b918f) Kernel Size: 3 | ![image-20250903-203614.png](https://doku.evoviu.de/__attachments/a_14e225589f1ff3ccfad4119e851d5199c65e6d6a3327380387c93510e32ef24e/image-20250903-203614.png?cb=cf15883a7a432a8ecc222b45aed54653) Kernel Size: 11 |

## Transformation

**Transformationsalgorithmen** verändern die geometrische Darstellung eines Bildes, ohne den Inhalt direkt zu bearbeiten. Sie dienen zur Anpassung von Größe, Ausrichtung oder Verzerrung:

* **Anisotropic Scaling** verändert Höhe und Breite unabhängig voneinander (z. B. Strecken oder Stauchen)

* **Isotropic Scaling** vergrößert oder verkleinert das Bild gleichmäßig in alle Richtungen

* **Resize** passt das Bild auf eine gewünschte Größe an

* **Translation** verschiebt das Bild um einen bestimmten Wert in x- oder y-Richtung

* **Flip** spiegelt das Bild horizontal oder vertikal

* **Rotate Center** dreht das Bild um seinen Mittelpunkt

* **Undistort** korrigiert Verzerrungen (z. B. durch Kameraoptiken)

Diese Verfahren werden genutzt, um Bilder **anzupassen, auszurichten** oder **geometrisch zu korrigieren**.

### Anisotropic Scaling

Skaliert Breite und Höhe eines Bildes mit unterschiedlichen Faktoren -- ermöglicht nicht-proportionale Größenänderung. In der Bildverarbeitung dient vor allem zur **Korrektur und Normierung**, damit Objekte unabhängig von der Aufnahmebedingungen konsistent analysiert werden können.

#### Flow

![image-20250903-204450.png](https://doku.evoviu.de/__attachments/a_d624dbedf449515e3fba1a23fdde8a08e68ac38ad999c65c626f8fe8f05495e5/image-20250903-204450.png?cb=d5b4035b5a33436b09d6df735dfd6066)

#### Parameterset

| **Parameter** | **Typ** |                                                                                             **Beschreibung**                                                                                              |              **Wertebereich**              |                                                                                                                **Effekt Min**                                                                                                                |                                                                                                        **Effekt Max**                                                                                                         |
|---------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image   | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. |                                            | ![image-20250903-090740.png](https://doku.evoviu.de/__attachments/a_f20f7dbe7353a788473f2ad2d4c778ecc20d9f16975dd9c682258ab6bccafb23/image-20250903-090740.png?cb=77b05f6039512ae8be40efa0f9deacc5) Original = Scale 1 Scale Width: 1 Scale Height: 1 1200\*1200px |                                                                                                                                                                                                                               |
| Scale Width   | Single  | Faktor, um den die Bildbreite skaliert wird.                                                                                                                                                              | Beispielwerte 0.5: 50% 1.0: 100% 1.5: 150% | ![image-20250903-205353.png](https://doku.evoviu.de/__attachments/a_e5832470a63bae49a44516eea368c7e43bc9ae96131ba3b7679cd0d2d525e993/image-20250903-205353.png?cb=ec6e4a325ddd43e62f1ac5c362091387) Scale Width: 1 Scale Height: 1.25 1200\*1500px                 | ![image-20250903-205450.png](https://doku.evoviu.de/__attachments/a_d62478300efbfeba81ff6ad4704feccef8fdfdc056750c85eb93639bf2d7879f/image-20250903-205450.png?cb=0604a217f12805f94fe39638af6ccf93) Scale Width: 2 Scale Height: 1 1500\*750px      |
| Scale Height  | Single  | Faktor, um den die Bildhöhe skaliert wird.                                                                                                                                                                | Beispielwerte 0.5: 50% 1.0: 100% 1.5: 150% | ![image-20250903-205135.png](https://doku.evoviu.de/__attachments/a_d46e7e4f617ffa3961d258ddc68a60fcfd29e51fa990e6814a179421bc83d9f1/image-20250903-205135.png?cb=89c52519414f062b46c8b2b7e28cf046) Scale Width: 0.1 Scale Height: 0.1 120\*120px                  | ![image-20250903-205109.png](https://doku.evoviu.de/__attachments/a_6ca98fb119d991a8d38b81569c69d60f548304b3fe5941b559085ac6b0ccdb82/image-20250903-205109.png?cb=d7cc0b78aeb3738d065cee8a6aaf41bd) Scale Width: 1.7 Scale Height: 1.7 2040\*2040px |

### Isotropic Scaling

Skaliert ein Bild gleichmäßig in beide Richtungen -- das Seitenverhältnis bleibt dabei erhalten. Isotropic Scaling sorgt für **gleichmäßige Skalierung** und ist ideal, wenn Proportionen und Formen exakt erhalten bleiben sollen, z.B bei KI- oder Klassifikationssystemen.

#### Flow

![image-20250903-205856.png](https://doku.evoviu.de/__attachments/a_c264b1792519415f61c31604f79c188a9024f3bd4c35c0274f2348c9505bf159/image-20250903-205856.png?cb=9f48027be3ce957e9f15e5d1195d1e64)

#### Parameterset

| **Parameter** | **Typ** |                                                                                             **Beschreibung**                                                                                              |              **Wertebereich**              |                                                                                                **Effekt Min**                                                                                                 |                                                                                           **Effekt Max**                                                                                            |
|---------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image   | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. |                                            | ![image-20250903-090740.png](https://doku.evoviu.de/__attachments/a_f20f7dbe7353a788473f2ad2d4c778ecc20d9f16975dd9c682258ab6bccafb23/image-20250903-090740.png?cb=77b05f6039512ae8be40efa0f9deacc5) Original = Scale 1 1200\*1200px |                                                                                                                                                                                                     |
| Scale         | Single  | Einheitlicher Skalierungsfaktor, der sowohl auf die Breite als auch auf die Höhe angewendet wird.                                                                                                         | Beispielwerte 0.5: 50% 1.0: 100% 1.5: 150% | ![image-20250903-210128.png](https://doku.evoviu.de/__attachments/a_04d080b69efc0fcaaaf372c395be952d1a9a31bf4c4e2bf22a28bc09ec2e5c52/image-20250903-210128.png?cb=d8721757700db0dc49641dfcbd288106) Scale: 0.5 600\*600px           | ![image-20250903-210154.png](https://doku.evoviu.de/__attachments/a_57bedeb565372d3706ca1cb32c35210bb548ec0b6fde9ac4dd9b477f1570560c/image-20250903-210154.png?cb=a3bfcd0ec123865e73979c1a727f3793) Scale: 3 3600\*3600px |

### Resize

Ändert Bildgröße auf definierte Maße -- Breite und Höhe werden gezielt an die gewünschte Pixelzahl angepasst.

#### Flow

![image-20250903-210805.png](https://doku.evoviu.de/__attachments/a_9d0facaf22cb034635471de9f5793004863e3703ab60433fc20067b9e2eb5162/image-20250903-210805.png?cb=558be03e0e9cef2c2c5fdddaef7a40cc)

#### Parameterset

| **Parameter** | **Typ** |                                                                                             **Beschreibung**                                                                                              | **Wertebereich** |                                                                                              **Effekt Min**                                                                                              |                                                                                              **Effekt Max**                                                                                               |
|---------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image   | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. |                  | ![image-20250903-090740.png](https://doku.evoviu.de/__attachments/a_f20f7dbe7353a788473f2ad2d4c778ecc20d9f16975dd9c682258ab6bccafb23/image-20250903-090740.png?cb=77b05f6039512ae8be40efa0f9deacc5)                            |                                                                                                                                                                                                           |
| Width         | Int32   | Gewünschte Breite in Pixel.                                                                                                                                                                               | \>1              | ![image-20250903-211329.png](https://doku.evoviu.de/__attachments/a_8f25bc70eb23f7cb7963edd9619fdf9d32ac5ca6f0a0eb2f23b8b054244d78f0/image-20250903-211329.png?cb=df2b6326d2aab59e4963b2890c8b5f4a) Width: 100px Height: 100px | ![image-20250903-211430.png](https://doku.evoviu.de/__attachments/a_2f06fcd73c565f17fa01da01bbc03cf437c1fb453a958ae20d634c7b60faf734/image-20250903-211430.png?cb=11d8a8c1b5bf7012a17fa8fde1f0bd6e) Width: 500px Height: 1000px |
| Height        | Int32   | Gewünschte Höhe in Pixel.                                                                                                                                                                                 | \>1              | ![image-20250903-211329.png](https://doku.evoviu.de/__attachments/a_8f25bc70eb23f7cb7963edd9619fdf9d32ac5ca6f0a0eb2f23b8b054244d78f0/image-20250903-211329.png?cb=df2b6326d2aab59e4963b2890c8b5f4a) Width: 100px Height: 100px | ![image-20250903-211430.png](https://doku.evoviu.de/__attachments/a_2f06fcd73c565f17fa01da01bbc03cf437c1fb453a958ae20d634c7b60faf734/image-20250903-211430.png?cb=11d8a8c1b5bf7012a17fa8fde1f0bd6e) Width: 500px Height: 1000px |

### Translation

Verschiebt ein Bild horizontal und/oder vertikal -- freigewordene Bereiche werden mit schwarzen Pixeln gefüllt.

#### Flow

![image-20250903-211744.png](https://doku.evoviu.de/__attachments/a_96bd7a2a648848dc996683e0c3c99a0cd164f1a0b285b70ba721f513ac05f0aa/image-20250903-211744.png?cb=03971b4d64e54418aee695f2b25da207)

#### Parameterset

| **Parameter** | **Typ** |                                                                                             **Beschreibung**                                                                                              |        **Wertebereich**        |                                                                                          **Effekt Min**                                                                                          |                                                                                          **Effekt Max**                                                                                           |
|---------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image   | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. |                                | ![image-20250903-090740.png](https://doku.evoviu.de/__attachments/a_f20f7dbe7353a788473f2ad2d4c778ecc20d9f16975dd9c682258ab6bccafb23/image-20250903-090740.png?cb=77b05f6039512ae8be40efa0f9deacc5)                    |                                                                                                                                                                                                   |
| X (Pixel)     | Int32   | Horizontaler Verschiebungsabstand. Positive Werte verschieben den Bildinhalt nach rechts, während negative Werte ihn nach links verschieben.                                                              | \>0 nach rechts \<0 nach links | ![image-20250903-212144.png](https://doku.evoviu.de/__attachments/a_cbf95828c033de737870ba8e686b0665ca8a05e0d7e6b1fb65239b44dbbf10a1/image-20250903-212144.png?cb=74d3a40bd942cc4e114a666d3fd91379) X: 100px Y: 100px  | ![image-20250903-212231.png](https://doku.evoviu.de/__attachments/a_09033d627717f13413c33383f2bbb440f6d3c35b8fe49160aaba85a840ed03a9/image-20250903-212231.png?cb=c265bd9c4fdc28e96963e2dd7b9da6e4) X: -250px Y: 100px  |
| Y (Pixel)     | Int32   | Vertikaler Verschiebungsabstand. Positive Werte verschieben den Bildinhalt nach unten, während negative Werte ihn nach oben verschieben.                                                                  | \>0 nach unten \<0 nach oben   | ![image-20250903-212426.png](https://doku.evoviu.de/__attachments/a_56050da40731f79759341f1d613168beaae521d4de092a6a3bd80e46a7ae7d82/image-20250903-212426.png?cb=40bb9b774a0f0fe9a83feacb4da61877) X: 150px Y: -250px | ![image-20250903-212329.png](https://doku.evoviu.de/__attachments/a_85a2f59dead910149b0df87a7476d4878bbdf9cd7301a76e1dde7217fce0f8bb/image-20250903-212329.png?cb=d8d05ef085d91c340aa1cbeef1aefc6f) X: -250px Y: -150px |

### Flip

Spiegelt ein Bild horizontal oder vertikal -- erzeugt ein Spiegelbild entlang der gewählten Achse.

#### Flow

![image-20250904-093222.png](https://doku.evoviu.de/__attachments/a_3327d3b12bcebed51364292c00d0b507e6994d02074fb0b0538864b0e7cbc55c/image-20250904-093222.png?cb=76e72cb7567009f921ce75da05ffdf90)

#### Parameterset

| **Parameter** | **Typ** |                                                                                             **Beschreibung**                                                                                              |  **Wertebereich**  |                                                                                  **Effekt**                                                                                   |
|---------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image   | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. |                    | ![image-20250903-090740.png](https://doku.evoviu.de/__attachments/a_f20f7dbe7353a788473f2ad2d4c778ecc20d9f16975dd9c682258ab6bccafb23/image-20250903-090740.png?cb=77b05f6039512ae8be40efa0f9deacc5) |
| Mode          | Enum 1  | Richtung, in die das Bild gespiegelt werden soll: Horizontal gepspiegelt                                                                                                                                  | Horizontal         | ![image-20250904-093517.png](https://doku.evoviu.de/__attachments/a_c170081fea1f89b576463c9a351625f21ea1adf0dc3afccb79db6768b2027fae/image-20250904-093517.png?cb=7dd81794a90d93fde971b4d0ddc76026) |
|               | Enum 2  | Richtung, in die das Bild gespiegelt werden soll: Horizontal und Vertikal gespiegelt                                                                                                                      | HorizontalVertical | ![image-20250904-093612.png](https://doku.evoviu.de/__attachments/a_8bc576269bb484e173430bcf3ef819cb42a235faa1d7dfe892121b8caaf34288/image-20250904-093612.png?cb=df741e009f281bc6492c6fbc53ec07ff) |
|               | Enum 3  | Richtung, in die das Bild gespiegelt werden soll: Vertikal gespiegelt                                                                                                                                     | Vertical           | ![image-20250904-093749.png](https://doku.evoviu.de/__attachments/a_ffe29b922599e414e8aad2d8e08f41a49859b55af07ae1786cfffab3724f1833/image-20250904-093749.png?cb=1347856c73d864d3a902c6227ba40608) |

### Rotate Center

Dreht ein Bild um einen angegebenen Winkel -- Rotation erfolgt um den Mittelpunkt.  
Winkel \> 0: Drehung nach Links

Winkel \< 0: Drehung nach Rechts

#### Flow

![image-20250904-094104.png](https://doku.evoviu.de/__attachments/a_98e4bca915000fd65fd87ef384725ee9b4c7b79bc8982ec2a28eef45c43b4919/image-20250904-094104.png?cb=135af71becc47051dd5cf03eded3433f)

#### Parameterset

| **Parameter** | **Typ** |                                                                                             **Beschreibung**                                                                                              |                                                                                                                                                                                                                        |                                                                                                       **Effekt**                                                                                                       |
|---------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image         | Image   | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden. |                                                                                                                                                                                                                        | ![image-20250903-090740.png](https://doku.evoviu.de/__attachments/a_f20f7dbe7353a788473f2ad2d4c778ecc20d9f16975dd9c682258ab6bccafb23/image-20250903-090740.png?cb=77b05f6039512ae8be40efa0f9deacc5)                                          |
| Angle \[deg\] | Int32   | Winkel, um den das Bild gedreht wird. Winkel \> 0: Drehung nach Links Winkel \< 0: Drehung nach Rechts                                                                                                    | ![image-20250904-094406.png](https://doku.evoviu.de/__attachments/a_51943b9f171690cdd1272af2b22db5ac6aa197a2169a1d08a01d98ce8aeff30a/image-20250904-094406.png?cb=eeeae2d3db2e33f3ab2f98907de136c9) Beispiel: 15°                            | ![image-20250904-094448.png](https://doku.evoviu.de/__attachments/a_265eebb8c332075340b4687bc1e5d650a74f3bfd8b3506633ac99c54b7628679/image-20250904-094448.png?cb=467a031feb4c56ca8c1387706766e51c) Beispiel: -45°                           |
| Resize To Fit | Boolean |                                                                                                                                                                                                           | ![image-20250904-105031.png](https://doku.evoviu.de/__attachments/a_5a2aa480b0bfb905de242032d98f928cb13b9372974f692abf098b0c5bed75d1/image-20250904-105031.png?cb=b4648464aeff6ee97221a0e625a75325) Beispiel: -45° Resize: True 1469\*1469px | ![image-20250904-094607.png](https://doku.evoviu.de/__attachments/a_14059cbe73944f016d6ff16a570c242f6b510b54c47a1166819da3e2ed64c7e0/image-20250904-094607.png?cb=346ba86d722eafd914f0dd4f25b0335a) Beispiel: -45° Resize: True 1697\*1697px |

### Undistort

Entfernt den sogenannten Fischaugeneffekt aus dem Bild -- korrigiert extreme Weitwinkelverzerrungen.  
Die Daten werden von uns auf Anfrage in Abhängigkeit von Sensor und Linse bereitgestellt. Alternativ können Sie die Kalibrierfunktion der Image Source zum Ermitteln der Werte nutzen.

#### Flow

![Screenshot 2026-01-26 152646.png](https://doku.evoviu.de/__attachments/a_c24c4907ee59d9f834b8342209f8a588e1736d66fa71e6ee489c3e02eb931816/Screenshot%202026-01-26%20152646.png?cb=da795ad2968422260fe337ebbd96ee19)

#### Parameterset

|   **Parameter**   |      **Typ**      |                                                                                                                                                                                                                                                                                                         **Beschreibung**                                                                                                                                                                                                                                                                                                         |                                       **Wertebereich**                                        |                                                                                **Effekt Min**                                                                                 |
|-------------------|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Image             | Image             | Sowohl Graustufen- als auch Farbbilder können verwendet werden. Wenn ein Graustufenbild genutzt werden soll, muss das Bild möglicherweise vorab mit dem Knoten "To Grayscale (Image)" konvertiert werden.                                                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                               | ![image-20250901-091538.png](https://doku.evoviu.de/__attachments/a_bc79464ca8cb5419141f2d91f720bd4acd788f6157525d3751a65caa4f992b31/image-20250901-091538.png?cb=451c03fdee6262a19b91f96b8e2138bf) |
| Camera Params     | Camera Params     | Bitte nutzen Sie hierfür den Knoten "Make Camera Parameters (Undistort)". Fx: Brennweite des Systems (Sensor - Optik) in x-Richtung Fy: Brennweite des Systems (Sensor - Optik) in y-Richtung Cx: Optisches Zentrum des Systems in x-Richtung, angegeben in Pixelkoordinaten (im Regelfall das Zentrum des Sensors) Cy: Optisches Zentrum des Systems in x-Richtung, angegeben in Pixelkoordinaten (im Regelfall das Zentrum des Sensors) Die Daten werden von uns auf Anfrage in Abhängigkeit von Sensor und Linse bereitgestellt. Alternativ können Sie die Kalibrierfunktion der Image Source zum Ermitteln der Werte nutzen. | Beispiel VIU13 - 2.6mm Linse: fx: 6454.156558 fy: 6454.156558 cx: 2104.000000 cy: 1560.000000 | ![image-20250901-091538.png](https://doku.evoviu.de/__attachments/a_bc79464ca8cb5419141f2d91f720bd4acd788f6157525d3751a65caa4f992b31/image-20250901-091538.png?cb=451c03fdee6262a19b91f96b8e2138bf) |
| Distortion Params | Distortion Params | Bitte nutzen Sie hierfür den Knoten "Make Distortion Parameters (Undistort)". K1: Verzeichnungsparamater K1 K2: Verzeichnungsparameter K2 P1: Verzeichnungsparameter P1 P2: Verzeichnungsparameter P2 K3: Verzeichnungsparameter K3 Die Daten werden von uns auf Anfrage in Abhängigkeit von Sensor und Linse bereitgestellt. Alternativ können Sie die Kalibrierfunktion der Image Source zum Ermitteln der Werte nutzen.                                                                                                                                                                                                       | Beispiel VIU13 - 2.6mm Linse k1: -0.667539 k2: -0.608235 p1: 0.015444 p2: 0.003268 k3: 0      | ![image-20250901-091538.png](https://doku.evoviu.de/__attachments/a_bc79464ca8cb5419141f2d91f720bd4acd788f6157525d3751a65caa4f992b31/image-20250901-091538.png?cb=451c03fdee6262a19b91f96b8e2138bf) |

---
version: "8.6.0"
language: "de"
---
# Fokussierung & Optiksteuerung

Neben der Lichtsteuerung spielt auch die **Optik** eine entscheidende Rolle für die Qualität der Bildaufnahme. Über **VISIONWEB** können Fokus und weitere optische Parameter der evoVIU flexibel angepasst werden, solange ein Flüssiglinse verbaut ist. So lässt sich die Bildschärfe exakt auf das jeweilige Objekt und die gewünschte Arbeitsdistanz einstellen. Unterschiedliche Anwendungen -- etwa die Erkennung feiner Strukturen, die Inspektion glänzender Oberflächen oder die Aufnahme in variablen Abständen -- erfordern eine präzise Steuerung der Optik.

## Dynamische Fokussierung

Die **Flüssiglinse** wird über einen vorgeschalteten **8-Bit-Treiber** angesteuert, der bitweise eine höhere Spannung auf die Linse legt und dadurch ihre Verformung bewirkt. Dieser Treiber kann direkt über **VISIONWEB** bedient werden. Die grundlegende Funktionsweise wurde bereits in der **Image Source** beschrieben und kann dort über die Auswahl der Komponente übernommen werden. Soll die Flüssiglinse jedoch während der Laufzeit dynamisch gesteuert werden, muss dies separat über den **Workflow** erfolgen.  
Diese Einstellungen sind ausschließlich für Kameras mit **Flüssiglinsen** verfügbar. Erkennen können Sie dies am Modellnamen: **VIUXXX-XX\[** **0...4****\]-XX-X**

### Vorbereitung

1. Gehen Sie auf unter Components auf "+" und suchen Sie im Kontextmenü nach der Komponente "Eight Bit Lens" - Wählen Sie anschließend den Eintrag aus, weitere weitere Einstellungen müssen Sie nicht vornehmen.

![image-20250930-124809.png](https://doku.evoviu.de/__attachments/a_7b39687d90b8b3efeda70584b5305cb275297b6dd75e6b97691155eb84a271e5/image-20250930-124809.png?cb=f510e53b68d1f7842d9acb1bdc6ec49e)

2. Suchen Sie nach dem Knoten **„Set Focus"** und fügen Sie ihn in Ihren Workflow ein. Verknüpfen Sie den Knoten "Set Focus" mit der sich ebenfalls im Kontextmenü befindlichen "Eight Bit Lens" Komponente.

![image-20250930-125716.png](https://doku.evoviu.de/__attachments/a_18d13afcb935b292af60d7ea91209667b94b019c595161ed62dab4e7dbadadcb/image-20250930-125716.png?cb=eac5c8cc220710ceea622a8acc61760c)

3. Unter **Range** können Sie den Fokus im Wertebereich von **0 bis 254** einstellen. Bitte beachten Sie, dass der Wert **0** den Treiber vollständig deaktiviert. Je höher der Wert, desto näher ist das Objekt, welches fokussiert wird.

4. Fügen Sie anschließend einen **Grab Image**-Knoten hinzu, um ein Bild aufzunehmen. Im folgenden Beispiel wird zunächst die Linse eingestellt und anschließend ein Bild erfasst. Möglicherweise wird noch ein kurzer Delay benötigt.

![image-20250930-130039.png](https://doku.evoviu.de/__attachments/a_1d564b43cad44fd37faf06423d696441bab8e94e88b91f279ab87da164056078/image-20250930-130039.png?cb=6863a79b79bf11c7e659863399286d15)

5. Wenn die Linse über ein externes Protokoll gesteuert werden soll, lässt sich dies nahtlos in den Workflow integrieren. Im folgenden Beispiel nutzen wir ein TCP/IP-Protokoll; grundsätzlich kann jedoch jedes andere Protokoll eingesetzt werden. Der TCP-Server empfängt dabei das folgende JSON-Telegramm:

   JSON

       {
         "UseBoost": false,
         "UseLight": true,
         "Focus": 176
       }

   Das Licht ist nicht angeschlossen, jedoch kann der Fokus verwendet werden. Bei jeder Bildaufnahme wird mit dem übertragenen Fokuswert ein Bild gespeichert.

![image-20250930-185300.png](https://doku.evoviu.de/__attachments/a_22a0c0a316a68df44bc5dd77cbc0c686dd9c629d636426102858d137e54fd614/image-20250930-185300.png?cb=afb09dfae1b75754018273bd9b5e25c2)

### Hinweise und Anwendungsmöglichkeiten

#### Einstellung Fokus im Startevent

Das Beispiel zeigt die Einstellung des Fokus beim Start des Systems. Wird der entsprechende Knoten nicht an anderer Stelle erneut gesetzt, bleibt die Fokuseinstellung im Workflow statisch bestehen.  
![image-20250930-190102.png](https://doku.evoviu.de/__attachments/a_6dd594402483ace474db4aa33ae875776d0181cb11ffdf88fa88a9772a6ff880/image-20250930-190102.png?cb=cbd6d8c3308c550a93c63cf8dc1a351e)

#### Einstellung des Fokus während des Betriebs von Extern

Das Beispiel zeigt den Einsatz von zwei getrennten Flows: Während der erste Flow alle **300 ms** ein Bild aufnimmt, ermöglicht der zweite Flow die externe Steuerung der Linse über das eingehende Protokoll.  
![image-20250930-190246.png](https://doku.evoviu.de/__attachments/a_4638ac714fce1e6f0cde132d3444224ace05170f6dae219aafe1987c9ab125d4/image-20250930-190246.png?cb=c4b4d58e19f86e4ad3c7c95962e4ea20)  
Herzlichen Glückwunsch -- Sie können nun die Linse Ihrer Kamera erfolgreich fokussieren.

## Autofocus

Der Workflow verfügt inzwischen auch über einen Autofocus Knoten. Dieser nimmt eine Image Source Component, eine zu fokussierende Region in Form einer Box sowie einen Timeout entgegen. Sobald die Ausführung des Knotens an der Reihe ist, wird eine erneute Fokussierung der Linse vorgenommen.  
Die Nutzung des Autofocus in der Image Source wird empfohlen. Dieser Knoten ist nützlich, wenn Sie die Qualität Ihres Workflows gegenüber Ausfällen oder wechselnde Anforderungen absichern wollen.  

|  **Parameter**  |    **Typ**     |                                                       **Beschreibung**                                                        |
|-----------------|----------------|-------------------------------------------------------------------------------------------------------------------------------|
| Image Source    | I Image Source | Eine Camera oder Image Source Component kann über den Knoten To Image Source in den hier benötigten Typen konvertiert werden. |
| Focus Region    | Box            | Eine zu fokussierende Region, die die Berechnung beschleunigt, aber auch die Genauigkeit erhöht.                              |
| Timeout (ms)    | Integer        | Gibt an, wann die Berechnung automatisch stoppen soll.                                                                        |
| Successful      | Boolean        | Gibt an, ob die Ermittlung des besten Linsenwerts erfolgreich war.                                                            |
| Best Lens Value | Integer        | Gibt den Linsenwert, der die beste Aufnahme ermöglicht, zurück.                                                               |
| Best Image      | Image          | Gibt das beste Bild des Berechnungsvorgangs zurück.                                                                           |

![Screenshot 2026-02-24 150244.png](https://doku.evoviu.de/__attachments/a_1a9c8e5ee3982757d0b2c00a134429f41fa9ea75f1619cf3799d00eb971b88d3/Screenshot%202026-02-24%20150244.png?cb=99386daca4475ba9935fa8fe6792330f)

---
version: "8.6.0"
language: "de"
---
# Formulas

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

## Einleitung

Die Formulas befinden sich im My Workflow Tab unterhalb des Bereichs Annotations. Sie werden verwendet um komplexe Berechnungen wiederverwendbar und mit weniger Knoten abbilden zu können.

## Verwaltung von Formulas

![Screenshot 2025-10-24 083718.png](https://doku.evoviu.de/__attachments/a_0516f43f1cec5c6e854ee468bf8150c44608cac1b3cad93e24fc2aa1a891e48d/Screenshot%202025-10-24%20083718.png?cb=14b2662ad0ecc1d0462f49c9289c9111)

### Anlegen einer Formula

Im Bereich "Formulas" kann über das Plus-Symbol eine neue Formel erstellt werden. Grundsätzlich ist es möglich, beliebig viele Formeln anzulegen. Zur Unterscheidung dient das jeweils vergebene Label. Dieses kann frei gewählt werden, muss jedoch innerhalb der Formulas eindeutig sein.  
Sobald die Formel angelegt wurde, ist sie unvollständig konfiguriert. Daher sehen Sie zunächst eine Fehlermeldung. Über den "Edit"-Button und der Eingabe einer Formel wird der Fehler behoben. Im Detail wird dies im Laufe der Dokumentation erklärt.

### Entfernen einer Formula

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

Das Entfernen der Formel 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 Formel aus dem Event Graph des Workflows entfernen.

### Verschieben einer Formula

Damit Sie sich eine bessere Übersicht über Ihre Formeln 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 Formel diese per Drag \& Drop im zugehörigen Bereich verschieben. Sobald Sie loslassen, wird die Formel an der Stelle platziert, an der Sie sich gerade befinden.

### Usages eines Formula

Sobald Sie eine Formel im Event Graph als Knoten hinzufügen, liegt eine Usage vor. Diese erkennen Sie an einem Icon neben der Bezeichnung der Formel. Wenn Sie auf dieses Icon klicken, öffnet sich ein Dialog in dem die Verwendung der Formel mit einigen Details aufgelistet wird.

## Konfiguration einer Formula

### Auswahl einer Formula

Klicken Sie im Bereich Formulas auf einen Eintrag. Wählen Sie anschließend den zugehörigen Details Tab aus, der nach der selektierten Formel benannt ist. Danach sehen Sie alle vorhandenen Information zur Formeln und können diese Bearbeiten. Wenn Sie eine Formel gerade erst angelegt haben, wird in den Details der Formel lediglich der Output, als das Ergebnis der Berechnung zur Konfiguration angeboten. Dort können Sie den Typen auslesen und bearbeiten.

### Editieren der Formula

![Screenshot 2025-10-24 083834.png](https://doku.evoviu.de/__attachments/a_7d1392a5c567913c22da4fde82aa8ea2fda131006f608843cb5633129cbc3298/Screenshot%202025-10-24%20083834.png?cb=58456e77ffc2665bf3f88f7d3e1e28cd)

Initial ist der Inhalt der Formel leer. Solange dies der Fall ist, können Sie die Formel auch nicht im Event Graph des Workflows hinzufügen. Klicken Sie im nächsten Schritt auf den Button "Edit" um den Dialog zur Konfiguration der Formel zu öffnen.

Sie sehen nun zwei Bereiche: Auf der linken Seite wird Ihnen unter "Current value" die aktuell vorhandene Formel angezeigt. Hier können Sie keine Bearbeitung vornehmen. Die Bearbeitung findet auf der rechten Seiten unter "New value" statt. Hier können Sie eine Formel mit bis zu 100 Zeichen eingeben. Wir starten jedoch ganz simpel mit dem Beispiel "a-b".  
![Screenshot 2025-10-24 083934.png](https://doku.evoviu.de/__attachments/a_5b1ea8d1338ee2cbd2517ab5bf1f9768fc67d5a3512e2a009cd0743136de7bfb/Screenshot%202025-10-24%20083934.png?cb=2a117665cb89c1e92078f434f8c6e6d4)

Geben Sie "a-b" im Dialog "Edit Formula" in der weißen Box unter "New value" ein. Bestätigen Sie die Eingabe, indem Sie auf den gelben "Confirm"-Button klicken. Der Dialog wird anschließend geschlossen.  
Vielleicht ist Ihnen bei der Eingabe der Formel aufgefallen, dass sich Bestandteile des Dialogs geändert haben. Wenn Sie z.B. nur "a-" eingeben wird eine Fehlermeldung angezeigt und erklärt, weshalb die Formel in der aktuellen Ausführung ungültig ist. In diesem Fall können Sie den Dialog auch nicht schließen oder die Änderungen übernehmen.  
![Screenshot 2025-10-24 084006.png](https://doku.evoviu.de/__attachments/a_64b206104fa478084e36044c88ccbc41475459c516beb43734806cf63611acd3/Screenshot%202025-10-24%20084006.png?cb=c58f5b83d7ac514b66ee2cf21b6213d6)

Im Details Tab sehen Sie nun die Formel. Diese können Sie jederzeit wieder ändern. Klicken Sie hierfür einfach erneut auf den "Edit"-Button.

### Verweis zur Dokumentation

Im Dialog "Edit Formula" sehen Sie rechts neben der Bezeichnung "New value" einen Button, der über ein Info-Icon visualisiert wird. Wenn Sie auf diesen Button klicken, werden Sie zur Website des zugrunde liegenden Formeleditors weitergeleitet.

### Cheat Sheet

![Screenshot 2025-10-24 084050.png](https://doku.evoviu.de/__attachments/a_56ae31f5a7d2c6d3aa3bd23787223037efae7c78fe6c7f1cc0db5aff465873bd/Screenshot%202025-10-24%20084050.png?cb=229068209e29b89f5532bc47f101e773)

Rechts neben dem Info-Icon befindet sich der Button zum Öffnen des Cheat Sheets. Hier finden Sie einige Vorschläge und Hilfestellungen zur Konfiguration von Formeln. Die Formeln sind auf folgende Bereiche aufgeteilt:

* Basic

* Geometry

* Statistics

* Logarithm \& Root

* Util

Die Formeln des Cheat Sheets im Detail:  

|      **Tab**      |       **Aktion**        |                  **Beschreibung**                   |    **Formel**     |
|-------------------|-------------------------|-----------------------------------------------------|-------------------|
| Basic             | Addition                | Berechnet die Summe zweier Werte                    | `a+b`             |
|                   | Subtraktion             | Berechnet die Differenz zwischen zwei Werten        | `a-b`             |
|                   | Multiplikation          | Berechnet das Produkt zweier Werte                  | `a*b`             |
|                   | Division                | Berechnet den Quotienten zweier Werte               | `a/b`             |
|                   | Modulo                  | Berechnet den Rest einer Division                   | `a%b`             |
|                   | Potenzierung            | Erhöht die Basis mit dem Exponenten                 | `a^b`             |
| Geometry          | Sinus                   | Sinus eines Winkels                                 | `sin(a)`          |
|                   | Cosinus                 | Cosinus eines Winkels                               | `cos(a)`          |
|                   | Tangens                 | Tangens eines Winkels                               | `tan(a)`          |
|                   | Kotangens               | Kotangens eines Winkels                             | `cot(a)`          |
|                   | Arkussinus              | Inverser Sinus eines Winkels                        | `asin(a)`         |
|                   | Arkuscosinus            | Inverser Cosinus eines Winkels                      | `acos(a)`         |
|                   | Arkustangens            | Inverser Tangens eines Winkels                      | `atan(a)`         |
|                   | Arkuskotangens          | Inverser Kotangens eines Winkels                    | `acot(a)`         |
| Statistics        | Minimum                 | Gibt den kleinsten Wert im Set zurück               | `min(a, b, c)`    |
|                   | Maximum                 | Gibt den größten Wert im Set zurück                 | `max(a, b, c)`    |
|                   | Durchschnitt            | Berechnet den Mittelwert der Werte                  | `avg(a. b, c)`    |
|                   | Median                  | Gibt den mittleren Wert zurück, wenn sortiert       | `median(a, b, c)` |
| Logarithm \& Root | Natürlicher Logarithmus | Logarithmus zur Basis e                             | `loge(x)`         |
|                   | Allgemeiner Logarithmus | Logarithmus zur Basis 10                            | `log10(x)`        |
|                   | Logarithmus Basis n     | Logarithmus von x mit Basis n                       | `logn(x, n)`      |
|                   | Quadratwurzel           | Berechnet die Quadratwurzel                         | `sqrt(x)`         |
| Util              | Zufall                  | Erzeugt eine Zufallszahl zwischen 0 und 1           | `random()`        |
|                   | Rundung                 | Rundet eine Zahl auf die nächste Ganzzahl           | `round(x)`        |
|                   | Negation                | Negiert den Wert (logisches Nicht)                  | `!a`              |
|                   | Bedingung               | Bedingte Funktion: wenn a wahr ist, dann b, sonst c | `if(a, b, c)`     |

Wenn Sie eine Formel aus dem Cheat Sheet anwenden möchten, können Sie einfach mit der Maus über einen Eintrag fahren. Auf der rechten Seite wird Ihnen in der gleichen Zeile ein Icon zum Kopieren der Formel angezeigt. Klicken Sie auf dieses Icon um die Formel in die Zwischenablage zu speichern. Schließen Sie anschließend den Dialog und fügen Sie im Dialog "Edit Formula" im Feld unter "New value" die Formel aus der Zwischenablage ein.

### Zurücksetzen der Eingabe

Falls Sie die Bearbeitung Ihrer Formel zurücksetzen und nochmal von vorne beginnen möchten, können Sie im Dialog "Edit Formel" den ganz rechts angeordneten Button mit dem "Undo"-Icon nutzen. Anschließend besitzen "Current value" und "New value" wieder die identischen Werte.

### Variables

![Screenshot 2025-10-24 084129.png](https://doku.evoviu.de/__attachments/a_408636154249284e73c6c376141b4e01624e70767167c283bbd27f005d680bc9/Screenshot%202025-10-24%20084129.png?cb=cd5f759a51ade90dec1f8abd0e96432f)

Die Variablen werden automatisch generiert, sobald Sie eine Formel angegeben haben. Die Bezeichnung der Variablen kann in dieser Ansicht nicht angepasst werden, ebenso wenig Sie gelöscht werden können. Um Änderungen vorzunehmen, müssen Sie den Dialog zum Editieren der Formel öffnen. Im Bereich Variables können Sie jedoch den Ergebnistypen der Variablen anpassen: Es stehen Ihnen `Single` für Gleitkommazahlen und `Int32` für ganze Zahlen zur Verfügung.

### Output

Der Output wird automatisch generiert, sobald Sie eine Formel angegeben haben. Die Bezeichnung des Outputs kann nicht angepasst werden, ebenso wenig wie der Output gelöscht werden kann. Sie können an dieser Stelle jedoch den Ergebnistypen anpassen: Es stehen Ihnen `Single` für Gleitkommazahlen und `Int32` für ganze Zahlen zur Verfügung.

### Testen der Formula

![Screenshot 2025-10-24 084220.png](https://doku.evoviu.de/__attachments/a_f37162474f7e766b4644b968f7a8b9ad91a52adb81c2dae88322fb6b777d8831/Screenshot%202025-10-24%20084220.png?cb=02b88caccee2d6708e26881c7990a26e)

Zum Testen Ihrer Formel klicken Sie bitte auf den Button "Test Formula". Es öffnet sich ein Dialog. In diesem Dialog wird Ihnen die Formel angezeigt. Außerdem können Sie alle Variablen mit Werten befüllen. Am unteren Ende des Dialogs können Sie das Ergebnis der Berechnung sehen.

## Nutzung im Workflow

![Screenshot 2025-10-24 084634.png](https://doku.evoviu.de/__attachments/a_e460e840aea91806fde6c7f996c5d5f145426f7c0379593d8bd9011691022dc0/Screenshot%202025-10-24%20084634.png?cb=9a33d0602ac91f75fac7b3f26fe60fdc)

Nehmen wir an Sie haben eine Formel mit der Bezeichnung "MyFormula" angelegt. Damit Sie diese Formel nun im Workflow verwenden können, müssen Sie im Tab Event Graph per Rechtsklick das Context-Menü öffnen. Sie können anschließend "MyFormula" in der Suchleiste eintippen oder über die Ordner "Math" und "Formula" navigieren. Wählen Sie nun den Eintrag "Calculate MyFormula" aus um den Knoten zum Workflow hinzuzufügen.

Im nächsten Schritt kümmern wir uns um das Befüllen der Inputs des Calculate-Knotens. In unserem Beispiel greifen wir hier auf zwei Variablen vom Typ Int32 zurück, die wir beliebig in Form des Set-Knotens der Variablen befüllen. Anschließend verbinden wir deren Ausgänge mit den Eingängen des Calculate-Knotens. Wichtig ist zudem ein Start-Event zu Beginn des Workflows, da die Berechnung initial ausgelöst werden muss.

Dann können wir uns um die Ausgabe kümmern. Das Ergebnis der Berechnung speichern wir in diesem Fall ebenfalls in eine eigene Variable, deren Wert wird zur Ansicht über "Publish Value" freigegeben haben. Wenn Sie den Wert der Variable mit dem Knoten "To String (Integer)" noch konvertieren, können Sie über den Print-Knoten das Ergebnis der Berechnung im Output-Tab einsehen.

---
version: "8.6.0"
language: "de"
---
# FTP/SFTP

Mit VISIONWEB besitzen Nutzer die Möglichkeit der Datenspeicherung auf FTP und SFTP Server.

## Verbindungsparameter

| **Parameter** |        **Type**         | **Einheit** |           **Erklärung**            |                             **Beispiel**                             |
|---------------|-------------------------|-------------|------------------------------------|----------------------------------------------------------------------|
| Address       | Domain \|\| IP - String |             | Zieladresse des (S)FTP-Server      | [myftp.myfactory.de](http://myapi.api.de/api/v1/start) 192.168.0.123 |
| Port          | Integer                 |             | Port zum (S)FTP-Server             | FTP: Port 21 SFTP: Port 22                                           |
| Username      | String                  |             | Benutzername zur Authentifizierung | deinName                                                             |
| Password      | String                  |             | Passwort zur Authentifizierung     | xxxxxxxxx                                                            |
| Timeout       | Integer                 | ms          | Timeout bei zu langer Übertragung  | 5000                                                                 |

### Zusätzliche Parameter

| **Parameter** |  **Type**  | **Einheit** |                      **Erklärung**                       |          **Beispiel**          |
|---------------|------------|-------------|----------------------------------------------------------|--------------------------------|
| Payload       | Byte Array |             | Payload - Alles, was in Byte umgewandelt werden kann     | Files                          |
| Directory     | String     |             | Dateipfad zum gewünschten Endpunkt. Angabe ist optional. | /Directory1/Directory2/        |
| Filename      | String     |             | Dateiname Bitte geben Sie die Dateiendung immer an.      | meinBild.jpg meinDatensatz.csv |

## Workflow Setup

### Anlegen einer FTP-Verbindung

Der FTP-Knoten ist im Vergleich zum SFTP nicht als Komponente angelegt. Dieser wird zum Zeitpunkt des Workflows - wenn die Iteration an dem Punkt ist - erst einen Verbindungsaufbau durchführen. Dadurch muss keine Komponente angelegt werden.

Zur Nutzung des FTP müssen folgende Schritte durchgeführt werden.

1. Suchen Sie im Context-Menü nach dem Knoten "Upload (FTP)" - Für CSV-Anwendungen gibt es einen eigenen Knoten.

![image-20250731-115206.png](https://doku.evoviu.de/__attachments/a_4545ee39a821d90a4d1b688d37a05f1d9a89c3583655f2963fd4eafbc8386d53/image-20250731-115206.png?cb=e05bb82bda203adeb84a8f7d9a8dc9c1)

2. Befüllen Sie nun den Upload (FTP)-Knoten mit den Verbindungsparametern.

![image-20250731-115635.png](https://doku.evoviu.de/__attachments/a_7d70f1f0828695a318e8868484b8d443bd877ecf052f57aee7a9b3c0eec29a4a/image-20250731-115635.png?cb=4cc9756a1ca2476c245bbc1914bcac34)

3. Binden Sie Ihre zu übertragenden Daten - im Beispiel ein Bild - an das Payload an.

![image-20250731-124144.png](https://doku.evoviu.de/__attachments/a_5216c210066ecb90d04c2fd4963b1c0a00a2debd77cc155deecbdcce8a0488b2/image-20250731-124144.png?cb=d726c751d129628599049f78a027848e)  
Herzlichen Glückwünsch. Sie können jetzt Daten auf dem FTP Server hochladen.

4. Der Dateiname kann im nächsten Schritt, beispielsweise über "Append" und mit der Uhrzeit, dynamisch erzeugt werden. Somit wird im `Directory1/Directory2` die Datei `20250731_145234_cam1.jpg` abgelegt.

![image-20250731-124340.png](https://doku.evoviu.de/__attachments/a_9f3c19d3179269053cbf1b49673f1723e75549f90cd8780525719ad0ccf09cfb/image-20250731-124340.png?cb=a0df796991a6654755b13600000b8dc5)

5. Ordner und Dateiname können ebenfalls, je nach Ergebnis, dynamisch definiert werden. Im Beispiel steuert das "Result" dabei nicht nur den Ordner, sondern auch den Input des Dateinamens.

Result = iO: Ablage in Directory `iO` mit Dateinamen `20250731_145234_cam2_iO.jpg`

Result = niO: Ablage in Directory `niO` mit Dateinamen `20250731_145234_cam2_niO.jpg`  
![image-20250731-125148.png](https://doku.evoviu.de/__attachments/a_f2baa653eab16d5127377781fb1fa1519f9b3d1128425fa74406dc5f4fff45e0/image-20250731-125148.png?cb=66168c93a72b2dcfcc8fb9a402faf18a)  
Herzlichen Glückwünsch. Sie können jetzt dynamisch Dateinamen anpassen und diese je nach Situation in verschiedenen Ordnern ablegen.

6. Über die Ausgänge "Success" und "Message" können Sie sich je Iteration Informationen zum Versenden der Daten ausgeben lassen.

![image-20250731-125726.png](https://doku.evoviu.de/__attachments/a_dc839feaacc218b21da07352f31ac61aa26fcb981c401291797586da5f6a1236/image-20250731-125726.png?cb=0337e8d0e137af987f5395ab8f69b92a)

### Anlegen einer SFTP-Verbindung

Diese Art der FTP-Übertragung wird in der Regel von den meisten Kunden bevorzugt.

1. Suchen Sie im Context-Menü des Workflows ebenfalls nach "Upload (SFTP)"-Knoten und wählen Sie diesen aus.

![Screenshot 2026-02-20 151732.png](https://doku.evoviu.de/__attachments/a_6b130dda2cd3b6be4b310e907893483bc4938d69b9023c2cd78db1f18c6546a5/Screenshot%202026-02-20%20151732.png?cb=453ef245c9a145fb172504a22db8553b)

2. Befüllen Sie nun den Upload (SFTP)-Knoten mit den Verbindungsparametern.

3. Anschließend können Sie den Knoten ähnlich wie bei FTP ([https://evopro.atlassian.net/wiki/spaces/DVIU/pages/79888859/working+FTP+SFTP#Anlegen-einer-FTP-Verbindung](https://doku.evoviu.de/de/product-documentation/8.6.0/ftp-sftp.md#Anlegen-einer-FTP-Verbindung) ) in Ihrem Workflow einbetten.

![Screenshot 2026-02-20 151653.png](https://doku.evoviu.de/__attachments/a_dc6bb510cdfc360939315bce8686c3ad2e836af79f346977d2229dc81a3be5cd/Screenshot%202026-02-20%20151653.png?cb=86fa422f5bdd805b4d86173170a2d3ab)  
Herzlichen Glückwünsch! Jetzt können Sie auch den SFTP Knoten dynamisch nutzen.

*** ** * ** ***

## Upload File (FTP)

Statt einem Byte Array, können Sie auch direkt auf Dateien aus dem File System der Kamera zurückgreifen und diese Uploaden.

Sendet ein FTP-Datagramm an einen entfernten Host. Das File Transfer Protocol (FTP) ist ein Standard-Netzwerkprotokoll für die Übertragung von Dateien zwischen Rechnern in einem Netzwerk.  
Wichtig:

Der direkte Zugriff auf einen FTP-Server aus einem Produktionsnetzwerk ist möglicherweise nicht sofort möglich, da hierfür spezielle Zugriffsrechte erforderlich sind, die von Ihrem Systemadministrator konfiguriert werden müssen.

### Flow

![Screenshot 2026-03-18 084636.png](https://doku.evoviu.de/__attachments/a_326cf6e242e4408795370d017ea865c6bb39f4a76886ec14f4983b409bbc2e76/Screenshot%202026-03-18%20084636.png?cb=334aa5e482e2fa7a63a549fa240775d1)

### Parameterset

| **Parameter** |        **Type**         | **Einheit** |                           **Erklärung**                           |                             **Beispiel**                             |
|---------------|-------------------------|-------------|-------------------------------------------------------------------|----------------------------------------------------------------------|
| Payload       | File Store Item         |             | Eine Datei, die das FTP-Datagramm angibt, das Sie senden möchten. |                                                                      |
| Address       | Domain \|\| IP - String |             | Zieladresse des FTP-Server                                        | [myftp.myfactory.de](http://myapi.api.de/api/v1/start) 192.168.0.123 |
| Port          | Integer                 |             | Port zum FTP-Server                                               | FTP: Port 21                                                         |
| Username      | String                  |             | Benutzername zur Authentifizierung                                | deinName                                                             |
| Password      | String                  |             | Passwort zur Authentifizierung                                    | xxxxxxxxx                                                            |
| Directory     | String                  |             | Das Verzeichnis, in dem die Datei gespeichert wird.               | MyDirectory                                                          |
| Filename      | String                  |             | Der Dateiname, den die hochgeladenen Daten erhalten sollen.       | my-file                                                              |
| Timeout       | Integer                 | ms          | Timeout bei zu langer Übertragung                                 | 5000                                                                 |

*** ** * ** ***

## Upload File (SFTP)

Statt einem Byte Array, können Sie auch direkt auf Dateien aus dem File System der Kamera zurückgreifen und diese Uploaden.

Sendet ein SFTP-Datagramm an einen Remote-Host. Secure File Transfer Protocol (SFTP) ist ein Standard-Netzwerkprotokoll für die sichere, verschlüsselte Dateiübertragung zwischen Rechnern.  
Wichtig:

Dieser Knoten benötigt eine SFTP-Instanz. Sie können im Komponentenbereich einen Knoten „SFTP senden" erstellen und ihn über „Knoten abrufen" zum Workflow hinzufügen.

### Flow

![Screenshot 2026-03-18 084618.png](https://doku.evoviu.de/__attachments/a_75be63f43adb3cdffc894e2efe73e221d025da8290ac2aca31824014d2af8163/Screenshot%202026-03-18%20084618.png?cb=c76dcbbfd93c0a9077d6ee768c187493)

### Parameterset

| **Parameter** |        **Type**         | **Einheit** |                           **Erklärung**                            |                             **Beispiel**                             |
|---------------|-------------------------|-------------|--------------------------------------------------------------------|----------------------------------------------------------------------|
| Payload       | File Store Item         |             | Eine Datei, die das SFTP-Datagramm angibt, das Sie senden möchten. |                                                                      |
| Address       | Domain \|\| IP - String |             | Zieladresse des SFTP-Server                                        | [myftp.myfactory.de](http://myapi.api.de/api/v1/start) 192.168.0.123 |
| Port          | Integer                 |             | Port zum SFTP-Server                                               | SFTP: Port 22                                                        |
| Username      | String                  |             | Benutzername zur Authentifizierung                                 | deinName                                                             |
| Password      | String                  |             | Passwort zur Authentifizierung                                     | xxxxxxxxx                                                            |
| Directory     | String                  |             | Das Verzeichnis, in dem die Datei gespeichert wird.                | MyDirectory                                                          |
| Filename      | String                  |             |                                                                    | my-file                                                              |
| Timeout       | Integer                 | ms          | Timeout bei zu langer Übertragung                                  | 5000                                                                 |

---
version: "8.6.0"
language: "de"
---
# Functions

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

## Einleitung

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

## Verwaltung von Functions

![Screenshot 2025-12-02 173651.png](https://doku.evoviu.de/__attachments/a_503452165e58326e02cb52dda6b5af289496b16bc431952fed59d9c1128d3e5f/Screenshot%202025-12-02%20173651.png?cb=f33f2310ce44c21452facad46e991c79)

### Anlegen einer Function

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

### Entfernen einer Function

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

Das Entfernen der 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 Function aus dem Event Graph des Workflows entfernen.

### Verschieben einer 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 Function diese per Drag \& Drop im zugehörigen Bereich verschieben. Sobald Sie loslassen, wird die Function an der Stelle platziert, an der Sie sich gerade befinden.

### Exportieren einer Function

![Screenshot 2025-12-02 174451.png](https://doku.evoviu.de/__attachments/a_609aeaff7f78bfc2a85d379aa0a3bf39bf5d4b399a1d1d1d3b234dcccd9eee1c/Screenshot%202025-12-02%20174451.png?cb=7cbd3eea12a74964d8ca0629e8081594)

Für das Exportieren einer Custom Function müssen Sie die zu exportierende Custom Function auswählen. Fahren Sie anschließend mit der Maus auf den Eintrag. Zwischen den Buttons Usages und Remove Entry erscheint der Button zum Start des Export-Vorgangs. Sobald Sie diesen gedrückt haben, öffnet sich ein Dialog, in dem Sie neben einem Passwortschutz auch die Vergabe eines spezifischen Labels vornehmen können. Durch einen Klick auf Confirm wird der Export ausgelöst. Sie erhalten die exportierte Custom Function als `.zip`-Datei.  
![Screenshot 2025-12-02 172512.png](https://doku.evoviu.de/__attachments/a_f88b3755d11da0dee211f99e0a159f10448acd768b8374c736059f793c982c05/Screenshot%202025-12-02%20172512.png?cb=667b6629391604df792323d852d8f7c4)  
Mit der Tastenkombination `ALT` + `SHIFT` + `e` kann, sofern eine Custom Function selektiert wurde, ebenfalls der Export-Dialog geöffnet werden.

### Importieren einer Function

Für den Fall, dass Sie eine Custom Function von einem anderen Workflow oder andere Kamera in Ihrem aktuellen Workflow nutzen wollen, steht Ihnen die Import-Funktion für Custom Functions zur Verfügung. Sie befindet sich in der Bereichsüberschrift links neben dem Button zum Hinzufügen einer neuen Custom Function.

## Parameter einer Function

![Screenshot 2025-12-02 173045.png](https://doku.evoviu.de/__attachments/a_1a06197b43060a793f73edc8834ef045ceda1d31da49d98794c8fccb9001dbe1/Screenshot%202025-12-02%20173045.png?cb=a94286f833eea20d94511672c14272ed)

### Anlegen von Parametern

Wenn Sie eine 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 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 Functions können Sie auch die zugehörigen Parameter innerhalb der 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 Function

![Screenshot 2025-12-02 173045.png](https://doku.evoviu.de/__attachments/a_1a06197b43060a793f73edc8834ef045ceda1d31da49d98794c8fccb9001dbe1/Screenshot%202025-12-02%20173045.png?cb=a94286f833eea20d94511672c14272ed)

### 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 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 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 Function

### Auswahl einer Function

Um eine 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 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 Function an. Der Tab besitzt neben dem Label zudem einen Button, der in Form eines X Ihnen die Auswahl einer anderen Function ermöglicht.  
![Screenshot 2025-12-02 173314.png](https://doku.evoviu.de/__attachments/a_e69f286495fdf2988b33f8d07a9afffebbf310a4bc4748ffb852c0364b653e45/Screenshot%202025-12-02%20173314.png?cb=44b46753358f86769a47178d5f847891)

### Einbinden einer 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 Function eingeben und diese anschließend per Klick auswählen. Die Function wird nun im Graphen Ihres Workflows hinzugefügt.  
![Screenshot 2025-12-02 173344.png](https://doku.evoviu.de/__attachments/a_c31cfbf1eb0c6716eb16c4a7afe793a2225e576cb80fb327933a9a145d3dba96/Screenshot%202025-12-02%20173344.png?cb=967dedf71cca93de3bff46d659a886f6)

Sobald Sie die Function als Knoten Ihrem Workflow hinzugefügt haben, erscheint im Tab My Workflow auch ein Hinweis über die Verwendung der Function. Wenn Sie auf das Icon klicken, können Sie anschließend im Dialog nachvollziehen, wo die Function verwendet wird. An dieser Stelle greift nun auch ein Sicherheitsmechanismus: Sobald Ihre 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.  
![Screenshot 2025-12-02 173450.png](https://doku.evoviu.de/__attachments/a_b051611ad2cb4457534a5bb6e73ce9c29160ac9bc64a82e3d410e1856a7903e5/Screenshot%202025-12-02%20173450.png?cb=9e27afd9fc34440e2da81b7b7f749f7a)

### Hinzufügen notwendiger Knoten

Der Tab zur Konfiguration der Function ist initial mit einem Eingangs- und Ausgangsknoten vorbefüllt. Diese sind mit Entry bzw. Return benannt und erforderlich für die Ausführung des gesamten Workflows. Sie können die Knoten auch ü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.  
![Screenshot 2025-12-02 173537.png](https://doku.evoviu.de/__attachments/a_0d331adfbd2b50f3f73f67f85183f02826b07cc1a8657b73b12cbb8ff1b48b4c/Screenshot%202025-12-02%20173537.png?cb=d4d4a70375655c0442caa32664423f43)

### Konfigurieren einer Function anhand eines Graphen

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

[Next Page](https://doku.evoviu.de/llms-full.txt/1)
