evoVIU Dokumentation
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.
1. Der Bild-Editor 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 für den Bereich Files zur weiteren Verwendung abgespeichert werden. Und diese weitere Verwendung kommt nun beim Bild-Editor ins Spiel.
Wenn Sie den Workflow mit all seinen Tabs geöffnet haben, entdecken Sie auch den Tab “Image”. Initial sehen Sie an dieser Stelle nur, dass bisher noch kein Bild gewählt wurde. Um ein Bild sehen und bearbeiten zu können, benötigen Sie entweder eine Variable vom Typ Image oder Sie legen eine Annotation an, welcher Sie ein Bild mitgeben. Sobald Sie nämlich eine Annotation angelegt haben, erscheint in der Leiste ein Button mit einem Ordner-Symbol, über welchen Sie ein Bild aus dem File Manager laden können.
Verwalten von Annotationen
Damit Sie Bildausschnitte markieren können, müssen Sie vorab Sets und Annotationen anlegen. Da jede Annotation einem Set zugewiesen werden muss, beginnen Sie 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.
Anlegen von Annotationen
Sobald mindestens ein Image Annotation Set vorhanden ist, kann auch über den gleichen Ablauf eine Annotation erstellt werden. Im Erstell-Dialog müssen Sie die zu erstellende Annotation einem Set zuordnen. Außerdem ist die Wahl einer Form notwendig, damit klar ist, wie die Darstellung erfolgen soll und welche Funktionen zur Konfiguration bereitgestellt werden müssen. Aktuell können Rechtecke oder Polygone erstellt werden.
Editieren
In dieser Liste können Sie die erstellten Sets und Annotation natürlich auch bearbeiten. Durch einen Doppelklick auf den Listeneintrag können Sie die vorhandenen Einträge umbenennen. Sobald der Fokus nicht mehr auf dem Eingabefeld liegt, werden die Änderungen übernommen.
Entfernen
Sets und Annotation können natürlich auch entfernt werden. Es muss lediglich sichergestellt sein, dass die aufgelisteten Einträge nicht als Knoten im Workflow verwendet werden. Wenn Sie eine Annotation nicht mehr benötigen, dann können Sie diese auch 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.
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.
Verwendung von Annotationen (Usages)
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 der 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.
Initiale Auswahl eines Bildes zum Konfigurieren einer Annotation
Da wir die Annotation so konfigurieren wollen, dass 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 sicher, 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, dann können Sie diesen in der Leiste am unteren Ende des Tabs und den gelben Ordner-Button über einen Dialog auswählen. Sobald Sie die Auswahl bestätigt haben, wird die Image Toolbar mit den im Ordner enthaltenen Bildern befüllt. Damit der Ordner-Button sichtbar wird, muss im Tab “My Workflow” eine Ihrer Annotationen angewählt sein.
Anzeige-Eigenschaften eines Bild 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 rechten, 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 ist diese Darstellungsoption aber wohl die richtige Wahl. Mit der Option “Scale To Container” wird die verfügbare Fläche des Tabs komplett ausgenutzt, allerdings kann es hier zu einer verzerrten Darstellung kommen, falls das Bildverhältnis nicht optimal zur verfügbaren Fläche passt.
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
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.
Shape Toolbar
Im Tab “Image” befindet sich am oberen Ende eine Leiste mit verschiedenen Icons, die Shape Toolbar. Hinter diesen Icons verbergen sich 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.
Konfigurieren von Anzeige-Eigenschaften einer Annotation
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.
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.
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.
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 “Regions & 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.
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.
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.
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
Stellen Sie sich 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 Image” Knoten.
Dieser Knoten benötigt eingehende Daten vom Typ “Box”. Die konfigurierte Annotation kann als Knoten dem Workflow hinzugefügt werden und kann die benötigten Daten vom Typ “Box” bereitstellen. So kann die vorgenommene Annotation effektiv für die Verarbeitung von Daten eingesetzt werden.
2. Bild Editor im 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.
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.
