> 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/function-blocks/input-output/image-inputs/play-folder.md). # 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). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.augelab.com/german/function-blocks/input-output/image-inputs/play-folder.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.