Hi,

if you have plug-ins that used to work with GIMP-1.3, you will most probably notice that they don't work with 1.3.23 any longer. If you try to recompile them, you will notice that there are some incompatible changes in libgimpwidgets. The changes were absolutely needed and are quite small. Let me point you at the culprits nevertheless...

(1) GimpDialog API changes http://developer.gimp.org/api/1.3/libgimpwidgets/GimpDialog.html

GimpDialog is actually a GtkDialog. It has always been but the new API is much closer to the GtkDialog API. Here's a simple code snippet using the new API:

dialog = gimp_dialog_new (_("Foo Filter"), "foo", NULL, 0, gimp_standard_help_func, "gimp-plug-in-foo",
GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL, GTK_STOCK_OK, GTK_RESPONSE_OK,
NULL);

As you can see the new way of creating a GimpDialog is a lot simpler. For each button you simply pass a label text (or a stock-id) and an integer that will serve as an identifier for the button. You can then connect to the "response" signal which is emitted if a button is pressed or the user attempts to close the dialog by other means. The registered response ID is passed to the signal handler.

Alternatively, you can use gimp_dialog_run(), a convenience function that behaves very much like gtk_dialog_run(). Most GIMP plug-ins simply create a dialog, run a main loop which is quit when the dialog is closed and then check if the OK button was pressed. This used to be done by connecting a signal handler to the OK button and setting some boolean variable from there. With the new dialog API, this boils down to:

static gboolean
foo_dialog (void)
{
GtkWidget *dialog;
gboolean run;

dialog = gimp_dialog_new (_("Foo Filter"), "foo", NULL, 0, gimp_standard_help_func, "gimp-plug-in-foo",
GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL, GTK_STOCK_OK, GTK_RESPONSE_OK,

NULL);

/* add widgets to the dialog here */

run = (gimp_dialog_run (GIMP_DIALOG (dialog)) == GTK_RESPONSE_OK);

gtk_widget_destroy (dialog);

return run; }

(2) GimpFileSelection was renamed to GimpFileEntry. http://developer.gimp.org/api/1.3/libgimpwidgets/GimpFileEntry.html

This is a trivial change and not many plug-in are using a file entry anyway. If your's does, just change all occurances of gimp_file_selection to gimp_file_entry.

(3) New option menu and radio group APIs http://developer.gimp.org/api/1.3/libgimpwidgets/libgimpwidgets-GimpWidgets.html

The old API for option menus and groups of radio buttons associated a data pointer with each menu item or button. In almost all cases this pointer was used to attach an integer (often an enum value). Unless you used the GINT_TO_POINTER() and GPOINTER_TO_INT() macros, this common usage case doesn't work for all platforms. That's why we introduced new functions that take integer values directly. We ask you to check your code and convert to the new functions if you are using integers with gimp_option_menu_new() or gimp_radio_group_new().

Sven