nodes/da2el-ai-D2-nodes-ComfyUI
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
21917ebcdd68f57dbabfcad9ef344eacb643dd31
da2el-ai-D2-nodes-ComfyUI/docs/ja/node_image.md
T
da2el-alandClaude Opus 4.7 21917ebcdd docs: document round_to option for D2_CutByMask 
Add the round_to input description to the D2 Cut By Mask entry
and a Changelog entry, across ja / en / zh.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-06-15 13:08:34 +09:00

13 KiB
Raw Blame History

English | 日本語 | 繁体中文

Node

🍅 Image Node

D2 Preview Image

  • Popup Image: ボタンをクリックすると全画面ギャラリーが表示される

D2 Save Image

▲filenames には保存した画像のパスが出力される
  • D2 Preview Image と同じく、全画面ギャラリー機能を搭載した画像保存ノード
  • 画像フォーマットは PNG / JPEG / WEBP / アニメーションWEBP に対応
  • A1111方式の生成パラメーターをメタデータに保存する（PNG / JPEG / WEBP形式のみ）
  • 保存した画像を D2 Load Image から読み込むと positive, negative プロンプトを取り出し可能（PNG / JPEG / WEBP形式のみ）
▲d2_pipeから生成パラメーターを取得し、メタデータに保存

Input

  • images: 保存する画像
  • d2_pipe: D2 KSampler などから生成パラメーターを受け取る
  • filename_prefix: ファイルネーム書式。詳細は D2 Filename Template 参照
  • preview_only:
    • true: 画像を保存せず、プレビュー表示だけになる
    • false: 画像を保存する
  • format: 画像フォーマットを png / jpeg / webp / animated_webp から選択
  • lossless: webp、animated_webp で適用
    • true:可逆圧縮
    • false:不可逆圧縮。
  • quality: 画像圧縮率。jpeg または webp、animated_webp で losless:false の時に適用
  • fps: animated_webp のフレームレート
  • Popup Image: ボタンをクリックすると全画面ギャラリーが表示される

Output

  • filenames: 保存した画像ファイルのフルパス配列

D2 Save Image Eagle

D2 Send Eagle との違い

  • アニメーションWEBPに対応
  • 全画面ギャラリー機能
  • ファイル名のルールが標準に Save Image に準拠
  • タグの保存機能を除外

Input

  • eagle_folder: Eagleの登録フォルダ。フォルダ名、フォルダIDどちらでも可能
  • memo_text: Eagleのメモとして登録するテキスト

StableDiffusion A1111 webui のようなパラメーターをEagleメモに記録するには

自動で作成

D2 Ksampler から d2_pipe を接続するとEagle用メモに保存される。

独自形式で作成

動画など複雑な生成パラメーターをしたい時などは、独自のメモを記録することも可能。

D2 Filename Template2 を使ってテンプレート化し、D2 Save Image Eagle の memo_text に入力します。

上のサンプルでは D2 KSampler から positive negative を arg_1 arg_2 に入力して %arg_1% %arg_2% で取得、その他のパラメーターは %{ノード名}.{Param} で取得しています。

パラメーター取得方法の詳細は D2 Filename Template をご覧下さい。

%arg_1%

Negative prompt: %arg_2%
Steps: %D2 KSampler.steps%, Sampler: %D2 KSampler.sampler_name% %D2 KSampler.scheduler%, CFG scale: %D2 KSampler.cfg%, Seed: %D2 KSampler.seed%, Size: %Empty Latent Image.width%x%Empty Latent Image.height%, Model: %D2 Checkpoint Loader.ckpt_name%

出力結果

masterpiece, 1girl, bikini, blue sky,

Negative prompt: bad quality, worst quality, sepia,
Steps: 20, Sampler: euler_ancestral simple, CFG scale: 5.000000000000001, Seed: 926243299419009, Size: 768x1024, Model: _SDXL_Illustrious\anime\HiyokoDarkness_vpred_v2_20250329.safetensors

D2 Send File Eagle

  • file_path で入力されたパスのファイルをEagleに登録する
  • Video Combine の出力ファイルをEagleに登録するために作りました
  • D2 File Template2 を使って memo_text に入力すれば動画生成パラメーターの保存も可能
file_path について

ファイルのフルパスを文字列、または文字列の配列で与える。

例：文字列

D:\ComfyUI\output\foo.png

例：文字列の配列

["D:\ComfyUI\output\foo.png","D:\ComfyUI\output\bar.png"]
Video Combine が出力する Filenames について

Video Combine が出力する Filenames は以下のような配列になっています。

[
  true, 
  [
    "D:\\ComfyUI\\output\\AnimateDiff_00002.png",
    "D:\\ComfyUI\\output\\AnimateDiff_00002.mp4"
  ]
]

上の画像では ComfyUI-List-Utils に含まれる Exec ノードによってファイル名の部分を抜き出しています。

D2 Load Image

  • 画像からプロンプトを取得できる Load Image ノード
  • StableDiffusion webui A1111、NovelAI で作成した画像にも対応
  • マスクエディターを開くボタンが付いてる

Input

  • image_path
    • 画像のパスを入力するとファイルを読み込む
    • D2 Folder Image Queue との接続に使用する

Output

  • IMAGE / MASK: 画像とマスク
  • width / height: 画像サイズ
  • positive / negative: プロンプト
  • filename / filepath: 保存したファイルの名前、パス
  • pnginfo: 画像のメタデータ

プロンプトの出力について

下記のノード、UIで保存した画像に対応しています。

注意：マスクエディタを使うとプロンプトが抽出できません

マスクエディタで編集すると ComfyUI が新しい画像ファイルを書き出して内部的に置き換わるため、元画像のメタデータが失われプロンプトを抽出できなくなります。マスクをクリアしても置き換わったままです。

対応策として、プロンプト抽出専用の D2 Load Image をもう一つ追加し、そちらではマスクエディタを使わないようにすることで回避できます。

D2 Load Folder Images

  • フォルダー内の画像を一括ロードしてまとめて出力する
  • D2 Grid Image などで使う
  • 順次処理をしたいなら D2 Folder Image Queue を使う

Input

  • folder
    • フォルダーをフルパスで指定
  • extension
    • JPEG画像だけを読み込むなら *.jpg のように指定する
    • *silver*.webp のような指定も可能

D2 Folder Image Queue

  • フォルダ内の画像のパスを出力する
  • Queue を実行すると画像枚数分の Queue を自動的に実行する

Input

  • folder
    • 画像フォルダ
  • extension
    • ファイル名のフィルタを指定
    • *.*: 全ての画像
    • *.png: PNG形式のみ対象
  • start_at
    • 処理を開始する画像番号
  • auto_queue
    • true: 残りの Queue を自動的に実行する
    • false: 1回だけ実行する

Output

  • image_path
    • 画像のフルパス

D2 Grid Image

  • グリッド画像を出力する
  • 横方向、縦方向、どちらも可能

Input

  • max_columns
    • 横方向に整列する画像の枚数
    • swap_dimensions が true の時は縦方向の枚数
  • grid_gap
    • 画像の間隔
  • swap_dimensions
    • true: 縦方向
    • false: 横方向
  • trigger_count
    • 入力画像がここで指定した枚数になったらグリッド画像を出力する
  • Image count
    • 入力した画像の枚数
  • Reset Images
    • 入力した画像を破棄する

D2 Image Stack

  • 入力された複数の画像をバッチにまとめる
  • D2 Grid Image などで使える
  • 最大50個入力まで

D2 Image Mask Stack

  • 入力された複数の画像とマスクをバッチにまとめる
  • D2 Image Stack にマスクを追加したもの

D2 EmptyImage Alpha

  • EmptyImage にαチャンネル（透明度）を追加

D2 Mosaic Filter

  • モザイクフィルターをかける
  • 透明度、明るさ、色の反転などを設定可能

D2 Cut By Mask

  • マスクで画像をカットする
  • 出力する形状、サイズ、余白などを指定できる

Input

  • images: 切り出し元画像
  • mask: マスク
  • cut_type: 切り取る画像の形状
    • mask: マスクの形状通りに切り取る
    • rectangle: マスク形状から長方形を算出して切り取る
    • square_thumb: 最大サイズの正方形で切り取る。サムネイル向けモード
  • output_size: 出力する画像サイズ
    • mask_size: マスクのサイズ
    • image_size: 入力画像のサイズ（入力画像の位置を保持した状態で周囲が透明になる）
  • round_to: 切り出す短形の幅・高さを指定単位に切り上げる（初期値 none）
    • none / 8px / 16px / 32px / 64px から選択
    • cut_type が rectangle の時のみ有効（mask / square_thumb では無視）
    • 8px単位で生成するローカルモデルでエッジがボケるのを防ぐ用途。中心を保ったまま拡張し、元画像の外側には広げない
  • padding: マスクエリアを拡張するピクセル数（初期値 0）
  • min_width: マスクサイズの最小幅（初期値 0）
  • min_height: マスクサイズの最小高さ（初期値 0）
  • output_alpha: 出力画像にαチャンネルを含めるか

output

  • image: マスク領域で切り取った画像
  • mask: マスク
  • rect: 切り取った短形領域

D2 Paste By Mask

  • D2 Paste By Mask で作成したマスクや短形領域を使って画像を合成する
  • ボカし幅、貼り付け形状などが指定できる

Input

  • img_base: 下地になる画像（batch対応）
  • img_paste: 貼りつける画像（batch対応）
  • paste_mode: img_paste のトリミング方法と貼り付け座標を決める
    • mask: img_paste を mask_opt でマスキングして x=0, y=0 の位置に貼りつける（マスク形状貼り付け）
    • rect_full: img_paste を rect_opt のサイズでトリミングして rect_opt の位置に貼りつける（短形貼り付け）
    • rect_position: img_paste を rect_opt の位置に貼りつける（短形貼り付け）
    • rect_pos_mask: img_paste を mask_opt でマスキングして rect_opt の位置に貼りつける（マスク形状貼り付け）
  • multi_mode: img_base, img_paste のどちらか、または両方が複数枚だった時の処理
    • pair_last: img_base, img_paste を先頭から同じインデックスのペアで処理する。片方の数が少ない時は最後の画像が採用される
    • pair_only: pair_lastと同じ。片方の数が少ない時は処理前にエラーを表示して止まる
    • cross: 全ての組み合わせを処理する

input optional:

  • mask_opt: マスク
  • rect_opt: 短形領域
  • feather: エッジをボカすpx数（初期値 0）

output

  • image: 合成した画像

multi_mode について

pair_last pair_only は img_base と img_paste の同じ順番の画像でペアとして出力する。

cross は全ての組み合わせを出力する。

Reference in New Issue View Git Blame Copy Permalink