> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/german/funktionsblocke/blocks-reference/image-transformations/transformation-filters/alignment.md). # Alignment Dieser Funktionsblock richtet ein Scene Image mithilfe einer geordneten Liste von Referenz-Templates (`Reference ROIs`) und den zugehörigen Begrenzungsrechtecken (`Reference BBoxes`) aus. Verwenden Sie diesen Block, um Verschiebungs- und Rotationsfehler zu korrigieren, sodass das Scene Image einem bekannten Referenzlayout entspricht. ## 📥 Eingänge `Scene Image`\ Das auszurichtende Bild. Geben Sie ein einzelnes, nicht-leeres Bild an. `Reference ROIs`\ Eine oder mehrere geordnete Template-Bilder (ROIs) zur Übereinstimmungsbestimmung. Als Liste angeben. Die Reihenfolge definiert die Zuordnung zu den Bounding Boxes. `Reference BBoxes`\ Eine oder mehrere geordnete Begrenzungsrahmen (Bounding Boxes), passend zu den `Reference ROIs`. Als Liste angeben; die Reihenfolge muss mit den ROIs übereinstimmen. ## 📤 Ausgänge `Aligned Image`\ Das Scene Image, nachdem die berechnete Ausrichtungs-Korrektur angewendet wurde. `Translation`\ Die angewendete Verschiebungskorrektur als (x, y)-Paar. `Angle`\ Die angewendete Rotationskorrektur in Grad. ## 🕹️ Steuerungen `Mode`\ Wählen Sie zwischen reiner Verschiebungsausrichtung (Translation / centroid shift) oder Verschiebung plus Winkelkorrektur (Translation + Angle). Verwenden Sie `Translation`, wenn nur Verschiebung nötig ist, und `Translation + Angle`, wenn auch Rotation korrigiert werden muss. `Match Threshold %`\ Legt die minimale Match-Score fest, die für jede Referenz-ROI erforderlich ist. Höhere Werte verlangen stärkere Übereinstimmungen. `Include Flipped`\ Schalter, der erlauben kann, dass horizontal gespiegelt Versionen der ROI-Templates beim Matching berücksichtigt werden (hilfreich, wenn Objekte gespiegelt auftreten). `Method`\ Wählen Sie die Template-Matching-Methode. Unterschiedliche Methoden können je nach Textur und Kontrast der Referenzen schneller oder genauer sein. `Color Mode`\ Wählen Sie zwischen `Gray` (schneller) und `BGR` (kann für farbige Templates die Genauigkeit verbessern). `Tolerance (+/- px)`\ Setzen Sie eine Pixel-Toleranz für die erlaubte Restabweichung nach der Ausrichtung. Größere Werte erlauben lockerere Anpassungen, kleinere Werte fordern höhere Präzision. ## 🎨 Funktionen * Geordnete Referenzübereinstimmung: Die Reihenfolge von `Reference ROIs` und `Reference BBoxes` bestimmt die Zuordnung zur Berechnung der Ausrichtung. * Zwei Betriebsmodi: nur Translation oder Translation + Angle für Rotationskorrektur. * Optionale gespiegelt-Template-Suche (`Include Flipped`) zur Handhabung spiegelbildlicher Erscheinungen. * Mehrere Matching-Methoden und Farbmodes zur Abwägung zwischen Geschwindigkeit und Genauigkeit. * Numerische Steuerelemente mit sofortiger Validierung zur Vermeidung von Konfigurationsfehlern. ## 📊 Wie es läuft * Der Block benötigt ein gültiges `Scene Image` sowie passende Listen für `Reference ROIs` und `Reference BBoxes`. * Jede ROI wird in der angegebenen Reihenfolge mit der Szene abgeglichen; die korrespondierende Bounding Box gibt den erwarteten Ort an. * Treffen die Matches die Vorgabe in `Match Threshold %`, berechnet der Block die notwendige Verschiebung (und bei Auswahl auch den Winkel), um die Szene auszurichten. * Der Block gibt das korrigierte `Aligned Image` sowie die angewendete `Translation` und den `Angle` zurück. * Fehlen Eingaben, sind sie leer oder stimmen Anzahl/Ordnung von ROIs und BBoxes nicht überein, meldet der Block einen Fehler und stoppt, bis die Eingaben korrigiert sind. ## 📝 Nutzungshinweise 1. Bereiten Sie ein klares Referenzset vor: Erstellen Sie kleine Template-ROIs, die eindeutige, feste Landmarken in der Szene identifizieren. 2. Geben Sie passende BBox-Definitionen in derselben Reihenfolge wie die ROIs an. 3. Wählen Sie den `Mode`, je nachdem, ob eine Rotationskorrektur nötig ist. 4. Setzen Sie `Match Threshold %` auf einen Wert, der echte Treffer annimmt und zufällige Ähnlichkeiten ablehnt. 5. Optional: Aktivieren Sie `Include Flipped`, wenn gespiegelt auftretende Versionen erwartet werden. 6. Führen Sie den Block aus und prüfen Sie `Aligned Image` sowie die numerischen Ausgaben, um das Ergebnis zu verifizieren. ## 💡 Tipps und Tricks * Verwenden Sie `Image ROI` oder `Image ROI Select`, um präzise Referenz-Templates aus einem Beispielbild zu erstellen, bevor Sie sie in `Reference ROIs` einspeisen. * Wenn Sie mehrere Regionen interaktiv definieren müssen, nutzen Sie `Image ROI Polygon Multi`, um mehrere Referenz-ROIs zu speichern. * Zur visuellen Überprüfung der Ausrichtung verbinden Sie `Aligned Image` mit `Show Image`, um die Korrekturen anzusehen. * Für robustes Matching in texturierten Szenen probieren Sie `Color Mode = BGR` und testen verschiedene `Method`-Auswahlen. * Wenn automatische Template-Extraktion nötig ist, nutzen Sie `Find Object`, um Instanzen zu lokalisieren und anschließend ROIs aus den angegebenen Koordinaten abzuleiten. * Speichern Sie ausgerichtete Ergebnisse mit `Image Logger` oder `Image Write`, wenn Sie korrigierte Frames protokollieren möchten. ## 🛠️ Fehlersuche * Mismatch zwischen ROIs und BBoxes\ Stellen Sie sicher, dass Anzahl und Reihenfolge von `Reference ROIs` und `Reference BBoxes` identisch sind. Der Block hängt von der Reihenfolge zur Festlegung der Zuordnung ab. * Nicht genügend Referenzen für Rotationsmodus\ Wenn Sie `Translation + Angle` wählen, stellen Sie sicher, dass Sie mindestens zwei unterschiedliche Referenzen bereitstellen; ansonsten ist die Rotation nicht zuverlässig lösbar. * Niedrige Match-Werte oder fehlgeschlagene Matches\ Erhöhen Sie bei vielen False-Positives den `Match Threshold %`, oder senken Sie ihn leicht, wenn echte Referenzen übersehen werden. Wechseln Sie `Method` oder `Color Mode`, um bessere Resultate zu erzielen. * Unerwartete Restabweichung nach Ausrichtung\ Erhöhen Sie `Tolerance (+/- px)`, wenn kleine Positionierungsfehler tolerierbar sind, oder verfeinern Sie Ihre Referenz-ROIs, um eine höhere Präzision zu erreichen. * Visuelle Verifikation\ Wenn die Ausrichtung falsch erscheint, prüfen Sie die Zwischen-Templates und das `Aligned Image` mit `Show Image`, um zu diagnostizieren, welche Referenz nicht korrekt gematcht wurde.