ComfyUI Node: 💾 Saver Plus

💾 Saver Plus:

The SaverPlusNode is a versatile tool designed to enhance the image saving process within the ComfyUI framework. Its primary purpose is to provide a comprehensive solution for saving images with enriched metadata, ensuring that all relevant information about the image layers and their properties is preserved. This node is particularly beneficial for users who need to manage multiple image layers, as it offers the capability to merge these layers into a single image file while maintaining the option to save individual layers separately. Additionally, the node supports various output formats and allows for customization of image quality, compression levels, and transparency settings. By generating detailed save reports, the SaverPlusNode offers users a clear overview of the saved files, including their total size and format, making it an essential tool for efficient image management and documentation.

💾 Saver Plus Input Parameters:

img_tensor

The img_tensor parameter represents the image data in tensor format that you wish to save. This parameter is crucial as it contains the pixel information of the image, which will be processed and saved according to the specified settings. The tensor format is commonly used in machine learning and image processing tasks, allowing for efficient manipulation and storage of image data.

filename

The filename parameter specifies the name of the file under which the image will be saved. This is important for organizing and identifying saved images, especially when dealing with multiple files. The filename should be unique within the save path to avoid overwriting existing files.

layer_name

The layer_name parameter is used to identify the specific layer of the image being saved. This is particularly useful when saving images with multiple layers, as it allows you to keep track of each layer's properties and metadata separately.

save_path

The save_path parameter determines the directory where the image files will be saved. It is essential to ensure that the specified path exists and is writable, as this is where all output files, including metadata, will be stored.

output_format

The output_format parameter defines the format in which the image will be saved, such as JPEG, PNG, or others. This choice affects the image's compatibility with different applications and its file size, with some formats offering better compression or quality preservation.

quality

The quality parameter controls the quality of the saved image, typically ranging from 1 to 100. Higher values result in better image quality but larger file sizes, while lower values reduce quality and file size. This parameter is particularly relevant for lossy formats like JPEG.

compression_level

The compression_level parameter adjusts the level of compression applied to the image file. Higher compression levels reduce file size but may affect image quality, while lower levels preserve quality at the cost of larger file sizes. This is especially important for formats like PNG.

preserve_transparency

The preserve_transparency parameter is a boolean that determines whether the image's transparency should be maintained in the saved file. This is crucial for images with transparent backgrounds or layers, ensuring that the visual integrity of the image is preserved.

auto_optimize

The auto_optimize parameter is a boolean that, when enabled, automatically optimizes the image for the best balance between quality and file size. This feature is useful for users who want to ensure efficient storage without manually adjusting quality and compression settings.

include_merged

The include_merged parameter is a boolean that specifies whether to create and save a merged version of all image layers. This is useful for users who need a single composite image in addition to individual layers, providing flexibility in how images are stored and used.

save_metadata

The save_metadata parameter is a boolean that indicates whether to save enriched metadata alongside the image files. This metadata includes information about the image layers, dimensions, and other properties, which can be valuable for documentation and future reference.

💾 Saver Plus Output Parameters:

save_info

The save_info output provides a detailed report of the save operation, including the total number of files saved, their combined size, and the format used. This information helps you verify that the save process was successful and provides a quick overview of the output.

final_save_path

The final_save_path output indicates the directory where the image files and metadata were saved. This is useful for quickly locating the saved files and ensuring that they are stored in the intended location.

💾 Saver Plus Usage Tips:

• Ensure that the save_path is correctly set and accessible to avoid errors during the save process.
• Use the auto_optimize feature to automatically balance image quality and file size, especially when dealing with large batches of images.
• Consider enabling include_merged if you need a single composite image in addition to individual layers, as this can simplify image management.

💾 Saver Plus Common Errors and Solutions:

FileNotFoundError: [Errno 2] No such file or directory

• Explanation: This error occurs when the specified save_path does not exist or is incorrect.
• Solution: Verify that the save_path is correct and that the directory exists. Create the directory if it does not.

PermissionError: [Errno 13] Permission denied

• Explanation: This error indicates that the program does not have permission to write to the specified save_path.
• Solution: Check the directory permissions and ensure that the program has write access. Adjust permissions if necessary.

ValueError: Invalid output format

• Explanation: This error occurs when an unsupported output_format is specified.
• Solution: Ensure that the output_format is one of the supported formats, such as JPEG or PNG.