Perspective Transform

Dieser Funktionsblock ermöglicht es, ein quadrilaterales Gebiet in einem Bild zu definieren und eine korrigierte Draufsicht (perspektivisch transformierte Ansicht) dieses Bereichs zu erzeugen. Die Bedienung ist interaktiv — wählen Sie vier Punkte im Bild, ziehen Sie sie zur Feinabstimmung und verwenden Sie Tastenkürzel, um die Auswahl zu bearbeiten.

📥 Eingänge

• Image — Quellbild, das im Block angezeigt wird, um Punkte auszuwählen.

📤 Ausgänge

• Image — Das perspektivisch transformierte (warped) Bild des ausgewählten Quadrilaterals.

• Transform Matrix — Die Perspektivtransformationsmatrix (nützlich zum Weiterleiten an andere Blöcke, die eine Perspektive- oder Homographie-Matrix benötigen).

🕹️ Steuerungen

• Interactive Image Area — Klicken Sie auf das Bild, um Punkte hinzuzufügen. Beim Hinzufügen werden die Punkte als überlagertes Polygon angezeigt.

• Drag Points — Klicken und ziehen Sie einen Punkt, um seine Position zu ändern.

• C — Löscht alle ausgewählten Punkte.

• U — Macht den zuletzt hinzugefügten Punkt rückgängig.

• Help Text — Kleine Hilfetexte auf dem Block, die daran erinnern, wie Punkte hinzugefügt, gezogen, gelöscht und rückgängig gemacht werden.

Hinweis: Die Überlagerung zeigt an, ob das Polygon vollständig ist, und hebt den Scheitelpunkt unter der Maus zur einfacheren Anpassung hervor.

⚙️ Ausführungsmechanismus

• Der Block zeigt das verbundene Bild an, sodass Sie interaktiv vier Punkte wählen können.

• Wenn weniger als vier Punkte definiert sind, gibt der Block leere Ausgaben zurück, damit nachgelagerte Blöcke wissen, dass die Transformation noch nicht bereit ist.

• Sobald vier Punkte vorhanden sind, ordnet der Block diese, berechnet die Größe des Ausgaberechtecks aus den ausgewählten Punkten, erstellt eine Perspektivtransformation und gibt das gewarpte Bild zusammen mit der Transform Matrix aus.

• Der Block cached die zuletzt berechnete Transformation für dasselbe Bild und dieselbe Punktmenge, um unnötige Neuberechnungen zu vermeiden, während andere Teile des Szenarios angepasst werden.

✨ Funktionen

• Interaktive, visuelle ROI-Auswahl mit Klick-und-Zieh-Bearbeitung.

• Tastenkürzel für schnelles Editieren.

• Visuelle Überlagerung zeigt Polygon, Vertex-Hervorhebung und Vollständigkeitszustand.

• Gibt sowohl das korrigierte Bild als auch die Transformationsmatrix zur Wiederverwendung aus.

• Automatische Größenwahl bestimmt ein geeignetes Ausgaberechteck basierend auf den ausgewählten Punkten.

📝 Nutzungshinweise

1. Verbinden Sie einen bildproduzierenden Block mit dem Eingang Image.

2. Klicken Sie im Bildbereich des Blocks, um bis zu vier Eckpunkte (in beliebiger Reihenfolge) zu setzen.

3. Ziehen Sie Punkte, um ihre Positionen zu verfeinern.

4. Verwenden Sie U, um den letzten Punkt rückgängig zu machen, und C, um alle Punkte zu löschen.

5. Wenn vier Punkte vorhanden sind, liefert der Block ein korrigiertes Bild und den Ausgang Transform Matrix.

💡 Tipps und Tricks

• Verwenden Sie Show Image, um das Quell- oder transformierte Bild in einem größeren Viewer-Fenster zu betrachten, während Sie die Punkte feinjustieren.

• Wenn Sie den Bereich zuerst zuschneiden möchten, fügen Sie Image ROI Select oder Image ROI vor diesem Block hinzu, sodass Sie an einem kleineren Bereich arbeiten.

• Bei sehr großen Quellbildern sollten Sie Image Resizer vor diesem Block einfügen, um die Interaktion zu beschleunigen und den Speicherbedarf zu reduzieren.

• Die erzeugte Transform Matrix kann in den Social Distance Detector-Block als erforderlichen Perspective Matrix-Eingang eingespeist werden, um reale Entfernungen aus der gewarpeten Ansicht zu messen.

• Speichern Sie transformierte Ergebnisse mit Image Write, wenn Sie Kopien der korrigierten Bilder behalten möchten.

🛠️ Fehlersuche

• Wenn keine Ausgabe erscheint, stellen Sie sicher, dass vier Punkte definiert sind — der Block erzeugt keine Transformation, bis das Quadrilateral vollständig ist.

• Wenn das gewarpte Bild verzerrt aussieht, passen Sie die Eckpunkte durch Ziehen an; Show Image hilft beim Inspektieren von Details während der Feinabstimmung.

• Wenn die Interaktion bei großen Bildern langsam ist, fügen Sie Image Resizer vor diesem Block ein oder arbeiten Sie mit einem zugeschnittenen Bereich mittels Image ROI Select.

• Wenn Sie versehentlich einen Punkt an der falschen Stelle gesetzt haben, drücken Sie U, um den letzten Punkt zu entfernen, oder C, um neu zu beginnen.