ComfyUI Node: GR Scroller

GR Scroller:

The GR Scroller node is designed to create dynamic scrolling text animations within a video frame. This node allows you to animate text in various directions, including left, right, up, and down, as well as more complex movements like diagonal, spiral, flip, and random walk. By leveraging this node, you can add visually appealing text effects to your videos, enhancing their overall aesthetic and making them more engaging. The GR Scroller node is particularly useful for creating animated titles, credits, or any other text-based animations that require smooth and customizable movement across the screen.

GR Scroller Input Parameters:

movement_type

This parameter defines the type of movement for the scrolling text. Options include "scroll" for linear movements in specified directions, "diagonal" for diagonal scrolling, "spiral" for spiral movements, "flip" for flipping the text, and "random_walk" for random movements. The choice of movement type significantly impacts the visual style of the text animation.

scroll_direction

When the movement_type is set to "scroll", this parameter specifies the direction of the scroll. Options include "left", "right", "up", and "down". This determines the direction in which the text will move across the screen.

scroll_speed

This parameter controls the speed of the scrolling text. It is typically measured in pixels per frame. Higher values result in faster scrolling, while lower values produce slower movements. Adjusting the scroll speed allows you to fine-tune the pacing of the text animation.

font

Specifies the font to be used for the scrolling text. The choice of font affects the readability and style of the text. Ensure that the selected font is legible and matches the overall design of your video.

font_color

Defines the color of the text. This can be set using standard color names or hexadecimal color codes. The font color should contrast well with the background to ensure the text is easily readable.

font_stroke

Enables or disables the stroke (outline) around the text. This can enhance the visibility of the text, especially against complex backgrounds.

font_stroke_thickness

Specifies the thickness of the text stroke. This parameter is only relevant if font_stroke is enabled. Thicker strokes can make the text more prominent, while thinner strokes provide a subtler effect.

font_stroke_colour

Defines the color of the text stroke. This should be chosen to complement the font color and background, enhancing the overall readability of the text.

movement_duration

Sets the duration of the text movement in seconds. This determines how long the text will animate across the screen before repeating or stopping.

fps

Frames per second for the animation. This affects the smoothness of the text movement. Higher FPS values result in smoother animations but may require more processing power.

resolution

Specifies the resolution of the video frame. Common options include standard resolutions like 720p, 1080p, etc. The resolution impacts the overall quality and size of the video.

use_background_image

A boolean parameter that determines whether a background image should be used. If set to true, the background image will be displayed behind the scrolling text.

background_image

The image to be used as the background. This can be a file path or a tensor representing the image. The background image provides context and enhances the visual appeal of the text animation.

background_colour

Defines the background color if no background image is used. This can be set using standard color names or hexadecimal color codes. The background color should contrast well with the text color.

upscale

An integer parameter that determines the upscaling factor for the background image. Higher values result in a larger, more detailed background image.

GR Scroller Output Parameters:

frames

A list of frames that make up the animated text sequence. Each frame is an image with the text rendered at its respective position. These frames can be compiled into a video to create the final animation.

foreground_frames

A list of frames containing only the text without the background. These frames can be used for further compositing or effects in video editing software.

GR Scroller Usage Tips:

• Experiment with different movement types and directions to create unique text animations that suit your video's theme.
• Adjust the scroll speed and movement duration to synchronize the text animation with other elements in your video.
• Use contrasting font and background colors to ensure the text is easily readable.
• Enable font stroke and adjust its thickness and color to enhance text visibility against complex backgrounds.
• Choose an appropriate resolution and FPS to balance animation smoothness and processing requirements.

GR Scroller Common Errors and Solutions:

"Invalid font specified"

• Explanation: The font specified is not recognized or available.
• Solution: Ensure that the font name is correct and that the font is installed on your system.

"Background image not found"

• Explanation: The specified background image file path is incorrect or the file does not exist.
• Solution: Verify the file path and ensure the background image file is accessible.

"Invalid color code"

• Explanation: The color code provided for font_color or background_colour is not valid.
• Solution: Use standard color names or correct hexadecimal color codes.

"Resolution not supported"

• Explanation: The specified resolution is not available or supported by the node.
• Solution: Choose a standard resolution like 720p or 1080p.

"Frame index out of range"

• Explanation: The frame index exceeds the total number of frames in the animation.
• Solution: Ensure that the movement_duration and fps parameters are set correctly to generate the appropriate number of frames.