ComfyUI Node: 🔢 Prompt Combinator Export Gallery

🔢 Prompt Combinator Export Gallery:

The PromptCombinatorExportGallery node is designed to facilitate the creation of an HTML gallery that showcases images generated by the Prompt Combinator, along with their corresponding IDs and prompts. This node is particularly useful for AI artists who want to organize and present their generated images in a structured and visually appealing format. By exporting the gallery as an HTML file, you can easily share your work with others or keep a well-organized archive of your creative outputs. The node supports various image export formats and offers the option to embed all images directly within the HTML file, making it versatile and user-friendly.

🔢 Prompt Combinator Export Gallery Input Parameters:

filename_prefix

This parameter allows you to specify a prefix for the filenames of the exported HTML gallery and associated image files. The prefix helps in organizing and identifying the exported files. The default value is "gallery". Only a single prefix is allowed, and it will be sanitized to replace any non-alphanumeric characters with underscores.

image_export_format

This parameter determines the format in which the images will be exported. The available options are ".webp lossy 80", ".webp lossy 90", ".webp lossless", and ".png lossless". The default value is ".webp lossy 90". Choosing the appropriate format can impact the quality and size of the exported images.

embed_all_images_in_html

This boolean parameter specifies whether all images should be embedded directly within the HTML file. If set to True, the images will be included as base64-encoded data within the HTML, making the file self-contained. The default value is True. If set to False, the images will be saved as separate files, and the HTML will reference these external files.

images

This parameter accepts a list of images that you want to include in the gallery. Each image must have a batch size of 1. The number of images must match the number of prompts provided.

prompts

This parameter accepts a list of prompts corresponding to the images. Each prompt is a string that describes the image. The number of prompts must match the number of images and combination IDs provided. This parameter supports multiline input and requires user input.

combination_ids

This parameter accepts a list of combination IDs generated by the Prompt Combinator. These IDs help in identifying and organizing the images and prompts. The number of combination IDs must match the number of prompts provided.

🔢 Prompt Combinator Export Gallery Output Parameters:

This node does not produce any direct output parameters. Instead, it generates an HTML file and associated image files (if not embedded) in the specified output directory.

🔢 Prompt Combinator Export Gallery Usage Tips:

• Ensure that the number of images, prompts, and combination IDs are equal to avoid assertion errors.
• Use a meaningful filename_prefix to easily identify and organize your exported galleries.
• Choose the appropriate image_export_format based on your quality and file size requirements. For high-quality images, consider using ".png lossless".
• If you plan to share the HTML file, setting embed_all_images_in_html to True can make it easier to distribute a single, self-contained file.

🔢 Prompt Combinator Export Gallery Common Errors and Solutions:

Amount of combination ids must be the same as amount of prompts

• Explanation: This error occurs when the number of combination IDs does not match the number of prompts provided.
• Solution: Ensure that the lists of combination IDs and prompts have the same length.

Amount of images must be the same as amount of prompts

• Explanation: This error occurs when the number of images does not match the number of prompts provided.
• Solution: Ensure that the lists of images and prompts have the same length.

All images must have a batch size of 1 to export a gallery. You must have done something unexpected.

• Explanation: This error occurs when one or more images have a batch size other than 1. - Solution: Ensure that all images provided have a batch size of 1.

Only a filename prefix is allowed

• Explanation: This error occurs when multiple filename prefixes are provided.
• Solution: Provide a single filename prefix.

Only an export format is allowed

• Explanation: This error occurs when multiple export formats are provided.
• Solution: Provide a single export format.

Only an embed_all_images_in_html value is allowed

• Explanation: This error occurs when multiple values for embed_all_images_in_html are provided.
• Solution: Provide a single boolean value for embed_all_images_in_html.

Saving outside the output folder is not allowed.

• Explanation: This error occurs when the specified output file or directory is outside the allowed output folder.
• Solution: Ensure that the output file and directory paths are within the allowed output folder.