ComfyUI Node: MVEx Frame Range Mask

MVEx Frame Range Mask:

The MVEx Frame Range Mask node is designed to facilitate the creation of video masks by generating a batch of solid masks at a specified resolution. This node is particularly useful for AI artists who need to selectively inpaint certain frames of a video clip. By allowing you to specify which frames should be fully masked and which should remain empty, it eliminates the need to manually align masks with frame counts. The node uses Python slice syntax to define frame ranges, making it intuitive for users familiar with Python. This functionality is essential for tasks that require precise control over which frames are affected by subsequent processing, ensuring that only the desired frames are altered while others remain untouched.

MVEx Frame Range Mask Input Parameters:

width

This parameter specifies the width of the mask in pixels. It determines the horizontal resolution of each frame in the batch of masks. The width can range from a minimum of 1 pixel to a maximum of 16,384 pixels, with a default value set at 832 pixels. Adjusting the width affects the aspect ratio and the level of detail captured in the mask.

height

This parameter defines the height of the mask in pixels, setting the vertical resolution for each frame in the batch. Similar to the width, the height can vary from 1 pixel to 16,384 pixels, with a default of 480 pixels. The height, in conjunction with the width, determines the overall resolution and aspect ratio of the mask.

frames

This parameter indicates the total number of frames in the batch that the node will process. It can range from 1 to 16,384 frames, with a default value of 81 frames. The number of frames directly impacts the duration of the video segment that will be masked, allowing you to tailor the mask to the specific length of your video clip.

ranges

This parameter allows you to specify which frames should be masked using a comma-separated list of frame numbers or Python-style slices. The default value is "0:24", which masks frames 0 to 23. You can use ranges like "5:", ":3", or "100:end" to define start and stop points, with the stop frame being excluded. Negative numbers can be used to count back from the end, and a single number will mask that specific frame. This flexibility enables precise control over which frames are included in the mask.

MVEx Frame Range Mask Output Parameters:

masks

This output parameter provides a batch of masks, with one mask per frame. Each mask is a binary representation where fully masked frames are set to 1, and unmasked frames are set to 0. The output is crucial for subsequent processing steps, as it defines which frames will be affected by operations like inpainting or filtering.

MVEx Frame Range Mask Usage Tips:

• Use the ranges parameter to precisely control which frames are masked, leveraging Python slice syntax for flexibility.
• Adjust the width and height parameters to match the resolution of your video content, ensuring that the masks align correctly with the frames.

MVEx Frame Range Mask Common Errors and Solutions:

'end' can only be used as the end of a range

• Explanation: This error occurs when the keyword end is used incorrectly in the frame range specification.
• Solution: Ensure that end is only used as the stop point in a range, such as 100:end.

frame is outside a batch of frames

• Explanation: This error indicates that a specified frame number is outside the valid range for the current batch size.
• Solution: Verify that all frame numbers in the ranges parameter are within the bounds of the total number of frames specified by the frames parameter.

could not read frame range ''

• Explanation: This error suggests that the frame range segment is not formatted correctly.
• Solution: Check the syntax of the frame range segment and ensure it follows the expected format, such as start:stop or start:stop:step.