Image Seamless Quilting SP
The fast, finicky seamless quilter — great when it works
- src
- lookup
- IMAGE
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.
Inputs (7)
| Name | Type | Default | Description |
|---|---|---|---|
| src | IMAGE | — | |
| ori | COMBO | H | 3 options: H, V, H & V |
| block_size | INT | -1-1–512 | — |
| overlap | FLOAT | 0.200.1–0.5 | — |
| version | INT | 31–3 | — |
| blend_into_patch | BOOLEAN | false | — |
| lookupopt | IMAGE | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| IMAGE | IMAGE | — |