da2el-alandClaude Opus 4.7
56a84b7534
Add a TIPS section to the XY Plot docs explaining the x_list > y_list processing order and recommending y_list for heavy tasks like checkpoint loading, rename the Easy heading to cover Easy Mini, and link the XY Plot and automatic mosaic note articles. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
447 lines
14 KiB
Markdown
447 lines
14 KiB
Markdown
<img src="../img/title.jpg" style="max-width:100%">
|
||
|
||
|
||
|
||
<a href="../en/index.md">English</a> | <a href="../ja/index.md">日本語</a> | <a href="../zh/index.md">繁体中文</a>
|
||
|
||
- <a href="index.md">Top</a>
|
||
- <a href="node.md">Node</a> / <a href="node_image.md">Image Node</a> / <a href="node_text.md">Text Node</a> / <a href="node_xy.md">XYPlot Node</a> / <a href="node_float.md">Float Palet</a>
|
||
- <a href="workflow.md">Workflow</a>
|
||
|
||
|
||
|
||
<h1>
|
||
Node
|
||
</h1>
|
||
|
||
|
||
## :tomato: Image Node
|
||
|
||
### D2 Preview Image
|
||
|
||
<figure>
|
||
<img src="../img/preview_image_1.png">
|
||
<img src="../img/preview_image_2.png">
|
||
</figure>
|
||
|
||
- `Popup Image`: ボタンをクリックすると全画面ギャラリーが表示される
|
||
|
||
---
|
||
|
||
### D2 Save Image
|
||
|
||
<figure>
|
||
<img src="../img/save_image_2.png?2">
|
||
<figcaption>▲filenames には保存した画像のパスが出力される</figcaption>
|
||
</figure>
|
||
|
||
|
||
- `D2 Preview Image` と同じく、全画面ギャラリー機能を搭載した画像保存ノード
|
||
- 画像フォーマットは PNG / JPEG / WEBP / アニメーションWEBP に対応
|
||
- A1111方式の生成パラメーターをメタデータに保存する（PNG / JPEG / WEBP形式のみ）
|
||
- 保存した画像を `D2 Load Image` から読み込むと positive, negative プロンプトを取り出し可能（PNG / JPEG / WEBP形式のみ）
|
||
|
||
<figure>
|
||
<img src="../img/save_image_3.png?2">
|
||
<figcaption>▲d2_pipeから生成パラメーターを取得し、メタデータに保存</figcaption>
|
||
</figure>
|
||
|
||
|
||
#### Input
|
||
|
||
- `images`: 保存する画像
|
||
- `d2_pipe`: `D2 KSampler` などから生成パラメーターを受け取る
|
||
- `filename_prefix`: ファイルネーム書式。詳細は <a href="node_text.md#D2-Filename-Template">`D2 Filename Template`</a> 参照
|
||
- `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
|
||
|
||
<figure>
|
||
<img src="../img/save_image_eagle.png?2">
|
||
</figure>
|
||
|
||
- `D2 Save Image` にEagle登録機能が付いたもの
|
||
- <a href="https://eagle.cool/" target="_blank">Eagle公式サイト</a>
|
||
|
||
#### `D2 Send Eagle` との違い
|
||
|
||
- アニメーションWEBPに対応
|
||
- 全画面ギャラリー機能
|
||
- ファイル名のルールが標準に `Save Image` に準拠
|
||
- タグの保存機能を除外
|
||
|
||
#### Input
|
||
|
||
- `eagle_folder`: Eagleの登録フォルダ。フォルダ名、フォルダIDどちらでも可能
|
||
- `memo_text`: Eagleのメモとして登録するテキスト
|
||
|
||
#### StableDiffusion A1111 webui のようなパラメーターをEagleメモに記録するには
|
||
|
||
##### 自動で作成
|
||
|
||
`D2 Ksampler` から `d2_pipe` を接続するとEagle用メモに保存される。
|
||
|
||
<figure>
|
||
<img src="../img/save_image_eagle_4.png?2">
|
||
</figure>
|
||
|
||
##### 独自形式で作成
|
||
|
||
動画など複雑な生成パラメーターをしたい時などは、独自のメモを記録することも可能。
|
||
|
||
<figure>
|
||
<img src="../img/save_image_eagle_3.png?2">
|
||
</figure>
|
||
|
||
`D2 Filename Template2` を使ってテンプレート化し、`D2 Save Image Eagle` の `memo_text` に入力します。
|
||
|
||
上のサンプルでは `D2 KSampler` から `positive` `negative` を `arg_1` `arg_2` に入力して `%arg_1%` `%arg_2%` で取得、その他のパラメーターは `%{ノード名}.{Param}` で取得しています。
|
||
|
||
パラメーター取得方法の詳細は <a href="node_text.md#D2-Filename-Template">`D2 Filename Template`</a> をご覧下さい。
|
||
|
||
```
|
||
%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
|
||
|
||
<figure>
|
||
<img src="../img/send_file_eagle.png?2">
|
||
</figure>
|
||
|
||
- `file_path` で入力されたパスのファイルを<a href="https://eagle.cool/" target="_blank">Eagle</a>に登録する
|
||
- `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 について
|
||
|
||
<a href="https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite" target="_blank">Video Combine</a> が出力する `Filenames` は以下のような配列になっています。
|
||
|
||
```
|
||
[
|
||
true,
|
||
[
|
||
"D:\\ComfyUI\\output\\AnimateDiff_00002.png",
|
||
"D:\\ComfyUI\\output\\AnimateDiff_00002.mp4"
|
||
]
|
||
]
|
||
```
|
||
|
||
上の画像では <a href="https://github.com/godmt/ComfyUI-List-Utils" target="_blank">ComfyUI-List-Utils</a> に含まれる `Exec` ノードによってファイル名の部分を抜き出しています。
|
||
|
||
---
|
||
|
||
### D2 Load Image
|
||
|
||
<figure>
|
||
<img src="../img/load_image.png">
|
||
</figure>
|
||
|
||
- 画像からプロンプトを取得できる Load Image ノード
|
||
- StableDiffusion webui A1111、NovelAI で作成した画像にも対応
|
||
- マスクエディターを開くボタンが付いてる
|
||
|
||
#### Input
|
||
|
||
- `image_path`
|
||
- 画像のパスを入力するとファイルを読み込む
|
||
- `D2 Folder Image Queue` との接続に使用する
|
||
|
||
#### Output
|
||
|
||
- `IMAGE / MASK`: 画像とマスク
|
||
- `width / height`: 画像サイズ
|
||
- `positive` / `negative`: プロンプト
|
||
- `filename` / `filepath`: 保存したファイルの名前、パス
|
||
- `pnginfo`: 画像のメタデータ
|
||
|
||
#### プロンプトの出力について
|
||
|
||
下記のノード、UIで保存した画像に対応しています。
|
||
|
||
- `D2 Save Image`、`D2 Save Image Eagle`
|
||
- <a href="https://github.com/easygoing0114/ComfyUI-easygoing-nodes?tab=readme-ov-file" target="_blank">Save Image With Prompt</a>
|
||
- <a href="https://github.com/giriss/comfy-image-saver" target="_blank">Save Image w/Metadata</a>
|
||
- Novel AI
|
||
- A1111（Forge系含む）
|
||
|
||
> **注意：マスクエディタを使うとプロンプトが抽出できません**
|
||
>
|
||
> マスクエディタで編集すると ComfyUI が新しい画像ファイルを書き出して内部的に置き換わるため、元画像のメタデータが失われプロンプトを抽出できなくなります。マスクをクリアしても置き換わったままです。
|
||
>
|
||
> 対応策として、プロンプト抽出専用の `D2 Load Image` をもう一つ追加し、そちらではマスクエディタを使わないようにすることで回避できます。
|
||
|
||
|
||
---
|
||
|
||
### D2 Load Folder Images
|
||
|
||
<figure>
|
||
<img src="../img/load_folder_images.png">
|
||
</figure>
|
||
|
||
- フォルダー内の画像を一括ロードしてまとめて出力する
|
||
- `D2 Grid Image` などで使う
|
||
- 順次処理をしたいなら `D2 Folder Image Queue` を使う
|
||
|
||
#### Input
|
||
|
||
- `folder`
|
||
- フォルダーをフルパスで指定
|
||
- `extension`
|
||
- JPEG画像だけを読み込むなら `*.jpg` のように指定する
|
||
- `*silver*.webp` のような指定も可能
|
||
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
### D2 Folder Image Queue
|
||
|
||
<figure>
|
||
<img src="../img/folder_image_queue_2.png">
|
||
</figure>
|
||
|
||
- フォルダ内の画像のパスを出力する
|
||
- Queue を実行すると画像枚数分の Queue を自動的に実行する
|
||
|
||
#### Input
|
||
|
||
- `folder`
|
||
- 画像フォルダ
|
||
- `extension`
|
||
- ファイル名のフィルタを指定
|
||
- `*.*`: 全ての画像
|
||
- `*.png`: PNG形式のみ対象
|
||
- `start_at`
|
||
- 処理を開始する画像番号
|
||
- `auto_queue`
|
||
- `true`: 残りの Queue を自動的に実行する
|
||
- `false`: 1回だけ実行する
|
||
|
||
#### Output
|
||
|
||
- `image_path`
|
||
- 画像のフルパス
|
||
|
||
|
||
|
||
---
|
||
|
||
### D2 Grid Image
|
||
|
||
<figure>
|
||
<img src="../img/grid_image.png">
|
||
</figure>
|
||
|
||
- グリッド画像を出力する
|
||
- 横方向、縦方向、どちらも可能
|
||
- D2 XY Plot系では <a href="node_xy.md#d2-xy-grid-image">`D2 XY Grid Image`</a> をお使いください。
|
||
|
||
#### Input
|
||
|
||
- `max_columns`
|
||
- 横方向に整列する画像の枚数
|
||
- `swap_dimensions` が `true` の時は縦方向の枚数
|
||
- `grid_gap`
|
||
- 画像の間隔
|
||
- `swap_dimensions`
|
||
- `true`: 縦方向
|
||
- `false`: 横方向
|
||
- `trigger_count`
|
||
- 入力画像がここで指定した枚数になったらグリッド画像を出力する
|
||
- `Image count`
|
||
- 入力した画像の枚数
|
||
- `Reset Images`
|
||
- 入力した画像を破棄する
|
||
|
||
|
||
|
||
---
|
||
|
||
### D2 Image Stack
|
||
|
||
<figure>
|
||
<img src="../img/image_stack.png">
|
||
</figure>
|
||
|
||
- 入力された複数の画像をバッチにまとめる
|
||
- D2 Grid Image などで使える
|
||
- 最大50個入力まで
|
||
|
||
|
||
---
|
||
|
||
### D2 Image Mask Stack
|
||
|
||
<figure>
|
||
<img src="../img/image_mask_stack.png">
|
||
</figure>
|
||
|
||
- 入力された複数の画像とマスクをバッチにまとめる
|
||
- D2 Image Stack にマスクを追加したもの
|
||
|
||
---
|
||
|
||
|
||
### D2 EmptyImage Alpha
|
||
|
||
<figure>
|
||
<img src="../img/empty_image_alpha.png">
|
||
</figure>
|
||
|
||
- EmptyImage にαチャンネル（透明度）を追加
|
||
- `output_alpha` を `false` にするとαチャンネルを付与せず RGB（3ch）で出力する
|
||
- RGB を前提とするノード（Anima ControlNet-LLLite など）に渡せる
|
||
|
||
|
||
---
|
||
|
||
|
||
### D2 Mosaic Filter
|
||
|
||
<figure>
|
||
<img src="../img/mosaic.png">
|
||
</figure>
|
||
|
||
- モザイクフィルターをかける
|
||
- 透明度、明るさ、色の反転などを設定可能
|
||
|
||
自動モザイクのワークフローについて記事を書きましたので参考にしてください。
|
||
|
||
> <a href="https://note.com/da2el_ai/n/n79d34b88e0bd" target="_blank">ComfyUIを使った自動モザイクのワークフロー</a>
|
||
|
||
|
||
---
|
||
|
||
|
||
### D2 Cut By Mask
|
||
|
||
<figure>
|
||
<img src="../img/cut-by-mask.png">
|
||
</figure>
|
||
|
||
- マスクで画像をカットする
|
||
- 出力する形状、サイズ、余白などを指定できる
|
||
|
||
|
||
#### 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
|
||
|
||
<figure>
|
||
<img src="../img/paste-by-mask.png">
|
||
</figure>
|
||
|
||
- 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` の同じ順番の画像でペアとして出力する。
|
||
|
||
<figure>
|
||
<img src="../img/paste-by-mask_pair.png">
|
||
</figure>
|
||
|
||
`cross` は全ての組み合わせを出力する。
|
||
|
||
<figure>
|
||
<img src="../img/paste-by-mask_cross.png">
|
||
</figure>
|