ComfyUI Node
🐇 Pixel Hold
Locks parts of each frame to a chosen reference (external image or a frame from the clip) whenever changes are small—useful for stabilizing flat areas or backgrounds while leaving motion to pass through.
🐇 Pixel Hold
- frames
- reference
- images
- mask_preview
◄ref_sourceexternal►
◄ref_index0►
◄linearizetrue►
◄auto_lumatrue►
◄auto_k2.5►
◄tau_luma0.0059►
◄tau_grad0.020►
◄modetile►
◄tile_size32►
◄score_model1_tile►
◄edge_bandtrue►
◄band_radius4►
◄tau_edge_low0.0059►
◄tau_edge_high0.0235►
◄applyall►
◄dilate1►
◄feather_sigma2.0►
◄process_onauto►
◄gpu_clear_every0►
Categoryvideo utils
Inputs (21)
| Name | Type | Default | Description |
|---|---|---|---|
| frames | IMAGE | Your clip (frames×H×W×C, values 0–1). | |
| ref_source | COMBO | external | Pick the reference: an external image or a frame from this clip. |
| ref_index | INT | 00–999999 | If using a frame from this clip, which frame to use as the reference. |
| reference | IMAGE | Optional external reference (1×H×W×C). If sizes differ, it will be resized to match. | |
| linearize | BOOLEAN | true | Work in linear color for steadier results on flat areas. |
| auto_luma | BOOLEAN | true | Auto sensitivity for brightness changes (adapts per frame). |
| auto_k | FLOAT | 2.50.5–6 | Auto strength. Higher = lock more to the reference (2–3 is typical). |
| tau_luma | FLOAT | 0.00590–0.01568627450980392 | Manual brightness threshold when Auto is OFF. Lower = stricter (more locking). |
| tau_grad | FLOAT | 0.0200–1 | How much edge change to allow. Lower protects edges more. |
| mode | COMBO | tile | Tile: fast & robust. Pixel: finer but noisier. |
| tile_size | INT | 328–256 | Tile size when using Tile mode. |
| score_mode | COMBO | l1_tile | How tiles measure change: mean abs diff (fast) or median abs dev (robust). |
| edge_band | BOOLEAN | true | Protect a belt around strong edges to avoid wobble/stretch. |
| band_radius | INT | 40–64 | Width of the protected belt (pixels). |
| tau_edge_low | FLOAT | 0.00590–0.25 | Treat as low-motion below this level (edge belt). |
| tau_edge_high | FLOAT | 0.02350–0.5 | Treat as high-motion above this level (edge belt). |
| apply | COMBO | all | Hold the whole image (All) or only its smooth part (Low-freq). |
| dilate | INT | 10–16 | Expand the mask (pixels). |
| feather_sigma | FLOAT | 2.00–16 | Soften mask edges (pixels). |
| process_on | COMBO | auto | Choose CPU/GPU. Auto switches to GPU on very large frames. |
| gpu_clear_every | INT | 00–1000 | If >0 and using GPU, free memory every N frames. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| images | IMAGE | — |
| mask_preview | IMAGE | — |