Nodes/ComfyUI-Koolook/Koolook Matte — Sampler
ComfyUI Node

Koolook Matte — Sampler

A ComfyUI node in Koolook Matte with 13 inputs and 1 output.

By malkuthro·Created 11 months ago·Updated 22 days ago· 7
Koolook Matte — Sampler
  • pipeline
  • images
  • masks
  • MASK
seed42
max_resolution1024
fps7
motion_bucket_id127
noise_aug_strength0.00
window_size16
window_overlap2
crop_to_masktrue
crop_padding16
resize_modeshortest_side
CategoryKoolook Matte

Inputs (13)

NameTypeDefaultDescription
pipelineKOOLOOK_MATTE_PIPELINE
imagesIMAGE
masksMASK
seedINT420–18446744073709550000
max_resolutionINT1024256–2048
fpsINT71–60
motion_bucket_idINT1271–255
noise_aug_strengthFLOAT0.000–1
window_sizeINT160–128Frames sent through the UNet per pass. Lower = far less VRAM, so you can raise max_resolution (e.g. 1440) on 24GB. 0 = process the whole clip in one pass (legacy behaviour).
window_overlapINT20–32Frames re-processed and blended at each window boundary for temporal continuity. 0 disables overlap feedback/blending. Must be < window_size.
crop_to_maskBOOLEANtrueProcess only the union bounding box of the masks (Sammie-style ROI). Far fewer pixels through the UNet => much faster and lets max_resolution apply to just the subject. The output matte is pasted back into the full frame (zero alpha outside).
crop_paddingINT160–512Pixels of margin added around the mask bounding box before cropping, so soft edges/motion aren't clipped.
resize_modeCOMBOshortest_sideshortest_side = desktop/Sammie parity: cap the shorter side at max_resolution, never upscale, keep the long axis at full detail (sharpest matte, more VRAM). longest_axis = force the longer side to max_resolution (lower VRAM, softer edges).

Outputs (1)

NameTypeDescription
MASKMASK