SAMLoader (Pipe)(samLoaderForDetailerFix)

SAMLoader (Pipe) は、Detailer Fix ワークフローで使用される検出ヒントとマスク処理オプションを、SAM（Segment Anything Model）チェックポイントとともにバンドルします。これは通常の SAM ローダーのパイプ対応版です。生の SAM モデルを公開する代わりに、モデルとセグメンテーション設定の両方を保持する PIPE_LINE を生成するため、後続の EasyUse Detailer Fix ノードは一貫した SAM ベースのリファインメントを適用できます。

入力

model_name

読み込む SAM チェックポイントを選択します。ドロップダウンには、ComfyUI のモデルディレクトリにある利用可能な SAM チェックポイントが一覧表示されます。

device_mode

SAM 推論に使用するデバイスを選択します。AUTO は ComfyUI がデバイスを自動的に選択し、Prefer GPU は利用可能な場合は GPU を使用して、それ以外の場合は CPU にフォールバックし、CPU は CPU 実行を強制します。低 VRAM システムでは CPU を使用して、メモリ負荷を軽減してください。

sam_detection_hint

SAM の実行前に、既存のマスクまたは検出から生成されるヒントの種類を制御します。オプション:

• center-1: 中心に単一のポイントを使用します。
• horizontal-2: 水平線に沿って 2 つのポイントを使用します。
• vertical-2: 垂直線に沿って 2 つのポイントを使用します。
• rect-4: 長方形の 4 つの角ポイントを使用します。
• diamond-4: ひし形の 4 つの角ポイントを使用します。
• mask-area: マスク領域自体をヒントとして使用します。
• mask-points: マスクからサンプリングされたポイントを使用します。
• mask-point-bbox: マスクからサンプリングされたポイントとバウンディングボックスを使用します。
• none: ポイント/マスクヒントを無効にします。SAM はバウンディングボックスのプロンプトに依存します。

sam_dilation

SAM 検出に使用されるマスクに適用される膨張量（ピクセル単位）。正の値はマスクを拡張し、負の値はマスクを収縮/縮小します。正の膨張を使用して周囲のコンテキストを追加するか、負の膨張を使用して緩んだマスクのエッジを引き締めます。

sam_threshold

SAM 予測マスクをバイナリマスクに変換する際に適用される閾値（0 から 1、デフォルト 0.93）。値が高いほど最も強い SAM 予測のみを保持し、値が低いほどより多くの領域を受け入れます。

sam_bbox_expansion

SAM に渡す前に、検出されたバウンディングボックスを展開するピクセル数。値が大きいほど SAM に多くの周囲コンテキストが与えられ、0 の場合は検出されたボックスを変更しません。

sam_mask_hint_threshold

マスクヒントがアクティブな場合に使用される閾値（0 から 1、デフォルト 0.7）。この値を超えるピクセルはマスクヒントの前景として扱われます。値が低いほど、生成されたヒントマスクのより多くの部分が含まれます。

sam_mask_hint_use_negative

ネガティブなマスク/ポイントヒントを SAM に供給するかどうか、およびその方法を制御します:

• False: ネガティブヒントを供給しません。
• Small: ターゲットの周囲に小さなネガティブヒント領域を供給します。
• Outter: ターゲットの外側の領域にネガティブヒントを供給します。

Outter という表記は、ノードのオプションリストからのそのままの表記です。

出力

PIPE_LINE

読み込まれた SAM モデルと、設定済みの検出ヒント、膨張、閾値、ボックス展開、マスクヒント閾値、ネガティブヒント設定を含むパイプライン。このパイプを PIPE_LINE 入力を受け付ける Detailer Fix ノードに渡します。これは生の SAM_MODEL 出力ではないため、通常の SAM モデルを期待するノードに直接接続することはできません。

使用上の注意

• デフォルト設定は、一般的な Detailer Fix リファインメント用に調整されています: AUTO デバイス、center-1 ヒント、膨張なし、0.93 閾値、ボックス展開なし、0.7 マスクヒント閾値、ネガティブヒントなし。
• SAM マスクが細い構造や小さな構造を見逃す場合は、sam_threshold を下げるか、小さな正の sam_dilation を追加します。
• マスクが背景ににじむ場合は、sam_threshold を上げるか、負の sam_dilation を適用するか、sam_mask_hint_use_negative を Small または Outter に設定します。
• sam_bbox_expansion は、検出されたボックスが被写体を切り取る場合に便利です。ボックスを展開すると、SAM はマスクをリファインする前にオブジェクトの境界をより多く確認できます。