Play Folder

Dieser Funktionsblock spielt Bilder aus einem ausgewählten Ordner ab und gibt bei jeder Auswertung genau eine Datei zurück. Verwenden Sie ihn, um Bilddatensätze schrittweise zu durchlaufen, Sequenzen vorzuschauen oder Bilder an nachgelagerte Verarbeitung weiterzugeben. Sie können mit der Schaltfläche einen Standardordner auswählen, diesen zur Laufzeit über die Eingabe Folder Path überschreiben, Dateien mit einem Glob-Muster filtern und die Wiedergabe über Mode und Order steuern.

📥 Eingänge

• Folder Path Optionale String-Eingabe, die den per Schaltfläche ausgewählten Standardordner überschreibt. Geben Sie einen vollständigen Ordnerpfad an, um die Quelle zur Laufzeit zu ändern.

• Restart Optionale boolesche Eingabe. Wenn True, setzt der Block die Wiedergabe für den aktuellen Mode zurück und liefert bei dieser Auswertung das zurückgesetzte (Edge-)Bild.

Hinweis: Dies sind Eingangs-Sockets.

📤 Ausgänge

• Image Das aktuell aus dem Ordner gelesene Bild. Dies ist ein Bild-Ausgangs-Socket.

• File Path Absoluter Pfad der aktuellen Bilddatei. Dies ist ein String-Ausgangs-Socket.

• Restarted Boolescher Wert, der True ist, wenn der Block bei dieser Auswertung ein gewickeltes oder zurückgesetztes Edge-Bild zurückgegeben hat. Dies ist ein Ausgangs-Socket.

Hinweis: Dies sind Ausgangs-Sockets.

🕹️ Steuerungen

• Select folder Schaltfläche zum Auswählen des Standardordners, der verwendet wird, wenn Folder Path leer ist.

• Glob pattern Textfeld zum Filtern von Dateien mittels Python-Glob-Syntax (Beispiele: *, *.png, **/*).

• Mode Dropdown zur Steuerung der Wiedergaberichtung: Forward, Backward oder Stop.

• Order Dropdown zur Auswahl der Dateireihenfolge: Name (natürliche Sortierung nach Dateinamen) oder Time (Datum der letzten Änderung).

Hinweis: Dies sind sichtbare Widgets, die beeinflussen, wie der Block Dateien auswählt und zurückgibt.

🎨 Funktionen

• Playlist-Verwaltung: Baut und cacht eine Liste von Bilddateien auf Basis des gewählten Ordners, des Glob-Musters und der Reihenfolge.

• Flexible Wiedergabe: Unterstützt Forward, Backward und Stop mit Wrap-Around-Verhalten.

• Ordnerüberschreibung: Laufzeitüberschreibung über die Eingabe Folder Path, ohne den gespeicherten Standard zu ändern.

• Restart-Behandlung: Die explizite Eingabe Restart setzt die Wiedergabe zurück und liefert das Edge-Bild bei dieser Auswertung.

• Dateimetadaten-Ausgabe: Gibt den absoluten Pfad zurück, nützlich für Protokolle oder nachgelagerte Verarbeitung.

• Optionales asynchrones Frame-Upload: Falls verfügbar, können Frames im Hintergrund für Remote-Logging hochgeladen werden.

⚙️ Ausführungsmechanismus

Bei jeder Auswertung bestimmt der Block den effektiven Ordner (Standard oder überschrieben), prüft das Glob-Muster und die Order-Einstellung und aktualisiert bei Bedarf seine interne Playlist. Er verfolgt den aktuellen Index und gibt das Bild an dieser Position zusammen mit dem Dateipfad und dem Restarted-Flag zurück. Nach dem Zurückgeben bereitet der Block den nächsten Index gemäß dem ausgewählten Mode (Forward/Backward/Stop) vor und wickelt bei Bedarf an den Anfang oder das Ende.

📝 Nutzungshinweise

1. Klicken Sie auf die Schaltfläche Select folder, um einen Standardordner zu wählen, oder lassen Sie sie leer und geben Sie zur Laufzeit einen Pfad über die Eingabe Folder Path an.

2. Geben Sie ein Glob pattern ein, um Dateien zu filtern (verwenden Sie * für alle Dateien oder *.jpg / **/*.png für spezifische Typen).

3. Wählen Sie Mode, um vorwärts zu gehen, zurückzuschalten oder das aktuelle Bild zwischen den Auswertungen zu halten.

4. Wählen Sie Order, um Dateien nach Name oder Änderungszeit zu sortieren.

5. Senden Sie optional Restart = True, um die Wiedergabe auf das Edge-Bild des aktuellen Modus zurückzusetzen.

💡 Tipps und Tricks

• Vorschau: Leiten Sie den Image-Ausgang in den Block Show Image, um Bilder interaktiv in größerer Ansicht beim Durchschreiten des Ordners anzusehen.

• Frame speichern: Speichern Sie interessante Frames mit Image Write oder exportieren Sie Beispiele im Batch mit Image Logger, angeschlossen an den Image-Ausgang.

• Größe reduzieren: Wenn Bilder zu groß für nachgelagerte AI-Blöcke sind, verwenden Sie Image Resize oder Image Resizer nach dem Image-Ausgang, um die Verarbeitung zu beschleunigen.

• Fokusbereich: Um sich auf einen bestimmten Bereich jedes Bildes zu konzentrieren, fügen Sie nach diesem Block Image ROI Select (oder Image ROI) hinzu und übergeben Sie das zugeschnittene Ergebnis an Detektoren wie Find Object oder Mask Detection.

• Kombinationen: Für visuelle Berichte oder kombinierte Ansichten sammeln Sie mehrere Frames und geben sie an Collage Images oder Image Concatenate weiter.

• Dataset-Workflows: Verwenden Sie den File Path-Ausgang, um Protokolle oder CSV-Dateien zusammen mit den Bilddaten über Exportblöcke zu erstellen.

(Hinweis: Kombinieren Sie nur mit den in der Umgebung verfügbaren Funktionsblöcken.)

🛠️ Fehlersuche

• Keine Dateien gefunden: Prüfen Sie, ob der ausgewählte Ordner unterstützte Bildendungen enthält und ob das Glob pattern zu Ihren Dateinamen passt.

• Ungültige Ordnerüberschreibung: Stellen Sie sicher, dass die Eingabe Folder Path ein nicht-leerer String ist und auf ein existierendes Verzeichnis zeigt.

• Unerwartete Reihenfolge: Verwenden Sie Order = Time, um nach Änderungszeit zu sortieren; verwenden Sie Name für eine vorhersagbare Dateinamenreihenfolge (natürliche Sortierung berücksichtigt numerische Teile).

• Wiedergabe bleibt stehen: Überprüfen Sie, ob die Einstellung Mode nicht auf Stop steht und ob der Block tatsächlich Auswertungen erhält (einige Laufmodi führen nur bei Ausführung des Szenarios aus).