LayerUtility: Image Reel Node Documentation

Overview

The LayerUtility: Image Reel node is part of the ComfyUI extension "LayerStyle" available on GitHub here. This node is designed to construct a visual "reel" of images in sequence, each accompanied by a textual label. It allows users to create a single composite image with multiple images aligned horizontally with a specific border and height, ideal for showcasing a series of related images.

Functionality

What This Node Does

The Image Reel node creates a horizontal reel of up to four images, resizing them to a specified height and arranging them with borders in between. Each image can be annotated with a text label. This functionality is useful for generating dynamic image galleries, slideshows or composite visualizations within ComfyUI.

Inputs

Required Inputs

1. image1: The first image to be included in the reel. This input is mandatory.
2. image1_text: A label for the first image. This input is a string with a default value of "image1".
3. image2_text: A label for the optional second image. This input is a string with a default value of "image2".
4. image3_text: A label for the optional third image. This input is a string with a default value of "image3".
5. image4_text: A label for the optional fourth image. This input is a string with a default value of "image4".
6. reel_height: The height to which all images should be resized. This is an integer input, with a default value of 512 and a range between 64 and 2048.
7. border: The space between images in the reel. This is an integer input, with a default value of 32 and a range between 8 and 512.

Optional Inputs

1. image2: The second image to be added to the reel, if available.
2. image3: The third image to be added to the reel, if available.
3. image4: The fourth image to be added to the reel, if available.

Outputs

• reel: The output is a composite image, termed as "Reel", which holds the aligned images with their respective text labels, resized and spaced as specified by the input parameters.

Use in ComfyUI Workflows

The Image Reel node can be flexibly integrated into ComfyUI workflows to achieve specific visual outcomes. It is particularly useful for:

• Creating Visual Storyboards: Sequence images with descriptive labels to illustrate a narrative or a series of events.
• Image Comparison: Visually compare multiple images side by side with labels denoting differences or context.
• Gallery Creation: Assemble a small gallery or image set for preview or export for further usage.

Special Features or Considerations

• Dynamic Resizing: All images are resized to maintain a consistent height across the reel, ensuring visual uniformity.
• Text Annotations: Text labels help in identifying or describing each image in the sequence, enhancing context delivery.
• Flexible Layout Options: Users can opt to include up to four images and customize borders, catering to a variety of layout requirements.
• Integration with Other Nodes: The output from the Image Reel node can be used as an input to other nodes, such as compositing or processing nodes, to further enhance or manipulate the image in a larger workflow.

This node offers a streamlined solution for those needing a quick and customizable way to assemble and present a series of images in a unified format, making it a valuable tool in the ComfyUI suite.