Gimp插件Hello world注释
前一阵翻译gimp官网的编写插件教程，本打算继续翻译第二部分，但是感觉第一个例子还不是很懂，翻译第二部分有点理解不能，所以就读了一
下源码，记录如下
#include <libgimp/gimp.h>
/* 声明query函数，它提供gimp相关信息，使其可以根据参数配置插件 */
static void query (void);
/* 声明run函数，调用时会运行插件安装在程序数据库中的程序 */
static void run (const gchar *name,
gint nparams,
const GimpParam *param,
gint *nreturn_vals,
GimpParam **return_vals);
// GimpPlugInInfo是一个函数结构体，调用init,quit,query,run函数
// 本例中init,quit函数不使用，所以置为NULL
GimpPlugInInfo PLUG_IN_INFO =
{
NULL,
NULL,
query,
run
};
//宏
MAIN()
/* query函数，用于提供插件信息 */
static void query (void)
{
//GimpParamDef结构体，保存程序的定义
//GimpParamDef的三个参数，GimpPDBArgType类型, gchar *名称, gchar *描述
static GimpParamDef args[] =
{
{
GIMP_PDB_INT32,
"run-mode",
"Run mode"
},
{
GIMP_PDB_IMAGE,
"image",
"Input image"
},
{
GIMP_PDB_DRAWABLE,
"drawable",
"Input drawable"
}
};
/* gimp_install_procedure函数使用PDB来安装程序 */
gimp_install_procedure (
"plug-in-hello", //名称
"Hello, world!", //简介
"Displays \"Hello, world!\" in a dialog", //帮助(一般作为简介的补充)
"David Neary", //作者
"Copyright David Neary",//版权
"2004", //日期
"_Hello world...", //菜单标签名称 “_”在菜单中显示为空格
"RGB*, GRAY*", //图像类型，支持RGB，RGBA, 灰度
//如果插件不需要图像，则置为空串
GIMP_PLUGIN, //程序的类型为gimp插件，或“GIMP_EXTENSION(gimp扩展)”
G_N_ELEMENTS (args), //传入args数组中元素的个数
0, //返回值
args, //传入args数组
NULL //返回值
);
//插件安装在“滤镜/Misc”文件夹下，标签名称为上面定义的“Hello world...”
gimp_plugin_menu_register ("plug-in-hello",
"<Image>/Filters/Misc");
}
/* run函数，用于实现插件功能 */
static void
run (const gchar *name,
gint nparams,
const GimpParam *param,
gint *nreturn_vals,
GimpParam **return_vals)
{
/* 一个插件可以生成多个插件程序，所以本例题的插件程序使用values[0] */
static GimpParam values[1];
/* 定义程序数据库的状态 */
GimpPDBStatusType status = GIMP_PDB_SUCCESS;
/* 定义程序的运行模式，如交互式，非交互式，最后使用值 */
GimpRunMode run_mode;
/* 强制设置返回值 */
*nreturn_vals = 1;
*return_vals = values;
/* 设置程序的类型和状态 */
values[0].type = GIMP_PDB_STATUS;
values[0].data.d_status = status;
/* 获取运行模式，如果运行模式是非交互式，那么不会显示对话框 */
run_mode = param[0].data.d_int32;
if (run_mode != GIMP_RUN_NONINTERACTIVE)
g_message("Hello, world!\n");
}
1，最后生成的插件名称与源程序的名称相同
2，读完这个例子对插件有了一定的了解，但有些地方还很模糊，应该是正常现象
3，想深入的理解插件的实现与运行原理，那么就要多读源码
4，想读懂源码，那么就要翻看帮助文档，Devhelp是个好东西
5，通过一个hello world还不能编写插件甚至依旧看不懂别人的插件实现，欲编写实用的插件，需打好基础，循序渐进