ComfyUI Node: 📽 Unwrap Frame Set

Unwrap Frame Set [DVB]:

The "Unwrap Frame Set" node is designed to process a set of video frames and extract detailed information about the frames, including their images and framerate details. This node is particularly useful for AI artists who need to manipulate video frames for various creative projects. It allows you to handle gaps in the frame indices by either blending the frames, failing the operation, or reindexing the frames. This flexibility ensures that you can maintain the integrity of your frame sequences according to your specific needs. The node outputs a comprehensive set of data, including the images, framerate details, and frame indices, which can be used for further processing or analysis.

Unwrap Frame Set [DVB] Input Parameters:

frames

This parameter represents the set of video frames that you want to process. It is of the type FrameSet, which contains the images and associated metadata such as framerate and indices. The frames parameter is essential as it provides the raw data that the node will process.

gap_mode

This parameter determines how the node handles gaps in the frame indices. It has three options: "BLEND", "FAIL", and "REINDEX". "BLEND" will blend the frames to fill in the gaps, "FAIL" will cause the node to throw an error if gaps are detected, and "REINDEX" will reindex the frames to remove any gaps. This parameter allows you to control the behavior of the node in the presence of gaps, ensuring that the output meets your requirements.

Unwrap Frame Set [DVB] Output Parameters:

images

This output contains the processed images from the frame set. It is a tensor data representation of the images, which can be used for further image processing tasks.

framerate_float

This output provides the framerate of the frames as a floating-point number. It is useful for understanding the exact framerate of the video frames.

framerate_rounded

This output gives the rounded integer value of the framerate. It is useful for scenarios where an integer framerate is required.

framerate_base

This output provides the base value of the framerate. It is part of the framerate representation and is used in conjunction with the framerate divisor.

framerate_divisor

This output gives the divisor value of the framerate. It is used along with the framerate base to calculate the actual framerate.

first_index

This output provides the index of the first frame in the set. It is useful for understanding the starting point of the frame sequence.

indexed_length

This output gives the length of the indexed frames. It represents the number of frames in the set, taking into account any reindexing that may have occurred.

frame_count

This output provides the total number of frames in the set. It is useful for understanding the overall size of the frame set.

Unwrap Frame Set [DVB] Usage Tips:

• Use the "BLEND" gap_mode option if you want to create a smooth transition between frames with gaps.
• Choose the "FAIL" gap_mode option if you need to ensure that there are no gaps in the frame indices and want to catch any issues early.
• Opt for the "REINDEX" gap_mode option if you want to remove gaps by reindexing the frames, which can be useful for creating a continuous frame sequence.

Unwrap Frame Set [DVB] Common Errors and Solutions:

Frame set contains gaps!

• Explanation: This error occurs when the gap_mode is set to "FAIL" and the frame set contains gaps in the indices.
• Solution: Ensure that your frame set does not have any gaps in the indices, or change the gap_mode to "BLEND" or "REINDEX" to handle the gaps.

Frame sets have different framerate {} and {} - cannot merge!

• Explanation: This error occurs when trying to merge frame sets with different framerates.
• Solution: Ensure that the frame sets you are merging have the same framerate. You may need to adjust the framerate of one of the sets before merging.