AnnotationGUI/GUI Anleitung.txt

Anleitung:

Zuweisen der Objekt IDs mithilfe der intelligenten Zuweisungsoberfläche:
Bevor sie die Objekt IDs zuweisen, sollten sie darauf achten, 
dass jedes vorkommen des Objektes, dessen ID zugewiesen werden soll, mit einem Polygon gekennzeichnet wurde.
Ist dies der fall gehen sie wie Folgt vor:
Klicken sie das erste Bild an, auf dem das Objekt vorkommt und klicken sie in der oberen Leiste auf IDs bearbeiten.
Es erscheint ein Dialog mit den nächsten neun Bildern der Sequenz.
Klicken sie in dem Bild ganz links oben auf das Objekt, welchem sie eine ID zuweisen wollen.
Falls dieses Objekt die ID -1 hat, erscheint nun ein Dialog, in dem sie eine neue ID vergeben können.
Falls es bereits eine ID hat, so wird diese als Zuweisungs ID für die folgenden Bilder benutzt.
Die GUI versucht nun automatisch in den folgenden Bildern das gleiche Objekt zu finden.
Alle Objekte, die die ID zugewiesen bekommen, werden grün markiert.
Falls es in den Bildern bereits andere Objekte gibt, die die gleiche ID haben, so werden diese rot markiert.
Falls die GUI nicht das richtige Objekt ausgewählt hat, kann dies in dem entsprechenden Bild einfach mit einem Klick auf das korrekte Objekt korrigiert werden.
Mit einem Rechtsklick auf einem Bild wird festgelegt, dass kein Objekt auf diesem Bild die ID bekommen soll.
Klicken sie auf Weiter, falls sie in allen angezeigten Bildern das richtige Objekt ausgewählt haben.
Daraufhin werden 6 weitere Bilder angezeigt, in denen ein Objekt ausgewählt werden kann.
Klicken sie auf Speichern um den Vorgang zu beenden. Es wird dann jedem grün markiertem Objekt die ID zugewiesen.
Klicken sie auf Abbrechen, um keine ID zu übernehmen und alle Änderungen zu verwerfen. 

Eine Neue Sequenz erstellen:
Klicken sie auf Öffnen.
Wählen sie in dem Dialog den Ordner aus, der die Bilder der Sequenz enthält.
Klicken sie im Dialog auf Open.
Es sollte ein Dialog erscheinen mit der Frage, ob eine neue Sequenz erstellt werden soll.
Klicken sie auf Yes.
Falls in dem ausgewählten Ordner eine CSV Datei existiert, wird die Sequenz von der CSV Datei genneriert.
Falls keine CSV Datei existiert, so wird ein Dialog erscheinen, mit der Frage, ob die Sequenz trotzdem erstellt werden soll.
Klicken sie auf Yes.
Es wird nun eine Sequenz erstellt, in der die Bilder im ausgewählten Ordner alphabetisch sortiert sind. Die Namen der Unterordner werden als Kameranamen verwendet.
Es erscheint ein Dialog wo sie den Speicherort der Sequenz festlegen können. 
Wählen sie einen leeren Ordner aus. In diesem Ordner werden dann die Unterordner "Annotations", "JPEGImages", "SourceImages", "SourceMasks" automatisch generiert.
Es erscheint nun ein Dialog, in dem ausgewählt werden kann welche Bilder in die neue Sequenz übertragen werden sollen. Standartmäßig werden alle Bilder übertragen.

Eine bestehende Sequenz öffnen:
Klicken sie auf Öffnen.
Wählen sie in dem Dialog den Ordner aus, der die Sequenz enthält.
Die vier Ordner "Annotations", "JPEGImages", "SourceImages" und "SourceMasks" müssen direkte Unterordner des ausgewählten Ordners sein.
Klicken sie in dem Dialog auf Open.
Die Sequenz wird nun geladen und es wird das erste Bild der ersten Kamera angezeigt.

Ein neues Objekt erstellen:
Wählen sie das Werkzeug "Neues Objekt" aus oder drücken sie "n" um es auszuwählen.
Klicken sie nun der Reihe nach alle Eckpunkte des Objektes an.
Um den Vorgang abzuschließen, klicken sie erneut auf den zuerst angeklickten Punkt oder drücken sie "n".

Ecke eines Objektes verschieben oder neue Ecke einfügen:
Wählen sie das Werkzeug "Verschieben" aus oder drücken sie "m" um es auszuwählen.
Bewegen sie ihre Maus in die Nähe der Ecke, die sie verschieben möchten.
Die ecke, die verschoben wird, leuchtet grün auf.
Halten sie die linke Maustaste gedrückt, um die Ecke zu verschieben.

Löschen von Eckpunkten oder von Objekten:
Wählen sie das Werkzeug "Löschen" aus oder drücken sie "d" um es auszuwählen.
Halten sie die linke Maustaste gedrückt, um einen Bereich festzulegen, in dem alle Eckpunkte gelöscht werden sollen.
Wenn durch das löschen dieser Eckpunkte ein Objekt weniger als 3 Eckpunkte hat, wird es automatisch gelöscht.

Löschen von ganzen Objekten:
Klicken sie mit der rechten Maustaste auf das Objekt.
Wählen sie in dem erschienenen Menü den Eintrag "Objekt löschen".

Objekte verstecken:
Wählen sie das Werkzeug "Verstecken" aus oder drücken sie "s" um es auszuwählen.
Klicken sie nun auf ein Objekt um es zu verstecken.
Wenn sie erneut auf das Objekt klicken, wird es wieder angezeigt.
Andere Werkzeuge haben keinen Effekt auf versteckte Objekte.

Objekte zerteilen:
Wählen sie das Werkzeug "Zerschneiden" aus oder drücken sie "x" um es auszuwählen.
Klicken sie an einem Polygon zwei Eckpunkte an.
Die Eckpunkte dürfen nicht nebeneinander liegen.
Beim klick auf den zweiten Eckpunkt wird das Objekt anhand der beiden Eckpunkte zerteilt.

Objekt ID ändern:
Machen sie einen Rechtsklick auf das Objekt.
Rählen sie in dem erschienenen Menü den Eintrag "Objekt ID bearbeiten ..." aus.
Es erschein nun ein Dialog, wo in einem Textfeld die neue Objekt ID eingegeben werden kann.
Unter diesem Textfeld ist das Objekt abgebildet, dessen ID geändert werden soll.
Auf der rechten Seite des Dialogs kann das Objekt mit anderen Objekten verglichen werden.
Dabei kann in einer Liste ein Objekt ausgewählt werden.
Mit zwei Knöpfen kann man sich verschiedene Bilder von dem ausgewählten Vergleichsobjekt anzeigen lassen.
Dabei können auch die Pfeiltasten zur Navigation verwendet werden.
Klicken sie auf speichern, um dem Objekt die neue ID zuzuweisen.
ObjektIDs können auch mit dem Kopieren und Einfügen Werkzeug zugewiesen werden (siehe unten).

Objekte kopieren:
Wählen sie das Werkzeug "Kopieren" aus oder drücken sie "c" um es auszuwählen.
Klicken sie auf das Objekt, welches kopiert werden soll.
Das kopierte Objekt wird grün markiert.
Halten sie an einer freien Stelle die Rechte Maustaste gedrückt um das kopierte Objekt zu drehen.
Klicken sie (z. B. auf einem anderen Bild) auf eine freie Stelle, um das Objekt dort einzufügen.
Klicken sie (z. B. auf einem anderen Bild) auf ein vorhandenes Objekt, um festzulegen, dass es sich dabei um das gleiche Objekt handelt, wie das kopierte.
Dabei erhält das Objekt die Objekt ID des kopierten Objektes. Um ein neues Objekt zu kopieren drücken sie erneut "c".

Objektklassen verwalten:
Klicken sie auf Optionen.
Klicken sie auf "Klassen verwalten".
Es erschein ein Dialog, mit allen Objektklassen, die in der geöffneten Sequenz vorkommen.
Mit einem Doppelklick auf den Namen einer Klasse, kann diese umbenannt werden.
Mit einem Klick auf "Neue Klasse" können Klassen hinzugefügt werden.
Mit einem Klick auf "Klasse löschen" wird die in der Liste ausgewählte Klasse entfernt.

Kamera Maske erstellen:
Wählen sie oben in der Leiste den Eintrag Maske bearbeiten, wenn sie die Maske zu dem Bild der aktuellen Kamera bearbeiten wollen.
Andernfalls klicken sie in dem Objektbaum auf der linken Seite des Hauptfensters mit der rechten Maustaste auf eine Kamera.
Wählen sie in dem erschienenen Menü den Eintrag "Maske bearbeiten ..." aus.
Es erscheint ein Dialog, in dem die Maske bearbeitet werden kann.
Wählen sie für das spezifizieren von schwarzen Flächen den Knopf mit dem schwarzen Polygon aus.
Wählen sie für das spezifizieren von weißen Flächen den Knopf mit dem weißen Polygon aus.
Klicken sie nun in dem angezeigten Bild auf die Eckpunkte der Fläche, die sie einfärben wollen.
Um den Vorgang abzuschließen klicken sie auf die zuerst angeklickte Ecke.
Klicken sie auf "speichern", um die Maske zu speichern.
Die Maske wird anschließend auf alle Bilder der Kamera angewendet.
Alle Objekte, die sich vollständig im schwarzen Bereich der Maske befinden, werden automatisch entfernt.

Objekte vom Server abfragen:
Falls ein Bild ausgewählt wird, welches zuvor noch nicht annotiert wurde, werden die Objekte automatisch vom Server abgefragt.
Wenn der Vorgang zu einem späteren Zeitpunkt manuell wiederholt wird, gehen dabei alle bereits annotierten Objekte auf dem Bild verloren.
Um den Vorgang manuell auszuführen, machen sie einen Rechtsklick auf das Bild im Objektbaum auf der linken Seite des Hauptfensters.
Wählen sie in dem erscheinenden Menü den Eintrag "Vom Server abfragen ...".
Wenn der Vorgang länger dauert, erscheint ein Dialog, in dem der Vorgang abgebrochen werden kann.

Server Adresse ändern:
Klicken sie auf Optionen.
Wählen sie den Eintrag "Server adresse" aus.
Es erschein ein Dialog mit einem Textfeld.
Geben sie dort die neue Server Adresse ein.
Falls hier eine leere Adresse eingegeben wird, werden keine Vorabannotationen mehr vom Server abgefragt.