GIMP Python Fu插件未在滤镜菜单显示，求代码排查与修复

问题描述 #

开发的Python Fu插件未出现在GIMP菜单中，代码如下：

#!/usr/bin/env python

from gimpfu import *
import random as rd

def encode(image, drawable):
    newDrawable = drawable
    width = pdb.gimp_image_width(image)
    height = pdb.gimp_image_height(image)
    initialLayer = pdb.gimp_image_get_active_layer(image)
    title1 = ""
    title2 = ""
    for k in range(10):
        title1 += str(rd.randint(0,10))
        title2 += str(rd.randint(0,10))
    layer1 = pdb.gimp_layer_new(image, width, height, 0, "title1", 100, 0)
    layer2 = pdb.gimp_layer_new(image, width, height, 0, "title2", 100, 0)
    image.add_layer(layer1)
    image.add_layer(layer2)
    # Passe en revue l'intégralité des pixels
    for x in range (width):
        for y in range(height):
            #Lecture
            pdb.gimp_image_set_active_layer(image, initialLayer)
            newDrawable = image.layers[2]
            pixel = pdb.gimp_drawable_get_pixel(newDrawable, x, y)[1]
            #Mélange aléatoire des valeurs RVB
            newPixel1 = (rd.randint(0,pixel[0]+1), rd.randint(1,pixel[1]+1), rd.randint(2,pixel[2]+1))
            newPixel2 = (pixel[0] - newPixel1[0], pixel[1]- newPixel1[1], pixel[2]- newPixel1[2])
            #Écriture
            pdb.gimp_image_set_active_layer(image, layer1)
            newDrawable = image.layers[1]
            pdb.gimp_drawable_set_pixel(newDrawable, x, y, 3, newPixel1)
            pdb.gimp_drawable_update(newDrawable, 0, 0, width, height)
            pdb.gimp_image_set_active_layer(image, layer2)
            newDrawable = image.layers[0]
            pdb.gimp_drawable_set_pixel(newDrawable, x, y, 3, newPixel2)
            pdb.gimp_drawable_update(newDrawable, 0, 0, width, height)


register(
    "python_fu_encode",
    "Encodes an image into two ones.",
    "Creates two layers. For each pixel, a random amount of intensity will be removed and added to one of the layers ; the other layer gets the rest.",
    "Scapin", "Scapin", "2024",
    "Encode",
    "<Image>/Filters/Encode"
    "RGB"
    [
        (PF_IMAGE, "image", "Takes current image", None),
        (PF_DRAWABLE, "drawable", "Input layer", None)
    ],
    [],
    encode)

main()

已尝试的操作 #

• 修改插件文件路径
• 重新安装/更新GIMP
• 调整register函数结构

错误排查与修复 #

插件未加载的核心问题集中在register()函数，同时附带一些功能优化建议：

1. 语法与参数顺序错误（导致插件无法加载） #

• 缺失逗号：菜单路径<Image>/Filters/Encode与图像模式"RGB"之间缺少逗号，Python解析时会报错，直接导致GIMP无法加载插件。
• 参数顺序颠倒：register()函数中，图像模式参数（如"RGB*"）应位于菜单路径参数之前，你代码中把两者顺序搞反了。

2. 功能优化建议（不影响加载，但提升运行效率） #

• 循环内频繁调用pdb.gimp_drawable_update会大幅拖慢速度，建议将更新操作移到像素处理完成后统一执行。
• 使用image.layers[2]这类固定索引容易出错，直接用初始层变量initialLayer读取像素更可靠。

修复后的完整代码 #

#!/usr/bin/env python

from gimpfu import *
import random as rd

def encode(image, drawable):
    width = pdb.gimp_image_width(image)
    height = pdb.gimp_image_height(image)
    initialLayer = pdb.gimp_image_get_active_layer(image)
    
    # 生成随机图层标题
    title1 = "".join(str(rd.randint(0,10)) for _ in range(10))
    title2 = "".join(str(rd.randint(0,10)) for _ in range(10))
    
    # 使用常量替代魔法数字，提升可读性
    layer1 = pdb.gimp_layer_new(image, width, height, RGB_IMAGE, title1, 100, NORMAL_MODE)
    layer2 = pdb.gimp_layer_new(image, width, height, RGB_IMAGE, title2, 100, NORMAL_MODE)
    
    # 添加图层到图像，指定位置避免索引混乱
    image.add_layer(layer1, 0)
    image.add_layer(layer2, 1)
    
    # 批量处理所有像素
    for x in range(width):
        for y in range(height):
            # 直接从初始层读取像素
            pixel = pdb.gimp_drawable_get_pixel(initialLayer, x, y)[1]
            
            # 生成随机RGB分量，避免超出原像素范围
            newPixel1 = (
                rd.randint(0, pixel[0]),
                rd.randint(0, pixel[1]),
                rd.randint(0, pixel[2])
            )
            newPixel2 = (
                pixel[0] - newPixel1[0],
                pixel[1] - newPixel1[1],
                pixel[2] - newPixel1[2]
            )
            
            # 写入新像素到对应图层
            pdb.gimp_drawable_set_pixel(layer1, x, y, 3, newPixel1)
            pdb.gimp_drawable_set_pixel(layer2, x, y, 3, newPixel2)
    
    # 统一更新图层，提升运行效率
    pdb.gimp_drawable_update(layer1, 0, 0, width, height)
    pdb.gimp_drawable_update(layer2, 0, 0, width, height)
    
    # 刷新图像显示
    pdb.gimp_displays_flush()

register(
    "python_fu_encode",
    "将图像编码为两个图层",
    "创建两个图层，每个像素的RGB分量会被随机分配到两个图层中",
    "Scapin", "Scapin", "2024",
    "编码图像",
    "RGB*",  # 支持所有RGB类型图像
    "<Image>/Filters/Encode",  # 菜单路径
    [
        (PF_IMAGE, "image", "当前图像", None),
        (PF_DRAWABLE, "drawable", "输入图层", None)
    ],
    [],
    encode
)

main()

验证步骤 #

1. 将修复后的代码保存为encode.py，放入GIMP插件目录：
   • Linux/macOS：~/.config/GIMP/2.10/plug-ins/
   • Windows：C:\Users\<用户名>\AppData\Roaming\GIMP\2.10\plug-ins\
2. Linux/macOS下需给文件添加可执行权限：chmod +x encode.py
3. 重启GIMP，在图像>滤镜>编码图像菜单中即可找到插件

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