ComfyUI Node: ⚋ Frame Counter (Directory)

Frame Counter (Directory) [Dream]:

The Frame Counter (Directory) [Dream] node is designed to facilitate the management and tracking of frames within a specified directory, making it an essential tool for animation projects. This node scans a directory for image files that match a given pattern and counts the number of frames, allowing you to keep track of the current frame number in an animation sequence. It supports both numeric and alphabetic indexing, ensuring flexibility in how frames are organized and accessed. By providing a total frame count and frames per second, it helps in synchronizing animations and maintaining a consistent frame rate, which is crucial for smooth playback and accurate timing in your projects.

Frame Counter (Directory) [Dream] Input Parameters:

directory_path

This parameter specifies the path to the directory where the image files are stored. It is a string input and should be the location where your animation frames are saved. The default value is an empty string, and it does not support multiline input.

pattern

The pattern parameter allows you to define the file naming pattern for the images you want to include in the frame count. It is a string input with a default value of *, which means it will match all files. You can specify more precise patterns to match specific file types or naming conventions.

indexing

This parameter determines the method used to index the frames. It offers two options: numeric and alphabetic order. Numeric indexing will count frames based on numerical order, while alphabetic order will count frames based on their alphabetical order. This choice affects how the frames are sorted and counted.

total_frames

The total_frames parameter sets the total number of frames in the animation sequence. It is an integer input with a default value of 100. The minimum value is 2, and the maximum value is 24 * 3600 * 60, which allows for a wide range of frame counts suitable for various animation lengths.

frames_per_second

This parameter defines the frame rate of the animation in frames per second (FPS). It is an integer input with a default value of 30 and a minimum value of 1. This setting is crucial for determining the playback speed and timing of the animation.

Frame Counter (Directory) [Dream] Output Parameters:

frame_counter

The frame_counter output is an instance of the FrameCounter class. It provides the current frame number, total frames, and frames per second. This output is essential for tracking the progress of the animation and synchronizing frame-related operations. It helps in determining the current position within the animation sequence and ensures that the animation runs smoothly and accurately.

Frame Counter (Directory) [Dream] Usage Tips:

• Ensure that the directory_path is correctly specified and points to the folder containing your animation frames to avoid any issues with frame counting.
• Use the pattern parameter to filter specific file types or naming conventions, which can help in organizing and managing large sets of frames more efficiently.
• Choose the appropriate indexing method (numeric or alphabetic order) based on how your frames are named to ensure accurate frame counting and sequencing.
• Adjust the total_frames and frames_per_second parameters to match the requirements of your animation project, ensuring smooth playback and correct timing.

Frame Counter (Directory) [Dream] Common Errors and Solutions:

Directory not found

• Explanation: The specified directory_path does not exist or is incorrect.
• Solution: Verify that the directory_path is correct and that the directory exists. Ensure there are no typos or missing parts in the path.

No matching files found

• Explanation: No files in the directory match the specified pattern.
• Solution: Check the pattern parameter to ensure it correctly matches the file names in the directory. Adjust the pattern if necessary to include the desired files.

Invalid total_frames value

• Explanation: The total_frames parameter is set to a value outside the allowed range.
• Solution: Ensure that total_frames is set to a value between 2 and 24 * 3600 * 60. Adjust the value to fall within this range.

Invalid frames_per_second value

• Explanation: The frames_per_second parameter is set to a value less than 1.
• Solution: Set the frames_per_second parameter to a value of 1 or higher to ensure a valid frame rate for the animation.