Pad Image Batch Interleaved (PadImageBatchInterleaved) - ComfyUI-KJNodes

The Pad Image Batch Interleaved node receives a four-dimensional tensor (batch, height, width, channels) as input and creates a new, longer tensor.

The Pad Image Batch Interleaved node is an image batch processing tool. Its core function is to insert a specified number of blank frames between consecutive image frames in a batch. It is primarily used to adjust the pacing of video or animation sequences by increasing the frame intervals, thereby extending the total duration of the sequence.

Node Function

This node receives a four-dimensional tensor (batch, height, width, channels) as input and creates a new, longer tensor. Its technical implementation involves placing the original image frames in order and padding with blank frames, composed of a specified grayscale value, between every two original frames (and optionally after the last frame). Simultaneously, it generates a corresponding mask to distinguish between the original frames (value 1) and the inserted blank frames (value 0).

Node Parameter Description - Pad Image Batch Interleaved

Connection Inputs (Inputs)

Parameter Name	Data Type	Required	Default Value	Range/Options	Description
`images`	IMAGE	Yes	-	-	The input image batch to be processed.

Control Parameters (Parameters)

Parameter Name	Data Type	Required	Default Value	Range/Options	Description
`empty_frames_per_image`	INT	Yes	1	0 - 4096 (Step: 1)	empty_frames_per_image (Input Parameter): Sets the number of blank frames to insert between every two original images. The value is an integer ranging from 0 to 4096.
`pad_frame_value`	FLOAT	Yes	0.0	0.0 - 1.0 (Step: 0.01)	pad_frame_value (Input Parameter): Defines the pixel grayscale value for the inserted blank frames. The value ranges from 0.0 (pure black) to 1.0 (pure white), with a step of 0.01.
`add_after_last`	BOOLEAN	Yes	False	-	add_after_last (Input Parameter): A boolean switch that determines whether to append the same number of blank frames after the last image in the input batch.

Output

Parameter Name	Data Type	Description
images	IMAGE	images (Output Parameter): Outputs the new image batch with blank frames inserted.
masks	MASK	masks (Output Parameter): Outputs a mask used to identify which frames in the output batch are original and which are inserted blank frames.

Usage Scenarios

This node is very useful in animation workflows that require slow-motion or pause effects. For example, you can input a dynamically changing image sequence into this node, set the number of blank frames to insert, thereby creating brief "freeze-frame" effects between key actions, making the animation pacing better suit narrative needs.

Notes

The node's behavior differs when the input batch contains only a single image. If the add_after_last parameter is True, it will add blank frames after that image; if False, the output remains unchanged. Users need to choose based on the specific scenario.

Pad Image Batch Interleaved Node Source Code Link

The Pad Image Batch Interleaved node is from the ComfyUI-KJNodes node package.

Pad Image Batch Interleaved(PadImageBatchInterleaved)