Files
da2el-ai-D2-nodes-ComfyUI/docs/ja/node_image.md
T
2025-08-07 16:33:36 +09:00

402 lines
11 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">
</figure>
- `D2 Preview Image` と同じく、全画面ギャラリー機能を搭載した画像保存ノード
- 画像フォーマットは PNG / JPEG / WEBP / アニメーションWEBP に対応
#### Input
- `Popup Image`: ボタンをクリックすると全画面ギャラリーが表示される
- `preview_only`:
- `images`: 保存する画像
- `filename_prefix`: ファイルネーム書式
- `preview_only`: true 時は画像を保存せず、プレビュー表示だけになる
- `format`: 画像フォーマットを `png` / `jpeg` / `webp` / `animated_webp` から選択
- `lossless`: `true`:可逆圧縮 / `false`:不可逆圧縮。`webp`、`animated_webp` の時に適用。
- `quality`: 画像圧縮率。`jpeg` または `webp`、`animated_webp` で `losless:false` の時に適用
- `fps`: `animated_webp` のフレームレート
#### 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` に準拠
- タグの保存機能を除外
- 生成パラメーターメモは自由に作れる
- `D2 Filename Template2` などで作る必要がある
- 動画やFluxなど様々な生成環境が増え、既存の生成パラメーター保存では対応できなくなったため
#### Input
- `eagle_folder`: Eagleの登録フォルダ。フォルダ名、フォルダIDどちらでも可能
- `memo_text`: Eagleのメモとして登録するテキスト
#### StableDiffusion A1111 webui のようなパラメーターをEagleメモに記録するには
<figure>
<img src="../img/save_image_eagle_2.png?2">
</figure>
`D2 Filename Template2` を使ってテンプレート化し、`D2 Save Image Eagle` の `memo_text` に入力します。
上のサンプルでは `D2 KSampler` から `positive` `negative` を `arg_1` `arg_2` に入力して `%arg_1%` `%arg_2%` で取得、その他のパラメーターは `%node:{ID}.{Param}` で取得しています。
パラメーター取得方法の詳細は <a href="node_text.md#D2-Filename-Template">`D2 Filename Template`</a> をご覧下さい。
```
%arg_1%
Negative prompt: %arg_2%
Steps: %node:25.steps%, Sampler: %node:25.sampler_name% %node:25.scheduler%, CFG scale: %node:25.cfg%, Seed: %node:25.seed%, Size: %node:43.width%x%node:43.height%, Model: %node:26.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`
- プロンプト
※ワークフローの構成によってはプロンプトを取得できない場合もあります。例えば「KSampler」という文字が含まれたノード(例:Tiled KSampler)が無いと取得できません。
---
### 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>
- グリッド画像を出力する
- 横方向、縦方向、どちらも可能
#### 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 にαチャンネル(透明度)を追加
---
### D2 Mosaic Filter
<figure>
<img src="../img/mosaic.png">
</figure>
- モザイクフィルターをかける
- 透明度、明るさ、色の反転などを設定可能
---
### 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`: 入力画像のサイズ(入力画像の位置を保持した状態で周囲が透明になる)
- `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>