L’une des opérations les plus fréquentes que je réalise avec GIMP, est la création d’une boîte contenant un texte pour une page Web ou un logo. Mais vous ne savez jamais bien quelle taille donner à l’image au départ. Vous ne savez pas combien d’espace le texte occupera avec la taille de police que vous voulez.

This problem can be solved and automated with Script-Fu.

Nous allons donc créer un script, appelé Text Box, qui crée une image dont la taille est parfaitement adaptée au texte que saisit l’utilisateur. Nous permettrons aussi à l’utilisateur de choisir la police de caractères, sa taille, et la couleur du texte.

Up until now, we've been working in the Script-Fu Console. Now, however, we're going to switch to editing script files. Script files should be plain text files that you can edit in a text or code editor. The name you give is not that important, except for being able to recognize the script. You should give your script file the extension « .scm ».

Where you place your scripts is a matter of preference. In GIMP's folder preferences you can see in which folders GIMP looks for scripts. It is also possible to add a new folder there. The folder where GIMP stores its own scripts is usually not the best choice for your scripts, but for the rest feel free to choose what suits you best.

Tout script de Script-Fu définit au moins une fonction, qui est la fonction principale du script. C’est là que vous travaillerez.

Tout script doit également être connu de la base de données de procédures (PDB), de façon à ce que GIMP puisse y accéder.

Nous allons définir la fonction principale en premier :

        (define (script-fu-text-box inText inFont inFontSize inTextColor))
      

Nous définissons ici une fonction appelée script-fu-text-box avec quatre paramètres qui correspondront plus tard à un texte, une police, la taille de la police et la couleur du texte. La fonction est actuellement vide et ne fait rien. Jusqu’ici ça va – rien de neuf, rien de spécial.

Les conventions de dénomination de Scheme préfèrent les lettres minuscules avec traits d’union, ce que j’ai respecté dans la dénomination de la fonction. Toutefois, je me suis écarté de la convention en ce qui concerne les paramètres. Je préfère en effet les noms descriptifs pour mes paramètres et variables, c’est pourquoi j’ai ajouté le préfixe « in » aux paramètres, de façon à voir d’emblée qu’il s’agit de paramètres reçus par la fonction et non pas de paramètres émis par elle. Et j’utilise le prefixe « the » pour les variables définies au sein du script.

C’est une convention GIMP de nommer vos fonctions de script script-fu-xxx, parce qu’ainsi elle apparaîtront avec les script-fu quand elles seront listées dans la base de procédures. Cela permet aussi de les distinguer des greffons.

Maintenant, faisons connaître la fonction à GIMP. On réalise cela en appelant la fonction script-fu-register. Quand GIMP lira le script, il exécutera cette fonction qui enregistrera le script dans la base de procédures. Vous pouvez placer cette fonction où vous voulez dans votre script, mais personnellement je la mets à la fin, après tout le reste de mon code.

Voici le listing pour enregistrer cette fonction (j’expliquerai ses paramètres dans un instant) :

  (script-fu-register
    "script-fu-text-box"                        ;function name
    "Text Box"                                  ;menu label
    "Creates a simple text box, sized to fit\
      around the user's choice of text,\
      font, font size, and color."              ;description
    "Michael Terry"                             ;author
    "copyright 1997, Michael Terry;\
      2009, the GIMP Documentation Team"        ;copyright notice
    "October 27, 1997"                          ;date created
    ""                                      ;image type that the script works on
    SF-STRING      "Text"          "Text Box"   ;a string variable
    SF-FONT        "Font"          "Charter"    ;a font variable
    SF-ADJUSTMENT  "Font size"     '(50 1 1000 1 10 0 1)
                                                ;a spin-button
    SF-COLOR       "Color"         '(0 0 0)     ;color variable
  )
  (script-fu-menu-register "script-fu-text-box" "<Image>/File/Create/Text")
      

If you save these functions in a text file with a .scm suffix in your script directory, then restart GIMP. The new script will appear as File → Create → Text → Text Box.

Si vous lancez ce nouveau script, il ne fera rien bien sûr, mais vous pourrez voir les invites que vous avez créées quand vous avez enregistré le script (ça sera plus clair plus loin).

Finalement, si vous invoquez le Navigateur de Procédures ( Aide → Navigateur de Procédures), vous verrez que votre script figure maintenant dans la base de procédures.

Pour enregistrer notre script dans GIMP, nous appelons la fonction script-fu-register, remplissons les sept paramètres requis et nous ajoutons nos propres paramètres de script, ainsi qu’une description et une valeur par défaut pour chaque paramètre.

Maintenant que nous avons vu la liste des paramètres requis, nous devons préciser ceux qui correspondent aux besoins de notre script. Nous devons fournir des précisions concernant leur type, pour la fenêtre de dialogue qui apparaît quand l’utilisateur choisit notre script. Nous devons aussi fournir une valeur par défaut.

Cette section du processus d’enregistrement a le format suivant :

Once we have registered our script, we need to tell GIMP where it should be found in the menu.

The best menu location of your script depends on its function. Most scripts are found in the Filters and Colors menus.

For the current script, which creates a new image, we choose a submenu of File → Create. This is what the line with the script-fu-menu-register function does. Thus, we registered our Text Box script here: File → Create → Text → Text Box.

If you notice, the Text submenu in the File → Create menu wasn't there when we began — GIMP automatically creates any menus not already existing.

Figure 13.2. Le menu correspondant à notre script.