ComfyUI-StrokeReveal

ComfyUI-StrokeReveal

A ComfyUI custom node that creates an animated stroke reveal effect, where a brush/pen follows a mask edge to reveal an image underneath.

Example Workflow

The example workflow is available in the ComfyUI template browser under Workflow → Browse Templates → ComfyUI-StrokeReveal.

You can also find it directly at example_workflows/StrokeReveal.json.

Features

• Reveals a static image through an animated pen stroke effect
• Pen tip follows the mask edge during animation
• Supports 8 different drawing directions
• Feathered edge blending for smooth transitions
• Customizable number of frames and pen scale

Installation

1. Clone or download this repository into your ComfyUI/custom_nodes/ folder
2. Install the requirements:

   pip install -r requirements.txt
   

3. Restart ComfyUI

Node: Stroke Reveal Animation

Inputs

| Input | Type | Description | |-------|------|-------------| | static_image | IMAGE | The image to be revealed | | mask | MASK | The mask area defining where the reveal happens | | background_image | IMAGE | The background shown before reveal | | pen_tip | IMAGE | PNG image of the pen tip (with transparency) | | num_frames | INT | Number of frames in the animation (2-500, default: 30) | | draw_direction | ENUM | Direction of the reveal animation | | feather_radius | INT | Blur radius for edge feathering (0-100, default: 10) | | pen_scale | FLOAT | Scale factor for the pen tip (0.1-5.0, default: 1.0) |

Draw Directions

• left_to_right (default)
• right_to_left
• top_to_bottom
• bottom_to_top
• top_left_to_bottom_right
• top_right_to_bottom_left
• bottom_left_to_top_right
• bottom_right_to_top_left

Output

| Output | Type | Description | |--------|------|-------------| | images | IMAGE | Batch of frames showing the reveal animation |

How It Works

1. At the beginning, the mask area is filled with the background image with a feathered edge
2. As the animation progresses, the pen tip moves along the mask edge
3. The area behind the pen tip is progressively revealed with the static image
4. The final frame shows the complete static image

Example Workflow

1. Load your static image
2. Create or load a mask defining the reveal area
3. Load a background image
4. Load a pen tip PNG with transparency
5. Connect all inputs to the Stroke Reveal Animation node
6. Set desired number of frames and direction
7. Connect output to a video/GIF encoder or preview

License

MIT License