Apply Mask

Ce bloc de fonction applique un masque (image binaire, niveaux de gris ou couleur) à une image afin de conserver ou d'enlever des zones spécifiques. Il est conçu pour des flux de travail simples de segmentation et de masquage dans AugeLab Studio.

📥 Entrées

• Image — Image principale à filtrer (prise d'entrée).

• Mask — Image de masque définissant les zones à conserver (prise d'entrée). Accepte une image binaire, en niveaux de gris ou en couleur. Le bloc interprète les pixels clairs/blancs du masque comme des zones conservées et les pixels sombres comme des zones supprimées.

📤 Sorties

• Filtered — Image résultante après application du masque (prise de sortie).

🕹️ Contrôles

Ce bloc n'a pas de réglages supplémentaires ou de widgets. Il applique simplement le masquage à partir des deux entrées fournies.

🎨 Fonctionnalités

• Fonctionne avec des images couleur (RGB) et en niveaux de gris.

• Accepte des masques en niveaux de gris ou en couleur ; le masque est interprété comme une carte conserver/retirer.

• Conserve les pixels de l'image là où le masque est clair/blanc et masque (ou remplace par noir) les pixels là où le masque est sombre/noir.

• Conçu pour un filtrage visuel rapide dans des chaines de traitement.

⚙️ Mécanisme d'exécution

Lors de l'exécution, le bloc vérifie les deux entrées, s'assure que le masque peut être utilisé comme sélecteur binaire, puis applique le masque à l'image principale. La sortie est l'image d'origine avec les zones non masquées supprimées (ou mises en noir) selon le masque.

📝 Instructions d'utilisation

1. Fournissez l'image à filtrer sur l'entrée Image.

2. Fournissez une image de masque sur l'entrée Mask. Les régions claires/blanches du masque seront conservées dans la sortie ; les régions sombres/noires seront supprimées.

3. Connectez la sortie Filtered aux blocs suivants (visualisation, enregistrement ou traitement ultérieur).

Conseils rapides :

• Si le masque et l'image n'ont pas la même taille, redimensionnez ou recadrez pour qu'ils correspondent avant de les connecter.

• Si le masque est grossier, combinez ce bloc avec des étapes morphologiques ou de lissage pour affiner le résultat.

💡 Astuces et bonnes pratiques

• Créez des masques à partir d'intensités avec les blocs Image Threshold ou Image Adaptive Threshold avant de les fournir.

• Réduisez le bruit dans la source du masque avec Blur ou Denoising pour éviter de petits trous indésirables.

• Améliorez la séparation avant/arrière-plan avec HSV Filter lorsque la couleur est un indice fort, puis convertissez ce résultat en masque pour ce bloc.

• Pour une extraction de sujet de meilleure qualité, essayez Background Removal (RMBG-1.4) ou Background Removal (BiRefNet) et utilisez le masque ou le détourage produit.

• Utilisez Morphological Transformations (érosion/dilatation) pour nettoyer de petits artefacts du masque avant application.

• Recadrez ou concentrez le traitement avec Image ROI Select ou Image ROI afin que le masque et l'image s'alignent sur la zone d'intérêt.

• Prévisualisez les résultats avec Show Image et enregistrez les sorties réussies avec Image Logger ou Image Write.

🛠️ Dépannage

• Le masque ne semble rien faire : Vérifiez que le Mask est bien aligné avec l'Image et que les zones claires correspondent aux régions à conserver. Si les tailles diffèrent, utilisez Image Resize ou recadrez avec Image ROI Select.

• La sortie contient des taches ou des trous : Appliquez Blur ou des Morphological Transformations au masque pour supprimer les petits défauts.

• Aucune différence visible après le masquage : Vérifiez que le masque contient bien des régions non noires. Utilisez Image Threshold pour binariser un masque incertain.

• Besoin d'inspecter des résultats intermédiaires : Insérez un Show Image après les étapes de création du masque pour vérifier sa correction avant application.

📊 Évaluation

À l'exécution, ce bloc produit l'image Filtered. Utilisez cette sortie pour visualiser, sauvegarder ou l'envoyer vers des blocs d'analyse ultérieurs (détection, mesure, etc.).