da2el-ai-D2-nodes-ComfyUI/docs/zh/node_image.md

English | 日本語 | 繁体中文

• Top
• Node / Image Node / Text Node / XYPlot Node / Float Palet
• Workflow

Node

🍅 Image Node

D2 預覽圖像

• 點擊 Popup Image 按鈕可顯示全螢幕圖庫

Output

• images: 將輸入的圖像原樣輸出

---

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 且 lossless:false 時
• fps: animated_webp 的幀率
• Popup Image: 點擊按鈕時顯示全螢幕圖庫

Output

• images: 將輸入的圖像原樣輸出
• filenames: 保存的圖像文件完整路徑陣列（ARRAY）

---

D2 Save Image Eagle

• 具有Eagle註冊功能的 D2 Save Image
• Eagle官方網站

與 D2 Send Eagle 的區別

• 支援動畫WEBP
• 全螢幕圖庫功能
• 檔案名規則符合標準 Save Image
• 排除了標籤保存功能

Input

• eagle_folder: Eagle註冊資料夾。可以使用資料夾名稱或資料夾ID
• memo_text: 在Eagle中註冊為備忘錄的文本

在Eagle備忘錄中記錄A1111 webui風格的參數

自動創建

當從 D2 KSampler 連接 d2_pipe 時，會自動保存到Eagle備忘錄。

自定義格式創建

對於視頻等複雜的生成參數，也可以記錄自定義備忘錄。

Input

• eagle_folder: Eagle註冊資料夾。可以使用資料夾名稱或資料夾ID
• memo_text: 在Eagle中註冊為備忘錄的文本

在Eagle備忘錄中記錄A1111 webui風格的參數

使用 D2 Filename Template2 創建模板，並將其輸入到 D2 Save Image Eagle 的 memo_text 中。

在上面的示例中，D2 KSampler 的 positive 和 negative 被輸入到 arg_1 和 arg_2 並通過 %arg_1% 和 %arg_2% 獲取，而其他參數則通過 %{Node name}.{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 會將輸入的 file_path 原樣輸出

關於 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保存的圖像：

• D2 Save Image、D2 Save Image Eagle
• Save Image With Prompt
• Save Image w/Metadata
• Novel AI
• A1111（包括Forge系列）

注意：使用遮罩編輯器後將無法提取提示詞

使用遮罩編輯器編輯圖像時，ComfyUI 會寫出新的圖像檔案並在內部進行替換，因此原始圖像的元數據會遺失，無法再提取提示詞。即使清除遮罩，替換後的狀態也不會還原。

解決方法是另外新增一個專門用於提示詞提取的 D2 Load Image，並在該節點上避免使用遮罩編輯器。

---

D2 Load Folder Images

• 批量載入並輸出資料夾內的圖像
• 用於 D2 Grid Image 等
• 如需順序處理請使用 D2 Folder Image Queue

Input

• folder
  • 指定資料夾完整路徑
• extension
  • 如僅載入 JPEG 圖像則指定為 *.jpg
  • 也可使用 *silver*.webp 等指定方式
  • 可以 *.png, *.jpg, *.webp 這樣以逗號分隔指定多個副檔名
• include_subfolders
  • true: 同時處理子資料夾內的圖像
  • false: 僅限指定資料夾直接下方
  • 也可在 folder 中直接寫入 **，如 圖像資料夾/**，以遞迴取得

---

D2 Folder Image Queue

• 輸出資料夾內圖像的路徑
• 執行 Queue 時會自動執行與圖像數量相應的 Queue

Input

• folder
  • 圖像資料夾
• extension
  • 指定文件名過濾器
  • *.*: 所有圖像
  • *.png: 僅 PNG 格式
  • 可以 *.png, *.jpg, *.webp 這樣以逗號分隔指定多個副檔名
• include_subfolders
  • true: 同時處理子資料夾內的圖像
  • false: 僅限指定資料夾直接下方
  • 也可在 folder 中直接寫入 **，如 圖像資料夾/**，以遞迴取得
• start_at
  • 開始處理的圖像編號
• auto_queue
  • true: 自動執行剩餘的 Queue
  • false: 僅執行一次

Output

• image_path
  • 圖像完整路徑

---

D2 Grid Image

• 輸出網格圖像
• 支持水平和垂直排列
• 在 D2 XY Plot 系列中，請使用 D2 XY 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 添加 α 通道（透明度）
• 將 output_alpha 設為 false 時，不附加 α 通道，以 RGB（3ch）輸出
  • 可傳遞給以 RGB 為前提的節點（如 Anima ControlNet-LLLite）

---

D2 Mosaic Filter

• 添加馬賽克濾鏡效果
• 可調整透明度、亮度和顏色反轉等設置

我寫了一篇關於自動馬賽克工作流程的文章，請參考。

使用 ComfyUI 的自動馬賽克工作流程

---

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 單位生成的本地模型出現邊緣模糊。保持中心進行擴展，且不會超出原始圖像範圍
• square_thumb: 以最大尺寸的正方形進行裁剪。適用於縮略圖的模式
• padding: 擴展遮罩area的像素數（預設值 0）
• min_width: 遮罩尺寸的最小寬度（預設值 0）
• min_height: 遮罩尺寸的最小高度（預設值 0）
• output_alpha: 是否在輸出圖像中包含透明度通道

output

• image: 通過遮罩區域裁剪的圖像
• mask: 遮罩
• rect: 裁剪的矩形區域

---

D2 Paste By Mask

• 使用由 D2 Paste By Mask 創建的遮罩或矩形區域合成圖像
• 可以指定模糊寬度、貼上形狀等

Input

• img_base: 底層圖像（支援批次處理）
• img_paste: 要貼上的圖像（支援批次處理）
• paste_mode: 決定如何裁剪 img_paste 以及貼上座標
  • mask: 用 mask_opt 遮罩 img_paste 並在位置 x=0, y=0 貼上（遮罩形狀貼上）
  • rect_full: 將 img_paste 裁剪為 rect_opt 的尺寸並在 rect_opt 位置貼上（矩形貼上）
  • rect_position: 在 rect_opt 位置貼上 img_paste（矩形貼上）
  • rect_pos_mask: 用 mask_opt 遮罩 img_paste 並在 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: 邊緣模糊的像素數（預設值 0）

output

• image: 合成的圖像

關於 multi_mode

pair_last 和 pair_only 將 img_base 和 img_paste 中相同順序的圖像作為一對輸出。

cross 輸出所有組合。

---

D2 Create Point

• 透過拖曳標記來輸出 XY 座標的節點
• 標記會依 marker_count 增減，輸出 x_1 / y_1 … 也會連動增減
• 將圖像拖放到節點上，就會顯示在畫布背景，並套用其尺寸到 width / height

Input

• marker_count: 標記的數量（1〜16）。輸出 x_N / y_N 的數量會與此連動
• mode
  • absolute: 輸出實際的像素座標
  • relative: 輸出 0.0〜1.0 的相對值
• width / height: 座標系的尺寸。畫布的長寬比也由此決定
• image: 顯示於背景的圖像。留空則為黑色畫布
• markers: 標記座標的 JSON。拖曳時會自動更新，通常不需要修改

Output

• image: 指定的圖像。未指定圖像時為 width × height 的黑色圖像
• width / height: 座標系的尺寸
• x_1 / y_1: 標記1的座標。若 marker_count 為「3」，也會輸出 x_2 y_2 x_3 y_3

關於 mode

markers 無論 mode 為何都以相對值（0.0〜1.0）保存，因此切換 absolute 與 relative 時標記不會移動。變更 width / height 時也相同。

上方的圖像是在相同標記位置下只變更 mode 的結果。將 relative 的 0.163305 乘上 width 的 832，即為 absolute 的 136。

---

D2 Create Masks

• 透過在畫布上拖曳長方形來建立多個遮罩的節點
• 拖曳長方形內側可移動，拖曳四角的白色圓點可調整大小
• 長方形會依 mask_count 增減，輸出 mask_1 mask_2 … 也會連動增減
• 將圖像拖放到節點上，就會顯示在畫布背景，並套用其尺寸到 width / height

Input

• mask_count: 遮罩的數量（1〜16）。輸出 mask_N 的數量會與此連動
• select_mask: 要設為作用中的遮罩編號。在畫布上點擊遮罩時會自動變更為該遮罩的編號
• width / height: 輸出遮罩的尺寸。畫布的長寬比也由此決定
• image: 顯示於背景的圖像。留空則為黑色畫布
• masks: 遮罩位置與尺寸的 JSON。拖曳時會自動更新，通常不需要修改

Output

• image: 指定的圖像。未指定圖像時為 width × height 的黑色圖像
• width / height: 遮罩的尺寸
• mask_1: 遮罩1。若 mask_count 為「3」，也會輸出 mask_2 mask_3

關於作用中的遮罩

點擊的遮罩會成為「作用中」，顯示在最前方，並在四角出現用於調整大小的白色圓點。

當遮罩完全重疊時無法點擊下層的遮罩，此時請用 select_mask 選擇編號。反之，透過點擊變更作用中的遮罩時，select_mask 也會跟著更新。

---

D2 Random Point

• 輸出隨機 XY 座標的節點
• 透過指定 min / max 可限定範圍

Input

• width / height: 座標系的尺寸
• min_x / max_x: X 座標的範圍
• min_y / max_y: Y 座標的範圍
• mode
  • absolute: 輸出實際的像素座標
  • relative: 輸出 0.0〜1.0 的相對值
• number_type: int / float。僅在 mode 為 absolute 時有效
• seed: 亂數種子。相同的值會得到相同的座標

Output

• width / height: 輸入的座標系尺寸會原樣輸出
• x / y: 隨機決定的座標

關於範圍指定

min_x max_x min_y max_y 無論 mode 為何，一律以 0.0〜1.0 的相對值指定。

例如將 min_x 設為 0.25、max_x 設為 0.75，座標就只會出現在偏中央的範圍。即使變更 width，「偏中央」的意義也不會改變。

min 與 max 填入相同的值時，會固定在該位置。

關於 number_type

mode 為 absolute 時，int 會輸出如 100 的整數，float 會輸出如 100.3968 的小數。

relative 為 0〜1 的範圍，因此一律為小數。

---

D2 Random Mask

• 輸出隨機長方形遮罩的節點
• 長方形會被放置在不超出 width / height 的位置

Input

• width / height: 輸出遮罩的尺寸
• min_width / max_width: 長方形寬度的範圍（像素）
• min_height / max_height: 長方形高度的範圍（像素）
• seed: 亂數種子。相同的值會得到相同的長方形

Output

• width / height: 輸入的遮罩尺寸會原樣輸出
• mask: 長方形內側為白色的遮罩
• mask_x / mask_y: 長方形左上角的座標
• mask_w / mask_h: 長方形的寬度與高度

關於長方形的尺寸

min_width 與 max_width 填入相同的值時寬度會固定，只有位置隨機變動。

當 max 小於 min 時會互換處理，指定大於 width / height 的尺寸時則會縮小到遮罩的尺寸。長方形不會超出遮罩之外。