GIMP Python-Fu：如何通过API调整文本层文本框大小

问题根因 #

你调用的pdb.gimp_text_fontname()默认生成的是无边界自动扩展的自由文本层，没有绑定固定文本框尺寸，因此不会显示调整手柄，文本过长时会直接溢出画布。你之前尝试的两种方案不生效的原因：

• 调用普通图层resize接口：该接口面向像素层设计，作用于文本层时会强制将矢量文本光栅化（也就是你说的“锚定图像”），转换为不可编辑的像素层。
• 预先创建固定尺寸图层：gimp_text_fontname会独立新建文本层，完全不会复用你提前创建的普通图层，因此尺寸限制不会生效。

正确实现方案 #

使用GIMP文本层专用API创建固定尺寸文本框，核心是先初始化文本层、设置文本框边界与换行规则，再写入文本内容，全程不会破坏文本的可编辑属性，创建后可正常选中调整手柄手动缩放。

关键API说明

• pdb.gimp_text_layer_new()：初始化空白可编辑文本层，不会自动扩展边界
• pdb.gimp_text_layer_set_box_width()/set_box_height()：设置文本框的固定宽高，单位为像素
• pdb.gimp_text_layer_set_wrap_mode()：设置文本换行规则，传WRAP_WORD即可实现按词自动换行，避免文本溢出
• 注意：调整文本框尺寸请用文本层专用的pdb.gimp_text_layer_resize()，不要用通用图层resize接口，避免光栅化问题。

修正后可直接运行的代码

list_of_text = [
"long string one", 
"long string two ",
]

x=200
y=400
border=0
font_size=62
font="Merriweather"
path='/Users/incognito/blank_card.xcf'
# 自定义固定文本框尺寸，根据你的卡片大小调整即可
text_box_width = 900
text_box_height = 500

for text in list_of_text:
    image = pdb.gimp_file_load(path, '1')
    gimp.Display(image)

    # 初始化空白文本层
    text_layer = pdb.gimp_text_layer_new(
        image,
        "",  # 初始留空，后续统一设置文本
        font,
        font_size,
        PIXELS
    )
    # 设置文本框固定尺寸
    pdb.gimp_text_layer_set_box_width(text_layer, text_box_width)
    pdb.gimp_text_layer_set_box_height(text_layer, text_box_height)
    # 设置按词自动换行
    pdb.gimp_text_layer_set_wrap_mode(text_layer, WRAP_WORD)
    # 设置文本边距，和原脚本border参数逻辑一致
    pdb.gimp_text_layer_set_border(text_layer, border)
    # 设置文本颜色，无需单独改全局前景色
    pdb.gimp_text_layer_set_color(text_layer, (23, 18, 20))
    # 将文本层插入图像
    image.insert_layer(text_layer, None, 0)
    # 设置文本层位置
    text_layer.set_offsets(x, y)
    # 写入文本内容，文本会自动在固定框内换行适配
    pdb.gimp_text_layer_set_text(text_layer, text)

运行后生成的文本层会严格限制在你设定的框范围内，长文本自动换行，在GIMP界面中可正常选中文本框的调整手柄手动缩放，文本会实时重排，不会出现锚定、不可编辑的问题。

内容的提问来源于stack exchange，提问作者Incognito