ComfyUI Node: Plot Block Params

Plot Block Params:

The PlotBlockParams node is designed to facilitate the visualization of parameters associated with image blocks in a structured and coherent manner. This node is particularly useful for AI artists who need to overlay parameter information onto images, making it easier to analyze and interpret the data visually. By leveraging the capabilities of the Python Imaging Library (PIL), this node allows you to add text annotations to images, ensuring that each image is accompanied by its corresponding parameters. This can be especially beneficial for debugging, presentations, or any scenario where understanding the relationship between images and their parameters is crucial.

Plot Block Params Input Parameters:

images

This parameter expects a batch of images in tensor format. Each image in the batch will be processed to include the corresponding parameter information. The images should be in the shape of (batch_size, height, width, channels). The quality and clarity of the annotations depend on the resolution of these images.

params

This parameter is a list of dictionaries, where each dictionary contains the parameters to be annotated on the corresponding image. The number of dictionaries in this list should match the number of images provided. Each dictionary should have keys like regex and value that will be used to generate the text annotations.

add_params

This parameter is a string that determines whether to add parameter annotations to the images. If set to "false", no annotations will be added. Any other value will result in the parameters being annotated on the images. This allows for flexible control over whether or not to include parameter information in the output images.

cols_num

This parameter is an integer that specifies the number of columns to arrange the images in the final output. If set to 0, the node will automatically calculate the number of columns based on the square root of the number of images, ensuring a balanced grid layout. This helps in organizing the images neatly for better visualization.

Plot Block Params Output Parameters:

out_image

This output parameter is a tensor containing the batch of images with the parameter annotations added. The images are returned in the shape of (batch_size, height, width, channels), ready for further processing or visualization. This output allows you to easily see the relationship between each image and its corresponding parameters.

Plot Block Params Usage Tips:

• Ensure that the number of images matches the number of parameter dictionaries to avoid errors.
• Use high-resolution images to maintain the clarity of the text annotations.
• Set add_params to "false" if you want to visualize the images without any annotations for a cleaner look.
• Adjust cols_num to control the layout of the output images, especially when dealing with a large batch of images.

Plot Block Params Common Errors and Solutions:

"Number of images and number of parameters do not match."

• Explanation: This error occurs when the number of images provided does not match the number of parameter dictionaries.
• Solution: Ensure that the length of the params list matches the number of images in the images tensor.

"Font file not found."

• Explanation: This error occurs if the specified font file is not found in the expected directory.
• Solution: Verify that the font file ShareTechMono-Regular.ttf is present in the FONTS_DIR directory and that the path is correctly specified.

"Invalid image shape."

• Explanation: This error occurs if the images are not in the expected shape of (batch_size, height, width, channels).
• Solution: Ensure that the images are correctly formatted and reshaped before passing them to the node.

"Invalid parameter format."

• Explanation: This error occurs if the parameter dictionaries do not contain the expected keys (regex and value).
• Solution: Verify that each dictionary in the params list contains the required keys and that the values are correctly formatted.