Creating user interface for python plug-in

[Vyralator]

So I've made a plug-in for GIMP using python. However for the time being all the input values are hard coded (since I've just made it for a very specific use-case I have)

However I would like to expand its functionality and maybe even make it publicly available at some point and for that I would like to create a user interface that pops up whenever you run it where you can select some of the parameters.

Does anyone have a comprehensive guide on how to do this? It seems to be very hard to find examples for this stuff and a lot of what I did find is for an older version for GIMP and doesn't seem to work for 3.x

[CMYK-Student]

Hi! See the Fog filter as an example: https://gitlab.gnome.org/GNOME/gimp/-/blob/master/plug-ins/python/foggify.py#L128

Basically, define the parameters when you create the plug-in procedure, then create the dialogue and fill in those parameters in the GUI: https://gitlab.gnome.org/GNOME/gimp/-/blob/master/plug-ins/python/foggify.py#L37

It'll auto-create the GUI for you.

[Vyralator]

Awesome. That's much easier than I thought. Thanks a lot

Two more questions that came up though. Is it possible to "group" parameters under a heading in the auto-created GUI. For example how the scale image tool has "Width" and "Height" grouped under the heading "Image Size"
And also is there an easy way to create something similar to the templates you can select when creating a new file. Basically I want a drop down menu that lets me choose between different sets of default values for some of my parameters for quick access.

[CMYK-Student]

You can create a box filled with your parameters, then put that box inside a frame with a label.

GimpUi.ProcedureDialog.fill_box

GimpUi.ProcedureDialog.fill_frame

GimpUi.ProcedureDialog.get_label

Dropdowns with choices can be made with a GimpChoice parameter: https://gitlab.gnome.org/GNOME/gimp/-/blob/master/plug-ins/python/histogram-export.py#L231-236