ComfyUI Node: ◎ Radiance Read (Sequence)

◎ Radiance Read (Sequence):

RadianceReadSequence is a professional-grade node designed to read image sequences from a specified folder or pattern, supporting a variety of formats including EXR, HDR, PNG, JPG, and TIFF. This node is particularly beneficial for artists and developers working with image sequences in visual effects, animation, or any field requiring batch processing of images. It efficiently handles the reading of image sequences, applying necessary color transformations to ensure compatibility with downstream processes. By providing a seamless way to manage and process large sets of images, RadianceReadSequence enhances workflow efficiency and ensures that the images are ready for further manipulation or analysis.

◎ Radiance Read (Sequence) Input Parameters:

folder_path

This parameter specifies the directory path where the image sequence is located. It is crucial for directing the node to the correct location to fetch the images. The default value is set to C:/Projects/Sequences/Shot01, but it can be adjusted to any valid directory path where your image sequence resides.

pattern

The pattern parameter allows you to define a glob pattern to match specific files within the folder. This is useful for filtering the files you want to process, such as *.exr or Shot_*.exr. The default pattern is *.exr, and it helps in selecting only the relevant files from a potentially large set of images.

start_frame

This integer parameter determines the starting frame number in the filename from which the sequence reading should begin. If set to 0, the node will automatically detect the first frame. The default value is 1001, with a range from 0 to 999999, allowing flexibility in choosing the starting point of the sequence.

frame_limit

The frame_limit parameter specifies the maximum number of frames to read from the sequence. This is useful for controlling the amount of data processed, especially when dealing with large sequences. The default value is not explicitly provided in the context, but it can be set to any positive integer to limit the number of frames read.

◎ Radiance Read (Sequence) Output Parameters:

IMAGE

This output provides a batch of images read from the specified sequence. It is the primary output that contains the processed image data ready for further use in your workflow.

MASK

The MASK output contains any mask data associated with the images, which can be used for compositing or other image processing tasks.

frame_count

This output indicates the total number of frames successfully read from the sequence, providing a quick reference to the size of the batch processed.

width

The width output specifies the width of the images in the sequence, ensuring that subsequent nodes or processes can handle the images correctly.

height

Similar to width, the height output provides the height of the images, which is essential for maintaining the correct aspect ratio and resolution in further processing.

fps

The fps output denotes the frames per second of the sequence, which is crucial for timing and synchronization in animations or video sequences.

filename_list

This output provides a list of filenames that were read, offering a reference for tracking and verifying the images processed in the sequence.

◎ Radiance Read (Sequence) Usage Tips:

• Ensure that the folder_path is correctly set to the directory containing your image sequence to avoid file not found errors.
• Use the pattern parameter to filter and select only the necessary files, which can significantly speed up the processing time.
• Adjust the start_frame and frame_limit parameters to manage large sequences effectively, allowing you to focus on specific segments of your project.

◎ Radiance Read (Sequence) Common Errors and Solutions:

Folder not found: <folder_path>

• Explanation: This error occurs when the specified folder path does not exist or is incorrect.
• Solution: Double-check the folder_path parameter to ensure it points to a valid directory containing your image sequence.

No files found matching '<pattern>' in <folder_path>

• Explanation: This error indicates that no files matching the specified pattern were found in the given folder.
• Solution: Verify the pattern parameter to ensure it correctly matches the filenames of the images you intend to process. Adjust the pattern if necessary to capture the correct files.