Define gimp how to#

Looking at the info for gimp-edit-fill in the Procedure Browser we find the following: Name: In uni-img we called the procedure gimp-edit-fill to fill the whole image.

( define ( script-fu-copy-blur img drawable blur-radius ) Create a new layer ( set! new-layer ( car ( gimp-layer-copy drawable 0 ))) Give it a name ( gimp-layer-set-name new-layer 'Gauss-blurred' ) Add the new layer to the image ( gimp-image-add-layer img new-layer 0 ) Call a plugin to blur the image ( plug-in-gauss-rle 1 img new-layer blur-radius 1 1 ) Invert the new layer ( gimp-invert new-layer ) Flush the display ( gimp-displays-flush ) ) ( script-fu-register 'script-fu-copy-blur' 'Copy and Blur' 'Copy and blur a layer' 'Dov Grobgeld' 'Dov Grobgeld' '2002' 'RGB*, GRAY*' SF-IMAGE 'Image' 0 SF-DRAWABLE 'Layer to blur' 0 SF-VALUE 'Blur strength' '5' ) ( script-fu-menu-register 'script-fu-copy-blur' '/Script-Fu/Tutorials' ) 7.

Define gimp how to#

It illustrates how to hang a script in the image menu, and how a plug-in may be called. An example script that blurs an image according to a blur radius. It is also possible to access this script through the Script-Fu console by typing the command Selecting this script results in the following popup:Īccepting these default parameters through the OK button gives us the following new image:

The script Uniform image should now appear in the pulldown menu Xtns -> Script-Fu -> Tutorials -> Uniform image. To test the script save it in $ HOME/.gimp-2.2/scripts/uni.scm and then select Xtns -> Script-Fu -> Refresh: ( script-fu-register 'uni-img' 'Uniform image' 'Creates a uniform image' 'Dov Grobgeld ' 'Dov Grobgeld' '' '' SF-VALUE 'size' '100' SF-COLOR 'color' ' ( 255 127 0 )) ( script-fu-menu-register 'uni-img' '/Xtns/Script-Fu/Tutorials' ) ( gimp-palette-set-background color ) ( gimp-edit-fill layer BG-IMAGE-FILL ) The following is also done for all script ( gimp-display-new img ) ( gimp-image-undo-enable img )) Finally register our script with script-fu. We now have an image and layer and may paint in the layer through the PDB functions. ( define ( uni-img size color ) Create an img and a layer ( set! img ( car ( gimp-image-new size size RGB ))) ( set! layer ( car ( gimp-layer-new img size size RGB 'layer 1' 100 NORMAL ))) The following is done for all scripts ( gimp-image-undo-disable img ) ( gimp-image-add-layer img layer 0 ) Here is where the painting starts. Define the function of the script and list its parameters The parameters will be matched with the parameters listed below in script-fu-register. Not very useful, but it shows the essential steps in producing a Script-Fu script. The following script uni.scm receives two parameters from the user, the size of the image and a color, and goes on to produce a uniform image of the requested size and the requested color. Some of the valid types are:Ī string of characters enclosed in double quotes.Īny scalar value, integer, or floating point.Ī label for Script-Fu to display when querying for the parameter. Each parameter is given as a group of three items: This only has a meaning on scripts operating on images that already exist.Īfter these seven parameters have been given, a list of the parameters required by the script follows. List of valid image types for the script.

A help string describing the function of the script.

The name of the script to be used as a menu entry.

The first group of seven parameters must always be given. The parameters of script-fu-register may be divided into two groups. As long as a command is registered in the PDB it can be called by any script or plugin. The last point above actually means that a script is from Gimp’s viewpoint in no way different from a built-in command or a plugin command.

Give the script a name to be used as the menu label.

Tell Script-Fu the type of parameters the script takes and give these parameters default values.

This is done through the Scheme function script-fu-register. Registering the script with Script-Fu ¶Īfter a function has been written it has to be registered with Script-Fu before it can be used. The different types will be explained below. the Procedure Browser entry for uni-img, which we will define in the example below looks like this:įor the Script-Fu programmer this information shows that uni-img may be called with three parameters of the types INT32, STRING and COLOR. Produces a new GIMP image of type RGB and size 100x150.Īll the functions of the PDB may be accessed through the Procedure Browser that is available from the main menu through Xtns ->Procedure Browser….