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

English | 日本語 | 繁体中文

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

Node

🍅 Image Node

D2 Preview Image

• Click the Popup Image button to display the full-screen gallery

---

D2 Save Image

• An image saving node with full-screen gallery functionality, similar to D2 Preview Image
• Supports PNG / JPEG / WEBP / animated WEBP image formats

Input

• Popup Image: Clicking the button displays a full-screen gallery
• images: Images to save
• filename_prefix: Filename format
• preview_only: When true, images are only previewed without being saved
• format: Select image format from png / jpeg / webp / animated_webp
• lossless: true: lossless compression / false: lossy compression. Applied for webp and animated_webp.
• quality: Image compression ratio. Applied for jpeg or webp, animated_webp with lossless:false
• fps: Frame rate for animated_webp

Output

• filenames: Array of full paths of saved image files

---

D2 Save Image Eagle

• D2 Save Image with Eagle registration functionality
• Eagle Official Website

Differences from D2 Send Eagle

• Supports animated WEBP
• Full-screen gallery functionality
• Filename rules conform to the standard Save Image
• Tag saving feature excluded
• Generation parameter memos can be freely created
  • Need to be created using tools like D2 Filename Template2
  • As various generation environments like videos and Flux have increased, existing generation parameter saving methods have become inadequate

Input

• eagle_folder: Eagle registration folder. Can use either folder name or folder ID
• memo_text: Text to register as a memo in Eagle

Recording A1111 webui-style parameters in Eagle memo

Use D2 Filename Template2 to create a template and input it into the memo_text of D2 Save Image Eagle.

In the sample above, positive and negative from D2 KSampler are input to arg_1 and arg_2 and retrieved with %arg_1% and %arg_2%, while other parameters are retrieved with %node:{ID}.{Param}.

For details on parameter retrieval methods, see 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%

Output result

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

• Registers files at the path input in file_path to Eagle
• Created to register output files from Video Combine to Eagle
• Can also save video generation parameters by using D2 File Template2 for memo_text input

About file_path

Provide the full path of the file as a string or an array of strings.

Example: String

D:\ComfyUI\output\foo.png

Example: Array of strings

["D:\ComfyUI\output\foo.png","D:\ComfyUI\output\bar.png"]

About Filenames output by Video Combine

The Filenames output by Video Combine is an array like the following:

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

In the image above, the Exec node from ComfyUI-List-Utils is used to extract the filename part.

D2 Load Image

• Load Image node that can extract prompts from images
• Compatible with images created in StableDiffusion webui A1111 and NovelAI
• Includes a button to open mask editor

Input

• image_path
  • Loads file when image path is input
  • Used for connection with D2 Folder Image Queue

Output

• IMAGE / MASK
  • Image and mask
• width / height
  • Image size
• positive / negative
  • Prompts

Note: Prompts may not be retrievable depending on workflow configuration. For example, they cannot be retrieved without a node containing the string "KSampler" (e.g., Tiled KSampler).

---

D2 Load Folder Images

• Batch loads and outputs images from a folder
• Used with D2 Grid Image etc.
• Use D2 Folder Image Queue for sequential processing

Input

• folder
  • Specify folder in full path
• extension
  • Specify like *.jpg to load only JPEG images
  • Can also specify patterns like *silver*.webp

---

D2 Folder Image Queue

• Outputs paths of images in a folder
• Automatically executes Queue for the number of images when Queue is run

Input

• folder
  • Image folder
• extension
  • Specify file name filter
  • *.*: All images
  • *.png: PNG format only
• start_at
  • Image number to start processing
• auto_queue
  • true: Automatically execute remaining Queues
  • false: Execute only once

Output

• image_path
  • Full path of image

---

D2 Grid Image

• Outputs grid images
• Supports both horizontal and vertical alignment

Input

• max_columns
  • Number of images to align horizontally
  • When swap_dimensions is true, this becomes the number of vertical images
• grid_gap
  • Spacing between images
• swap_dimensions
  • true: Vertical alignment
  • false: Horizontal alignment
• trigger_count
  • Outputs grid image when the number of input images reaches this specified value
• Image count
  • Number of input images
• Reset Images
  • Discards all input images

---

D2 Image Stack

• Combines multiple input images into a batch
• Can be used with D2 Grid Image and others
• Maximum of 50 inputs

---

D2 Image Mask Stack

• Combines multiple input images and masks into a batch
• Essentially D2 Image Stack with added mask support

---

D2 EmptyImage Alpha

• Adds alpha channel (transparency) to EmptyImage

---

D2 Mosaic Filter

• Applies a mosaic filter
• Adjustable transparency, brightness, and color inversion options

---

D2 Cut By Mask

• Cut an image using a mask
• Can specify the output shape, size, margins, etc.

Input

• images: Source image to cut from
• mask: Mask
• cut_type: Shape of the cut image
  • mask: Cut according to the mask shape
  • rectangle: Calculate and cut a rectangle from the mask shape
  • square_thumb: Cuts out the maximum-sized square. A mode intended for thumbnails
• output_size: Output image size
  • mask_size: Mask size
  • image_size: Input image size (surroundings become transparent while preserving the input image position)
• padding: Number of pixels to expand the mask area (default 0)
• min_width: Minimum width of mask size (default 0)
• min_height: Minimum height of mask size (default 0)
• output_alpha: Whether to include alpha channel in the output image

output

• image: Image cut by the mask area
• mask: Mask
• rect: Cut rectangular area

---

D2 Paste By Mask

• Composite images using masks or rectangular areas created with D2 Paste By Mask
• Can specify blur width, paste shape, etc.

Input

• img_base: Base image (batch compatible)
• img_paste: Image to paste (batch compatible)
• paste_mode: Determines how to trim img_paste and the paste coordinates
  • mask: Mask img_paste with mask_opt and paste at position x=0, y=0 (mask shape pasting)
  • rect_full: Trim img_paste to the size of rect_opt and paste at the position of rect_opt (rectangular pasting)
  • rect_position: Paste img_paste at the position of rect_opt (rectangular pasting)
  • rect_pos_mask: Mask img_paste with mask_opt and paste at the position of rect_opt (mask shape pasting)
• multi_mode: Processing method when either or both of img_base and img_paste have multiple images
  • pair_last: Process img_base and img_paste pairs from the beginning with the same index. If one has fewer images, the last image is used
  • pair_only: Same as pair_last. If one has fewer images, an error is displayed and processing stops
  • cross: Process all combinations

input optional:

• mask_opt: Mask
• rect_opt: Rectangular area
• feather: Number of pixels to blur the edge (default 0)

output

• image: Composited image

About multi_mode

pair_last and pair_only output the same ordered images from img_base and img_paste as pairs.

cross outputs all combinations.