ComfyUI Node: Preview Chooser

Preview Chooser:

The Preview Chooser node is designed to enhance your workflow by allowing you to preview images and pause the process to make selections. This node is particularly useful when you need to choose specific images or latent samples to proceed with your project. By integrating this node, you can ensure that only the most suitable images are selected, thereby improving the quality and relevance of your output. The Preview Chooser node offers various modes to control the selection process, making it flexible and adaptable to different needs. Whether you want to pause the workflow for every batch or only under certain conditions, this node provides the necessary functionality to streamline your image selection process.

Preview Chooser Input Parameters:

mode

The mode parameter determines how the node handles the selection process. It offers several options: "Always pause," "Repeat last selection," "Only pause if batch," "Progress first pick," "Pass through," "Take First n," and "Take Last n." Each mode controls whether the workflow pauses for user input or continues automatically. For example, "Always pause" will stop the workflow every time for user selection, while "Pass through" will not pause at all. This parameter allows you to customize the node's behavior to fit your specific needs.

count

The count parameter specifies the number of selections to be made. It is an integer value with a default of 1, a minimum of 1, and a maximum of 999. This parameter controls how many images or latent samples you can select during the preview phase. Adjusting this value allows you to handle different batch sizes and selection requirements effectively.

images (optional)

The images parameter accepts a list of images to be previewed. This parameter is optional and can be used to provide the images that you want to select from. If not provided, the node will operate in a read-from-stash mode, using previously stashed images for selection.

latents (optional)

The latents parameter accepts a list of latent samples. Similar to the images parameter, this is optional and can be used to provide latent samples for selection. If not provided, the node will use stashed latent samples.

masks (optional)

The masks parameter accepts a list of masks. This optional parameter can be used to provide masks that correspond to the images or latent samples. If not provided, the node will use stashed masks.

prompt (hidden)

The prompt parameter is a hidden parameter used internally to manage prompts during the selection process. It is not intended for direct user manipulation.

extra_pnginfo (hidden)

The extra_pnginfo parameter is a hidden parameter used to store additional PNG information. It is not intended for direct user manipulation.

id (hidden)

The id parameter is a hidden parameter used to uniquely identify the selection session. It ensures that the correct session data is used during the selection process.

Preview Chooser Output Parameters:

images

The images output parameter returns the selected images. This parameter provides the images that were chosen during the preview phase, allowing you to use them in subsequent steps of your workflow.

latents

The latents output parameter returns the selected latent samples. This parameter provides the latent samples that were chosen, enabling further processing or analysis.

masks

The masks output parameter returns the selected masks. This parameter provides the masks corresponding to the selected images or latent samples, which can be used for masking or other purposes.

selected

The selected output parameter returns a string indicating the selection status. This parameter provides information about the selections made, which can be useful for logging or debugging purposes.

Preview Chooser Usage Tips:

• Use the mode parameter to control the selection process according to your workflow needs. For example, use "Always pause" for manual selection or "Pass through" for automated workflows.
• Adjust the count parameter based on the number of selections you need to make. This is particularly useful when working with large batches of images or latent samples.
• Utilize the optional images, latents, and masks parameters to provide specific data for selection. If not provided, ensure that the node has access to stashed data.

Preview Chooser Common Errors and Solutions:

"No images provided"

• Explanation: This error occurs when no images are provided for selection, and there are no stashed images available.
• Solution: Ensure that you provide images through the images parameter or have stashed images available for selection.

"Invalid mode selected"

• Explanation: This error occurs when an invalid mode is selected for the mode parameter.
• Solution: Verify that the mode parameter is set to one of the valid options: "Always pause," "Repeat last selection," "Only pause if batch," "Progress first pick," "Pass through," "Take First n," or "Take Last n."

"Selection process interrupted"

• Explanation: This error occurs when the selection process is interrupted, possibly due to a cancellation or an unexpected issue.
• Solution: Check for any interruptions or cancellations in the workflow and ensure that the selection process is not being prematurely terminated.