For the complete documentation index, see llms.txt. This page is also available as Markdown.

HSV Filter

Ce bloc vous permet d'isoler des couleurs dans une image en ajustant les plages de Hue, Saturation et Value. Utilisez-le pour créer des masques de couleur, extraire des régions colorées ou combiner premier plan et arrière-plan pour la visualisation.

📥 Inputs

Ce bloc possède la prise d'entrée suivante :

  • Image Any Prise d'entrée qui accepte l'image à traiter.

📤 Outputs

Ce bloc fournit les prises de sortie suivantes :

  • Result Image Image filtrée montrant uniquement les pixels dans les plages HSV sélectionnées (premier plan).

  • HSV Image Représentation convertie en HSV de l'image d'entrée.

  • Masked Image Masque binaire / niveaux de gris (un canal) montrant quels pixels ont passé le test HSV.

  • Added Image Premier plan mélangé avec l'arrière-plan pour une visualisation facilitée.

  • Background Image Portion d'arrière-plan (niveaux de gris) où les pixels masqués sont retirés.

🕹️ Controls

  • Hue (Min-Max) Paire de curseurs pour définir la borne inférieure et supérieure de la teinte.

  • Saturation (Min-Max) Paire de curseurs pour définir la borne inférieure et supérieure de la saturation.

  • Value (Min-Max) Paire de curseurs pour définir la borne inférieure et supérieure de la valeur/luminosité.

Ajustez ces curseurs jusqu'à ce que le Masked Image mette en évidence la plage de couleur cible tout en excluant les zones indésirables.

🎯 Features

  • Sélection visuelle et interactive des couleurs avec trois curseurs de plage.

  • Prévisualisation en direct du masque pour valider rapidement la sélection de couleurs.

  • Sorties fournissant à la fois le masque et des visualisations pour analyse ou traitement en aval.

  • Combine le premier plan masqué avec un arrière-plan en niveaux de gris pour vérifier les régions extraites.

📝 How to use

  1. Connectez un bloc producteur d'images à l'entrée Image Any.

  2. Déplacez les curseurs Hue (Min-Max), Saturation (Min-Max) et Value (Min-Max) pour isoler la couleur souhaitée.

  3. Inspectez le Masked Image pour confirmer la sélection.

  4. Utilisez Result Image ou Added Image pour des sorties visuelles, et Masked Image pour un traitement ultérieur ou des mesures.

⚙️ What happens when it runs

À l'exécution, le bloc convertit l'image d'entrée en espace HSV, construit un masque binaire à partir des plages des curseurs, produit une image colorée masquée (premier plan), un arrière-plan en niveaux de gris et une visualisation combinée pour une validation rapide.

💡 Tips and Tricks

  • Prétraitement pour réduire le bruit : passez l'entrée via Blur avant ce bloc pour lisser les images bruyantes et obtenir des masques plus propres.

  • Meilleure séparation pour les grandes images : utilisez Image Resize pour réduire la taille pendant le réglage interactif, puis traitez en pleine résolution une fois les paramètres finalisés.

  • Concentrez-vous sur la zone d'intérêt : recadrez l'entrée avec Image ROI Select avant d'appliquer HSV pour éviter les confusions de couleur dues aux régions environnantes.

  • Affiner le masque : combinez le Masked Image de ce bloc avec Apply Mask pour filtrer une autre image, ou enchaînez avec Image Threshold pour un nettoyage binaire supplémentaire.

  • Inspection visuelle : connectez la sortie à Show Image pour ouvrir le visualiseur et examiner les résultats dans une fenêtre plus grande.

  • Enregistrer les résultats : utilisez Image Logger ou Image Write pour sauvegarder les masques ou visualisations une fois les réglages souhaités obtenus.

  • Utilisation avec des détecteurs : après avoir isolé une région colorée, transmettez l'image masquée ou Result Image à des blocs de détection comme Find Object ou Blob Detector pour localiser des caractéristiques correspondant à la couleur sélectionnée.

  • Analyse d'arrière-plan : combinez avec Background Subtractor pour les flux vidéo afin de séparer les objets colorés en mouvement d'un arrière-plan statique.

🛠️ Troubleshooting

  • Peu ou pas de masque en sortie : vérifiez que vos curseurs couvrent la bonne plage de teinte pour la couleur cible et que l'image d'entrée est prise dans des conditions d'éclairage normales.

  • Masque trop large : resserrez les plages de Saturation (Min-Max) et Value (Min-Max) pour exclure les couleurs similaires indésirables et les reflets.

  • Bruit excessif dans le masque : ajoutez un Blur ou exécutez des blocs de nettoyage morphologique / Image Threshold après le masque pour supprimer les petites taches.

  • Problèmes de performance : redimensionnez l'image avec Image Resize pour l'ajustement interactif ; appliquez les paramètres sur la résolution complète uniquement quand vous êtes prêt.

Si vous avez besoin de conseils plus ciblés (type de caméra, couleur cible, temps réel vs hors ligne, etc.), décrivez votre scénario et on vous proposera les combinaisons de blocs recommandées.

Mis à jour