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

English | 日本語 | 繁体中文

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

Node

🍅 Sampler Nodes

D2 KSampler / D2 KSampler(Advanced)

Differences from standard KSampler

• Directly outputs images (VAE Decoder not required)
• Can input prompts in STRING format
• Supports A1111-style LoRA loading prompts
  • Example: <lora:foo.safetensors:1>
  • For format, refer to D2 Load Lora
  • Note: When inputting positive_cond / negative_cond to D2 KSampler Advanced, LoRA will not be applied to CLIP. It will only be applied to MODEL.
• Has dedicated Controlnet input for simple application
• Supports d2_pipe which consolidates generation parameters
  • Can easily receive from D2 XY Plot, D2 XY Plot Easy, D2 XY Plot Easy Mini
  • Can collectively receive model / clip / vae from D2 Checkpoint Loader or D2 Load Diffusion Model Set
  • Can easily pass parameters to D2 Save Image Eagle
• Can change prompt weight algorithm (weight_interpretation)

Notes

• When d2_pipe is connected, d2_pipe parameters take priority
• For example, if you specify steps:20 in D2 KSampler and steps:15 in D2 XYPlot Easy, with d2_pipe connected, steps:15 from D2 XYPlot Easy will be used.
• However, model / clip / vae / positive_cond / negative_cond give priority to directly connected inputs (same handling as positive / negative). The d2_pipe values are used only when there is no direct connection.

Input

• Same as standard KSampler
  • model / clip / latent_image / seed / steps / cfg / sampler_name / scheduler / denoise
  • model / clip can now be passed via d2_pipe, so both are optional
• Added in D2 KSampler
  • vae: optional, since it can be passed via d2_pipe
  • cnet_stack: For connecting to D2 Controlnet Loader
  • d2_pipe: Consolidated generation parameters. Received from nodes like D2 XY Plot
  • preview_method: Preview display method during generation
  • positive / negative: Prompts in STRING format
• Added in D2 KSampler Advanced
  • token_normalization / weight_interpretation
    • Methods for adjusting prompt weights. Available in D2 KSampler Advanced
    • Requires Advanced CLIP Text Encode to use

Output

• Same as standard KSampler
  • LATENT
• Added in D2 KSampler
  • IMAGE: Generated image
  • MODEL / CLIP: With LoRA applied
  • positive / negative: Input passthrough
  • formatted_positive: Positive prompt with A1111-style LoRA format removed
  • positive_cond / negative_cond: CONDITIONING with Controlnet applied
  • d2_pipe: Consolidated generation parameters

---

D2 Pipe

• A node for modifying and extracting the contents of d2_pipe
• d2_pipe is used to pass parameters collectively in nodes such as D2 XY Plot Easy, D2 KSampler, and D2 Save Image Eagle
• In addition to ckpt_name / positive / negative / seed / steps / cfg / sampler_name / scheduler / denoise / width / height, it now also supports input/output of model / clip / vae / positive_cond / negative_cond
  • Connecting a direct input to these overwrites the corresponding item in d2_pipe. If there is no connection, the d2_pipe value is passed through as is

---

🍅 Loader Node

D2 Checkpoint Loader

• A Checkpoint Loader that outputs the full path of model files
• Can automatically apply v_prediction settings when the filename contains "vpred"

Input

• d2_pipe
  • Not used by this node itself, but adds model and others to the received d2_pipe
• ckpt_name
  • Checkpoint name
• auto_vpred
  • true: Automatically applies v_prediction settings if the filename contains "vpred"
• sampling / zsnr
  • Same settings as ModelSamplingDiscrete (details unknown)
• multiplier
  • Same settings as RescaleCFG (details unknown)

Output

• model / clip / vae
  • Same as the conventional CheckpointLoader.
• ckpt_name / ckpt_hash / ckpt_fullpath
  • Checkpoint name, hash, and full path.
• d2_pipe
  • Consolidates model / clip / vae / ckpt_name. Can be connected to D2 KSampler with a single wire.

---

D2 Load Diffusion Model

• A Load Diffusion Model that outputs the full path and filename of model files

Input

• d2_pipe
  • Not used by this node itself, but adds model and others to the received d2_pipe
• unet_name / weight_dtype: Same as the standard Load Diffusion Model

Output

• model
  • Same as the standard Load Diffusion Model.
• ckpt_name / ckpt_hash / ckpt_fullpath
  • Checkpoint name, hash, and full path.
  • Although it's technically unet_name, it has been named ckpt_name to align with D2 Checkpoint Loader
• d2_pipe
  • Consolidates model / ckpt_name. Can be connected to D2 KSampler.
  • Since this node does not load VAE / CLIP, d2_pipe contains only model (clip / vae need to be connected separately)

---

D2 Load Diffusion Model Set

• A loader that combines Load Diffusion Model + Load VAE + Load CLIP into one
• Loads model / clip / vae together and can output them as d2_pipe
• By connecting a single d2_pipe wire to D2 KSampler, individual connections for model / clip / vae become unnecessary

Input

• d2_pipe
  • Not used by this node itself, but adds model and others to the received d2_pipe
• unet_name / weight_dtype: Same as the standard Load Diffusion Model
• vae_name: Same as the standard Load VAE
• clip_name / clip_type: Same as the standard Load CLIP

Output

• model / clip / vae
  • Same as each standard loader.
• ckpt_name / ckpt_hash / ckpt_fullpath
  • Diffusion Model name, hash, and full path.
  • Although it's technically unet_name, it has been named ckpt_name to align with D2 Checkpoint Loader
• d2_pipe
  • Consolidates model / clip / vae / ckpt_name. Can be connected to D2 KSampler with a single wire.

---

D2 Controlnet Loader

• Controlnet Loader that creates simple workflows when connected to D2 KSampler
• controlnet_type switches between StableDiffusion (standard Controlnet) and Anima (kohya-ss's Anima-LLLite)
  • To use Anima, you need to install ComfyUI-Anima-LLLite beforehand

Input

• controlnet_type
  • StableDiffusion: Standard Controlnet
  • Anima: kohya-ss's Anima-LLLite (requires ComfyUI-Anima-LLLite)
• cnet_stack
  • For connecting to D2 Controlnet Loader

Output

• cnet_stack
  • For connecting to D2 KSampler or D2 Controlnet Loader

---

D2 Load Lora

• A Lora loader that allows specifying Lora through text
• model_weight / clip_weight can also be specified

• There are two modes: one that uses the same format as StableDiffusion webui A1111 (a1111), and one that simply lists LoRA names (simple)
• For specific usage, refer to the sample workflow

Input

• mode
  • a1111: Mode that allows using the same format as StableDiffusion webui A1111
  • simple: Simple mode that just lists LoRA names. In this mode, the STRING output is not used

Output

• MODEL / CLIP: MODEL and CLIP with LoRA applied
• prompt: Outputs the input text as is
• formatted_prompt: Text with LoRA specification parts removed

Format differences based on mode

mode: a1111 Expressed as <lora:~>.

<lora:lora_name:1>

mode: simple No decorations needed before or after

lora_name:1

How to specify Weight

Write in the format {lora_name}:{model_weight}:{clip_weight}.

foo:0.8:1

If clip_weight is not specified, the same value as model_weight is applied. The following have the same meaning.

foo:0.8
foo:0.8:0.8

If weight is not specified, "1" is applied The following have the same meaning.

foo
foo:1:1

How to specify multiple LoRAs in simple mode

Separate with line breaks

foo:0.5
bar

When writing two types in one line, separate with ","

foo:0.5,bar

Comments

Lines that start with "//" or "#" are ignored.

//foo:0.5
#bar

---

🍅 Size Node

D2 Get Image Size

• Both outputs and displays size

---

D2 Size Selector

• Node for selecting image size from presets
• Can also get size from images
• Rounding method can be selected from Ceil / Float / None

Input

• images
  • Used when getting size from images
  • preset must be set to custom
• preset
  • Size presets
  • Must be set to custom when using width height below or image sizes
  • Edit /custom_nodes/D2-nodes-ComfyUI/config/sizeselector_config.yaml to modify presets
• width / height
  • Width/height dimensions
  • preset must be set to custom
• swap_dimensions
  • Swap width/height
• upscale_factor
  • Value passed to other resize nodes. Does nothing in this node
• prescale_factor
  • Output width/height after resizing by this factor
• round_method
  • Round: Round to nearest
  • Floor: Round down
  • None: No rounding
• batch_size
  • Batch size to set for empty_latent

Output

• width / height
  • Input width, height multiplied by prescale_factor
• upscale_factor / prescale_factor
  • Passthrough of input
• batch_size
  • Passthrough of input
• empty_latent
  • Outputs latent created with specified size and batch size

---

D2 Image Resize

• Image and mask resizing and rotation
• Precision up to 3 decimal places for scaling
• Can select rounding, floor, or ceiling for decimal handling
• Capable of upscaling using upscale models
• Latent output is also possible (requires VAE)
• Rotation options: 90 / 180 / 270 degrees

---

D2 Resize Calculator

• Can select rounding, floor, or ceiling

---

🍅 Refiner Node

D2 Refiner Steps

• Node for outputting steps for Refiner

Input

• steps
  • Total step count
• start
  • Starting steps for first KSampler
• end
  • Ending steps for first KSampler

Output

• steps / start / end
  • Input passthrough
• refiner_start
  • Starting steps for second KSampler

---

D2 Refiner Steps A1111

• Node that can specify denoise for Refiner in img2img

Input

• steps
  • Total step count
• denoise
  • Specify denoise for img2img
• switch_at
  • What percentage of total steps to switch to next KSampler

Output

• steps
  • Input passthrough
• start
  • Starting steps for first KSampler
• end
  • Ending steps for first KSampler
• refiner_start
  • Starting steps for second KSampler

---

D2 Refiner Steps Tester

• Node for checking steps

---

🍅 Merge Node

D2 Model and CLIP Merge SDXL

• A node that combines ModelMergeSDXL and CLIPMergeSimple
• Allows comma-separated weight specifications for easier use with XYPlot
• In this figure, 0.85,0.85,1,1,0.4,0.4,1,0.4,0.4,0.4,1,0.4,0.4,0.4,0,0.55,0.85,0.85,0.85,0.85,0.85,0.85,1,1,0.65 is specified

---

D2 Any Delivery

• A node that can pass multiple elements together
• Connect D2 Any Delivery nodes to pass data as a package
• You can dynamically add necessary inputs and outputs by writing them in _label
• Created because ComfyUI-0246's Highway became unusable with ComfyUI updates
  • It's probably better to use the original if it gets updated

Input

• _package
  • Package received from other D2 Any Delivery nodes
• _label
  • Define inputs and outputs
  • Specified like >width; >height; <width
  • Items starting with > are added as inputs
  • Items starting with < are added as outputs
  • Multiple items can be specified separated by ;
• _update
  • Update inputs and outputs according to the content of _label

Output

• _package
  • Package to pass to other D2_AnyDelivery nodes
  • All values received in inputs are stored
• Items specified with < in _label
  • Values extracted from _package are output

_label Examples

Add width height to inputs

>width; >height

Add width height to outputs

<width; <height

Add prompt seed to inputs, width height to outputs

>prompt; >seed; <width; <height

---

D2 Preset Selector

• A node that defines presets of multiple parameters as text and outputs a whole set by picking one from a dropdown
• Intended for switching sets of recommended steps / cfg etc. per Checkpoint
• Enter the format into preset_text and press _update to rebuild the output slots and the dropdown

Input

• preset
  • Dropdown. The currently selected preset
  • The titles from line 3 onward of preset_text become the choices
• preset_name
  • Input that receives a preset name as a string from outside (forceInput)
  • When connected and not an empty string, it takes priority over preset (the dropdown selection)
• preset_text
  • Preset definition text (format described below)
  • A sample is filled in by default, so you can try it as is
• _update
  • Updates the output slots and the dropdown according to preset_text

Output

• An output slot is created for each name defined on line 1 of preset_text
• The values of the selected preset are converted to the types specified on line 2 and output

preset_text Format

steps;cfg
INT;FLOAT
Anima;15;1.5
Illustrious;20;5.0

• Line 1: output names (separated by ;)
• Line 2: output types (INT / FLOAT / STRING / BOOLEAN)
• Line 3 onward: title;value1;value2… (one line per preset). The title (first cell) is required; leaving it empty causes an error

In the example above, selecting Anima outputs steps=15 and cfg=1.5.

Constraints

• The separator ; cannot be used inside STRING values
• Connecting a Primitive node to the preset dropdown is not supported (due to a ComfyUI limitation, the choices are not shown). Reloading, loading a workflow, and subgraph inputs all work normally

---

D2 Save Audio Eagle

• A node that sends audio files to Eagle
• Note that files are also saved to the regular folder, so be mindful of drive space

Input

• audio
  • Audio to save
• filename_prefix
  • Filename for saving
• eagle_folder
  • Destination folder name in Eagle
• format
  • Choose from FLAC / MP3 / Opus
• mp3_quality
  • Bitrate used when format is mp3
• opus_quality
  • Bitrate used when format is Opus
• memo_text
  • Text to save in Eagle's memo field