ComfyUI Node
🐧 Restore Video Crop Frames
Pastes processed cropped frames back onto the background frames using the crop metadata from Get Video Crop Frames. Blending uses per-frame masks (mask values are the paste alpha) or, without masks, a feathered bbox edge. Processes in VRAM-bounded chunks on the GPU when available.
🐧 Restore Video Crop Frames
- background_frames
- cropped_frames
- restore_info
- masks
- frames
◄scale_method▾►
◄feather_bbox0►
◄feather_mode▾►
CategorySuperNodes/Video
Inputs (7)
| Name | Type | Default | Description |
|---|---|---|---|
| background_frames | IMAGE | The frames to composite onto; defines output size and coordinate space. | |
| cropped_frames | IMAGE | The processed cropped frame batch to paste back. | |
| restore_info | BBOX_RESTORE_INFO | Crop metadata produced by Get Video Crop Frames. | |
| scale_method | COMBO | Interpolation used when resizing crops and crop-space masks. | |
| feather_bbox | INT | 00–1024 | Feather radius in pixels (output frame space) applied to the bbox edge when 'masks' is not connected. 0 = hard edge. Ignored when masks are provided. |
| feather_mode | COMBO | Where the bbox feather falls: 'inner' fades inside the bbox, 'outer' fades outward past it (needs crop padding to have content there), 'mid' straddles the edge. Ignored when masks are provided. | |
| masksopt | MASK | Per-frame blend masks; mask values are the paste alpha, so feather the mask itself to control edge softness. Coordinate space is auto-detected by size: if HxW matches cropped_frames or the original crop size in restore_info (e.g. the cropped_masks output of Get Video Crop Frames, even if the crops were upscaled since), they are crop-space masks resized with the crop; if HxW matches background_frames they are used in place. Anything else is an error. Batch must be at least the restored frame count (extras are trimmed; too few is an error). Overrides feather_bbox/feather_mode. |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| frames | IMAGE | The background frames with each crop restored. |