Nodes/comfyui_quilting/Image Seamless Quilting SP
ComfyUI Node

Image Seamless Quilting SP

The fast, finicky seamless quilter — great when it works

By bmad4ever·Created 2 years ago·Updated about a year ago· 10
Image Seamless Quilting SP
  • src
  • lookup
  • IMAGE
oriH
block_size-1
overlap0.20
version3
blend_into_patchfalse

SP stands for Single Patch, and that's the whole personality of this node. Where the MP version rebuilds a seamless transition strip out of dozens of small overlapping square patches, this one patches each seam with a single big block of texture. That makes it fast, and it makes it deterministic - there's no seed input, so the same input gives you the same output every single time. It also makes it picky: without a lookup texture, SP rarely produces an acceptable result. The README is refreshingly honest about that.

When SP is the right call

Two situations. First, when you have a lookup texture to draw from - proper source material for the patch rather than the image itself. Second, when a single cohesive block genuinely beats a patchwork: the author's example is vertically patching a journal without breaking words across the seam. Text is the classic case where MP's many small patches chop things up, and one careful block wins.

Inputs and output

src, ori (H / V / H & V), block_size (the auto range works here too - -1 default does the quick frequency guess), overlap (capped at 50%), plus version and blend_into_patch. No tolerance, no seed - that's the tradeoff for the single-patch approach. The optional lookup needs to be at least as tall as src for horizontal patching, or at least as wide for vertical - it has to cover the whole edge it's patching. Output is one IMAGE, seamless in the orientation you picked.

The honest verdict

If you're new to this pack, start with the MP node. SP is a specialist: faster when it works, deterministic, and unbeatable for keeping text coherent - but it will hand you a visible seam on intricate textures with no lookup, and then you'll blame the pack. Give it a decent lookup and it's a lovely quick seam-fixer.

Installing

It ships inside comfyui_quilting, so the usual drill: ComfyUI Manager → search comfyui_quilting, or

cd ComfyUI/custom_nodes
git clone https://github.com/bmad4ever/comfyui_quilting
python -m pip install -e /path/to/ComfyUI/custom_nodes/comfyui_quilting

then restart. No model downloads anywhere; the only optional dependency in the whole pack is pyastar2d, and SP doesn't need it to work.

CategoryBmad/CV/Quilting

Inputs (7)

NameTypeDefaultDescription
srcIMAGE
oriCOMBOH3 options: H, V, H & V
block_sizeINT-1-1–512
overlapFLOAT0.200.1–0.5
versionINT31–3
blend_into_patchBOOLEANfalse
lookupoptIMAGE

Outputs (1)

NameTypeDescription
IMAGEIMAGE