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

9.6 KiB
Raw Blame History

English | 日本語 | 繁体中文

Node

🍅 Image Node

D2 預覽圖像

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

D2 Save Image

  • 與 D2 Preview Image 相同,搭載全螢幕圖庫功能的圖像保存節點
  • 支援 PNG / JPEG / WEBP / 動畫WEBP 圖像格式

Input

  • Popup Image: 點擊按鈕時顯示全螢幕圖庫
  • images: 要保存的圖像
  • filename_prefix: 檔案名格式
  • preview_only: 為 true 時僅顯示預覽,不保存圖像
  • format: 從 png / jpeg / webp / animated_webp 中選擇圖像格式
  • lossless: true: 無損壓縮 / false: 有損壓縮。適用於 webp 和 animated_webp
  • quality: 圖像壓縮率。適用於 jpeg 或 webp、animated_webp 且 lossless:false 時
  • fps: animated_webp 的幀率

Output

  • filenames: 保存的圖像文件完整路徑陣列

D2 Save Image Eagle

與 D2 Send Eagle 的區別

  • 支援動畫WEBP
  • 全螢幕圖庫功能
  • 檔案名規則符合標準 Save Image
  • 排除了標籤保存功能
  • 生成參數備忘錄可以自由創建
    • 需要使用 D2 Filename Template2 等工具創建
    • 隨著視頻和Flux等各種生成環境的增加,現有的生成參數保存方法已不足以應對

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:{ID}.{Param} 獲取。

有關參數獲取方法的詳細信息,請參閱 D2 Filename Template。

%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

  • 將 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
    • 提示詞

※根據工作流程配置,可能無法獲取提示詞。例如,如果沒有包含「KSampler」字樣的節點(如:Tiled KSampler),則無法獲取。


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: 僅執行一次

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: 輸入圖像尺寸(保持輸入圖像位置的同時周圍變為透明)
  • 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 輸出所有組合。