ComfyUI Node: SaveFrame

SaveFrame:

The SaveFrame node is designed to save an image frame to a specified directory on your system. This node is particularly useful for AI artists who need to store generated frames for further processing or archival purposes. By using this node, you can ensure that each frame is saved with a unique filename, which includes a batch name and a frame number, making it easy to organize and retrieve your images later. The node handles the creation of the output directory if it does not already exist, and it converts the image data into a format suitable for saving as a PNG file. This functionality is essential for workflows that involve generating and saving multiple frames, such as in video processing or animation projects.

SaveFrame Input Parameters:

image

This parameter expects an image tensor that represents the frame you want to save. The image data should be in a format that can be processed and converted into a PNG file. The node will handle the necessary transformations to ensure the image is saved correctly.

output_dir

This parameter specifies the directory where the image frame will be saved. It should be a string representing the path to the desired output directory. If the directory does not exist, the node will create it. The default value is an empty string, which means you need to provide a valid path.

batch_name

This parameter allows you to specify a name for the batch of frames being saved. It is a string that will be included in the filename of each saved frame, helping you to organize and identify your images. The default value is "ComfyWarp".

frame_number

This parameter is an integer that represents the frame number of the image being saved. It is used to generate a unique filename for each frame. The frame number should be between 0 and 9999999999, with a default value of 0.

SaveFrame Output Parameters:

None

The SaveFrame node does not produce any output parameters. Its primary function is to save the provided image frame to the specified directory.

SaveFrame Usage Tips:

• Ensure that the output_dir parameter is set to a valid directory path where you have write permissions. This will prevent any issues related to directory creation or file saving.
• Use meaningful batch_name values to easily identify and organize your saved frames, especially when working on multiple projects or batches.
• Increment the frame_number parameter for each frame you save to avoid overwriting existing files and to maintain a sequential order of your frames.

SaveFrame Common Errors and Solutions:

"Permission denied: '/path/to/output_dir'"

• Explanation: This error occurs when the node does not have the necessary permissions to create or write to the specified output directory.
• Solution: Ensure that you have write permissions for the specified directory. You may need to change the directory permissions or choose a different output directory where you have the necessary access rights.

"Invalid frame number: -1"

• Explanation: The frame number provided is outside the valid range (0 to 9999999999).
• Solution: Ensure that the frame_number parameter is set to a valid integer within the specified range.

"Image data is not in the expected format"

• Explanation: The image tensor provided is not in a format that can be processed and saved as a PNG file.
• Solution: Verify that the image data is correctly formatted and compatible with the node's processing requirements. Ensure that the image tensor is properly normalized and contains valid pixel values.