Advanced Text Overlay - Video:
The Advanced Text Overlay
- Video node is designed to enhance video content by overlaying text with advanced styling and animation capabilities. This node allows you to add dynamic text elements to your videos, utilizing the same sophisticated text and animation controls as the TextOverlay node. It animates text over the initial frames of the video, providing a smooth transition before holding the final pose for the remainder of the video. This feature is particularly beneficial for creating engaging video content with professional-looking text animations. The node also offers options to manage the original video file post-processing, ensuring a streamlined workflow.
Advanced Text Overlay - Video Input Parameters:
video_path
This parameter specifies the full file path of the video you wish to process. It is a string input that directs the node to the source video file. The correct path is crucial for the node to access and modify the video content.
filename_prefix
This string parameter allows you to set a prefix for the output video file's name. By default, it is set to "TxtOver", helping you easily identify processed files in your output directory.
delete_original
A boolean parameter that determines whether the original video file should be deleted after processing. By default, this is set to False, meaning the original file is retained unless specified otherwise. This option helps manage storage space by removing unnecessary files.
pause_seconds_before_start
This parameter, expressed in seconds, defines the delay before the text overlay begins. It replaces the pause_frames_before_start from the image-based node, adapting it for video timing.
text
The text content to be overlaid on the video. This parameter allows you to input the specific text you want to display, which can be styled and animated according to your preferences.
all_caps
A boolean parameter that, when enabled, converts all text to uppercase. This can be useful for maintaining consistency in text appearance or emphasizing certain text elements.
font
This parameter specifies the font style to be used for the text overlay. Choosing the right font can significantly impact the readability and aesthetic of the text.
font_size
Defines the size of the text in the overlay. Adjusting this parameter allows you to scale the text to fit the video frame appropriately.
letter_spacing
This parameter controls the spacing between individual letters in the text. It can be adjusted to improve text readability or achieve a specific visual style.
font_alignment
Specifies the alignment of the text within its bounding box. Options typically include left, center, and right alignment, affecting how the text is positioned relative to its container.
fill_color_hex
A string parameter that sets the color of the text using a hexadecimal color code. This allows for precise color customization to match your video's theme.
fill_alpha
This parameter controls the transparency of the text fill, with values ranging from 0.0 (completely transparent) to 1.0 (fully opaque). It enables you to blend the text with the video background.
padding
Defines the space between the text and its bounding box edges. Adjusting padding can help ensure the text does not appear cramped or too close to other elements.
vertical_alignment
Specifies the vertical positioning of the text within its bounding box, with options such as top, middle, and bottom. This affects how the text is vertically aligned in relation to its container.
y_shift
This parameter allows you to shift the text vertically within the video frame. It provides fine control over the text's vertical positioning.
horizontal_alignment
Determines the horizontal positioning of the text within its bounding box, with options like left, center, and right. This affects how the text is horizontally aligned in relation to its container.
x_shift
Allows you to shift the text horizontally within the video frame, providing fine control over the text's horizontal positioning.
line_spacing
Controls the spacing between lines of text in multiline text overlays. Adjusting this parameter can improve readability and visual appeal.
stroke_enable
A boolean parameter that, when enabled, adds a stroke (outline) to the text. This can enhance text visibility against complex backgrounds.
stroke_color_hex
Specifies the color of the text stroke using a hexadecimal color code. This allows for precise customization of the stroke color.
stroke_thickness
Defines the thickness of the text stroke. Adjusting this parameter can help the text stand out more prominently.
stroke_alpha
Controls the transparency of the text stroke, with values ranging from 0.0 (completely transparent) to 1.0 (fully opaque). This allows for blending the stroke with the video background.
bg_enable
A boolean parameter that, when enabled, adds a background box behind the text. This can improve text readability against busy video backgrounds.
bg_padding
Defines the padding around the background box, affecting the space between the text and the box edges.
bg_radius
Specifies the corner radius of the background box, allowing for rounded corners and a softer appearance.
bg_color_hex
Sets the color of the background box using a hexadecimal color code, enabling precise color customization.
bg_alpha
Controls the transparency of the background box, with values ranging from 0.0 (completely transparent) to 1.0 (fully opaque). This allows for blending the box with the video background.
shadow_enable
A boolean parameter that, when enabled, adds a shadow effect to the text. This can enhance text visibility and create a sense of depth.
shadow_distance
Defines the distance of the shadow from the text, affecting the shadow's position and intensity.
shadow_color_hex
Specifies the color of the shadow using a hexadecimal color code, allowing for precise customization of the shadow color.
shadow_alpha
Controls the transparency of the shadow, with values ranging from 0.0 (completely transparent) to 1.0 (fully opaque). This allows for blending the shadow with the video background.
animate
A boolean parameter that, when enabled, activates text animation. This can add dynamic movement to the text, making it more engaging.
animation_kind
Specifies the type of animation to be applied to the text, with options such as fade_in, fade_out, move_from_top, move_from_bottom, move_from_left, and move_from_right. This determines how the text enters or exits the frame.
animation_frames
Defines the number of frames over which the animation occurs. This parameter controls the duration and smoothness of the animation.
animation_ease
Specifies the easing function for the animation, with options like linear, ease_in, ease_out, and ease_in_out. This affects the animation's acceleration and deceleration.
animation_opacity_target
Sets the target opacity for the animation, with values ranging from 0.0 (completely transparent) to 1.0 (fully opaque). This determines the final opacity of the text after the animation.
Advanced Text Overlay - Video Output Parameters:
video_path
The output parameter returns a string containing the full path of the processed video file in ComfyUI's output folder. This path is essential for locating and accessing the modified video, ensuring you can easily retrieve and use the final product.
Advanced Text Overlay - Video Usage Tips:
- Ensure the video path is correctly specified to avoid processing errors and ensure the node can access the video file.
- Utilize the animation features to create engaging text overlays that capture viewers' attention, experimenting with different animation kinds and easing functions for varied effects.
- Consider enabling the
delete_originaloption if you need to manage storage space efficiently, especially when working with large video files.
Advanced Text Overlay - Video Common Errors and Solutions:
Failed to delete original video
- Explanation: This error occurs when the node attempts to delete the original video file after processing, but encounters an issue, such as file permissions or the file being in use.
- Solution: Ensure the video file is not open in any other application and that you have the necessary permissions to delete files in the directory. If the problem persists, manually delete the file after processing.
Invalid video path
- Explanation: This error arises when the specified video path is incorrect or the file does not exist at the given location.
- Solution: Double-check the video path for accuracy, ensuring it points to an existing file. Correct any typos or path errors and try again.