Play Folder

Ce bloc de fonction lit des images depuis un dossier sélectionné et renvoie un fichier par évaluation. Utilisez-le pour parcourir des jeux d'images pas à pas, prévisualiser des séquences ou fournir des images à des blocs de traitement en aval. Vous pouvez choisir un dossier par défaut avec le bouton Select folder, le remplacer via l'entrée Folder Path, filtrer les fichiers avec un motif glob, et contrôler la lecture avec les contrôles Mode et Order.

📥 Entrées

Folder Path Chaîne optionnelle qui remplace le dossier par défaut choisi avec le bouton. Fournissez un chemin de dossier complet pour changer la source à l'exécution.

Restart Entrée booléenne optionnelle. Lorsqu'elle est à True, le bloc réinitialise la lecture pour le Mode courant et renvoie l'image de bord réinitialisée sur cette évaluation.

Remarque : ce sont des prises d'entrée (input sockets).

📤 Sorties

Image L'image courante lue depuis le dossier. C'est une sortie d'image (image output socket).

File Path Chemin absolu du fichier image courant. C'est une sortie de type chaîne (string output socket).

Restarted Booléen à True si le bloc a renvoyé une image d'arrêt ou réinitialisée sur cette évaluation. C'est une prise de sortie.

Remarque : ce sont des prises de sortie (output sockets).

🕹️ Contrôles

Select folder Bouton pour choisir le dossier par défaut utilisé lorsque Folder Path est vide.

Glob pattern Champ texte pour filtrer les fichiers en utilisant la syntaxe Python glob (exemples : *, *.png, **/*).

Mode Menu déroulant pour contrôler la direction de lecture : Forward, Backward ou Stop.

Order Menu déroulant pour sélectionner l'ordre des fichiers : Name (tri naturel par nom de fichier) ou Time (date de modification du fichier).

Remarque : ce sont des widgets visibles qui déterminent comment le bloc sélectionne et renvoie les fichiers.

🎨 Fonctionnalités

• Gestion de playlist : construit et met en cache la liste des fichiers image correspondant au dossier choisi, au Glob pattern et à l'Order.

• Lecture flexible : prend en charge les modes Forward, Backward et Stop avec comportement de bouclage.

• Remplacement de dossier à l'exécution : possibilité de remplacer la source via l'entrée Folder Path sans modifier le dossier par défaut enregistré.

• Gestion du redémarrage : l'entrée Restart réinitialise explicitement la lecture et renvoie l'image d'extrémité sur cette évaluation.

• Métadonnées de fichier : renvoie le chemin absolu pour journalisation ou traitement en aval.

• Téléversement de trames asynchrone optionnel : si disponible, les trames peuvent être téléversées en arrière-plan pour journalisation distante.

⚙️ Mécanisme d'exécution

À chaque évaluation, le bloc détermine le dossier effectif (par défaut ou remplacé), vérifie le Glob pattern et l'Order, et met à jour sa playlist interne si nécessaire. Il suit l'index courant et renvoie l'image correspondant à cet index ainsi que son chemin de fichier et le flag Restarted. Après avoir renvoyé l'image courante, le bloc prépare l'index suivant en fonction du Mode sélectionné (Forward/Backward/Stop), en effectuant un retour au début ou à la fin si nécessaire.

📝 Instructions d'utilisation

1. Cliquez sur le bouton Select folder pour choisir un dossier par défaut, ou laissez-le vide et fournissez un chemin à l'exécution via l'entrée Folder Path.

2. Saisissez un Glob pattern pour filtrer les fichiers (utilisez * pour tout ou *.jpg / **/*.png pour des types spécifiques).

3. Choisissez Mode pour avancer, reculer ou maintenir l'image courante entre les évaluations.

4. Choisissez Order pour trier les fichiers par nom ou par date de modification.

5. Envoyez éventuellement Restart = True pour réinitialiser la lecture sur l'image de bord du mode courant.

💡 Conseils et astuces

• Prévisualisez les images dans une fenêtre plus grande en envoyant la sortie Image vers le bloc Show Image pour un affichage interactif lors du parcours du dossier.

• Sauvegardez les images intéressantes avec Image Write ou exportez des exemples en lot avec Image Logger connecté à la sortie Image.

• Si les images sont trop volumineuses pour les blocs IA en aval, connectez Image Resize ou Image Resizer après la sortie Image pour réduire le temps de traitement.

• Pour vous concentrer sur une zone spécifique de chaque image avant l'analyse, enchaînez Image ROI Select (ou Image ROI) après ce bloc et alimentez les détecteurs tels que Find Object ou Mask Detection avec le résultat recadré.

• Pour des rapports visuels ou des vues combinées, regroupez plusieurs trames et passez-les à Collage Images ou Image Concatenate.

• Lors de la création de flux basés sur des jeux de données, utilisez la sortie File Path pour créer des journaux ou des CSV parallèlement aux données d'image via des blocs d'exportation de données.

(astuce : combinez uniquement avec les blocs de fonction listés et disponibles dans l'environnement.)

🛠️ Dépannage

• Aucun fichier trouvé : Vérifiez que le dossier sélectionné contient des extensions d'image prises en charge et que le Glob pattern correspond bien aux noms de fichiers.

• Remplacement de dossier invalide : Assurez-vous que l'entrée Folder Path est une chaîne non vide et pointe vers un répertoire existant.

• Ordre inattendu : Utilisez Order = Time pour trier par horodatage de modification ; utilisez Name pour un ordre prévisible par nom de fichier (le tri naturel gère les parties numériques).

• Lecture qui n'avance pas : Vérifiez que Mode n'est pas sur Stop et que le bloc reçoit des évaluations (certains modes d'exécution n'exécutent le scénario que lorsqu'il est lancé).