🔤 CR Overlay Text

节点功能:用于在现有图像上叠加文本。该节点允许用户自定义文本的字体、大小、颜色、位置和旋转等属性。

输入参数

参数名称说明
image需要叠加文字的输入图像。

输出参数

参数名称说明
IMAGE添加了文字覆盖的图像。
show_help节点的帮助文档链接。

控件参数

参数名称说明
text要绘制的文字内容,支持多行输入。
font_name从 /fonts 目录中加载的字体列表(仅支持 .ttf)。
font_size文字大小,范围 1~1024,单位为像素。
font_color字体颜色,可选择系统内置色值。
align水平对齐方式(如左对齐、居中、右对齐)。
justify垂直对齐方式(如顶部、居中、底部)。
margins文本块的边距,单位为像素,支持负值用于外扩。
line_spacing多行文本的行间距。正值增加间距,负值压缩文字行。
position_x文字的水平位置偏移,单位为像素。可用于精确调整文本放置位置。
position_y文字的垂直位置偏移,单位为像素。正值向下偏移,负值向上偏移。
rotation_angle文字旋转角度,范围为 -360°~360°。可用于倾斜、斜切风格文本展示。
rotation_options旋转参考点选项,如绕中心旋转、绕左上角旋转等。决定旋转时的锚点位置。
font_color_hex当 font_color 为 "custom" 时,使用此十六进制颜色值设定字体颜色(如 #FF0000)。


margins: 边距,字体在图像边缘时,该参数有效。


line_spacing: 行间距,多行文本时生效。


  • 使用"text center"时,文本会围绕自身中心旋转,位置基本保持不变
  • 使用"image center"时,文本会围绕图像中心旋转,这会导致文本在旋转的同时也会改变在图像中的位置