SAMLoader (Pipe)(samLoaderForDetailerFix)

SAMLoader (Pipe) associe un checkpoint SAM (Segment Anything Model) aux options d'indice de détection et de traitement du masque utilisées par les flux de travail Detailer Fix. C'est l'équivalent compatible pipe d'un chargeur SAM simple : au lieu d'exposer un modèle SAM brut, il produit un PIPE_LINE qui transporte à la fois le modèle et les paramètres de segmentation, afin que les nœuds EasyUse Detailer Fix en aval puissent appliquer un affinage SAM cohérent.

Entrées

model_name

Sélectionnez le checkpoint SAM à charger. La liste déroulante affiche les checkpoints SAM disponibles dans votre répertoire de modèles ComfyUI.

device_mode

Sélectionne l'appareil utilisé pour l'inférence SAM. AUTO permet à ComfyUI de choisir automatiquement l'appareil, Prefer GPU utilise le GPU lorsqu'il est disponible et revient au CPU sinon, et CPU force l'exécution sur CPU. Utilisez CPU sur les systèmes à faible VRAM pour réduire la pression mémoire.

sam_detection_hint

Contrôle le type d'indice généré à partir du masque ou de la détection existants avant l'exécution de SAM. Options :

• center-1 — utilise un seul point au centre.
• horizontal-2 — utilise deux points le long d'une ligne horizontale.
• vertical-2 — utilise deux points le long d'une ligne verticale.
• rect-4 — utilise quatre points d'angle d'un rectangle.
• diamond-4 — utilise quatre points d'angle en losange.
• mask-area — utilise la zone du masque elle-même comme indice.
• mask-points — utilise des points échantillonnés depuis le masque.
• mask-point-bbox — utilise des points échantillonnés depuis le masque ainsi qu'une boîte englobante.
• none — désactive les indices de points/masque ; SAM s'appuie sur le prompt de la boîte englobante.

sam_dilation

Dilatation appliquée au masque utilisé pour la détection SAM, en pixels. Les valeurs positives agrandissent le masque ; les valeurs négatives l'érodent ou le réduisent. Utilisez une dilatation positive pour ajouter du contexte environnant ou une dilatation négative pour resserrer les bords de masque trop lâches.

sam_threshold

Seuil de 0 à 1 (défaut 0.93) appliqué au masque de prédiction SAM lors de sa conversion en masque binaire. Des valeurs plus élevées ne conservent que les prédictions SAM les plus fortes ; des valeurs plus basses acceptent une plus grande zone.

sam_bbox_expansion

Nombre de pixels d'expansion de la boîte englobante détectée avant de la transmettre à SAM. Des valeurs plus grandes donnent à SAM plus de contexte environnant ; 0 conserve la boîte détectée inchangée.

sam_mask_hint_threshold

Seuil de 0 à 1 (défaut 0.7) utilisé lorsqu'un indice de masque est actif. Les pixels au-dessus de cette valeur sont traités comme premier plan pour l'indice de masque. Des valeurs plus basses incluent une plus grande partie du masque d'indice généré.

sam_mask_hint_use_negative

Contrôle si des indices négatifs de masque/points sont fournis à SAM et de quelle manière :

• False — ne fournit pas d'indices négatifs.
• Small — fournit une petite zone d'indice négatif autour de la cible.
• Outter — fournit des indices négatifs dans la région externe autour de la cible.

L'orthographe Outter est conservée telle quelle à partir de la liste d'options du nœud.

Sorties

PIPE_LINE

Un pipeline contenant le modèle SAM chargé et les paramètres configurés : indice de détection, dilatation, seuil, expansion de la boîte englobante, seuil d'indice de masque et indices négatifs. Passez ce pipe dans un nœud Detailer Fix qui accepte une entrée PIPE_LINE. Il ne s'agit pas d'une sortie SAM_MODEL brute, il ne peut donc pas être connecté directement à des nœuds qui attendent un modèle SAM simple.

Notes d'utilisation

• Les paramètres par défaut sont réglés pour l'affinage Detailer Fix typique : appareil AUTO, indice center-1, aucune dilatation, seuil 0.93, aucune expansion de boîte englobante, seuil d'indice de masque 0.7 et aucun indice négatif.
• Si les masques SAM manquent des structures fines ou petites, abaissez sam_threshold ou ajoutez une petite sam_dilation positive.
• Si les masques débordent dans l'arrière-plan, augmentez sam_threshold, appliquez une sam_dilation négative ou définissez sam_mask_hint_use_negative sur Small ou Outter.
• sam_bbox_expansion est utile lorsque la boîte détectée coupe le sujet ; l'agrandir permet à SAM de voir davantage la limite de l'objet avant d'affiner le masque.