ComfyUI Extension: Comfyui-TextEditor-Penguin

Authored by PenguinTeo

Created

Updated

1 stars

A text overlay node for ComfyUI that supports rich effects such as gradients, outlines, and shadows. It is suitable for adding highly customizable text content to images.

Custom Nodes (0)

    README

    🐧 Comfyui-TextEditor-Penguin

    一个用于 ComfyUI 的文本叠加节点，支持渐变、描边、阴影等丰富效果，适用于在图像上添加高度自定义的文字内容。

    📦 功能概述

    该节点允许用户在图像任意位置叠加文字，支持以下核心功能：

    • ✅ 支持多种字体格式：.ttf / .ttc / .otf

    • ✅ 精确定位：基于百分比坐标 + 锚点 + 偏移

    • ✅ 字体与样式设置：

      • 字体大小与选择
      • 单色 / 渐变填充（带角度控制）
      • 不透明度控制

    • ✅ 描边效果：宽度、颜色、不透明度

    • ✅ 阴影效果：偏移、颜色、不透明度

    🧩 输入参数

    | 参数名 | 类型 | 描述 | | ------------------- | --------------- | ----------------------------------------------- | | text | string | 要叠加的文本内容 | | image | image | 输入图像 | | x_pct/y_pct | int (0–100) | 文字相对图像的百分比坐标位置 | | h_anchor/v_anchor | enum | 水平/垂直锚点位置（left/center/right, top/center/bottom） | | offset_x/y | int | 文字偏移量（像素） | | font_size | int | 字体大小 | | font_file | dropdown | 字体文件名（来自 font/ 目录） | | text_color | hex string | 主文字颜色 | | text_opacity | float (0–1) | 主文字不透明度 | | use_gradient | bool | 是否启用渐变色 | | start_color | hex string | 渐变起始颜色 | | end_color | hex string | 渐变结束颜色 | | angle | int (-180~180) | 渐变角度 | | stroke_width | int | 描边宽度 | | stroke_color | hex string | 描边颜色 | | stroke_opacity | float (0–1) | 描边不透明度 | | shadow_x/y | int | 阴影偏移（x/y） | | shadow_color | hex string | 阴影颜色 | | shadow_opacity | float (0–1) | 阴影不透明度 |

    🖼️ 输出

    • 返回修改后的图像（含叠加文字），格式为 ComfyUI IMAGE 类型。

    📁 安装与使用

    1. 将项目放置到custom_nodes/ 目录下（覆盖旧版本）。
    2. 确保存在 font/ 目录，并放入所需字体文件（.ttf / .ttc / .otf）。
    3. 重启 ComfyUI

    📂 项目结构

    Comfyui-TextEditor-Penguin/
├── project.py        # 节点实现
└── __init__.py       # 与 ComfyUI 的接口

    🛠 兼容性与备注

    • 推荐使用 PIL ≥ 10.0，以确保 font.getbbox() 正常工作。
    • 图像需为 RGBA 模式，节点内部会自动处理 tensor → PIL 转换。
    • 若未输入文字，节点将直接返回原图。