• Télécharger
• Nouveautés

• Mes premiers pas
• Gimp expliqué
• Tutoriels techniques
• Écrire un script-fu
• Gluas
• F.A.Q

• Tutoriels créations
• Ti bout d'tuto
• Traductions
• Sur le web

• Installations
• Script-fu maison
• Greffons & scripts
• Images libres
• Textures libres
• Brosses
• Polices

• Liens en vrac
• Livre d'or
• Accessibilité
• News Letter

 

Scheme : Le script-fu-register

 

Nous allons voir le script-fu-register, la procédure servant a identifier notre script dans Gimp, permettant à celle-ci d'être appelé de façon interactive ou par d'autres scripts (en mode interactif ou non).

L'étude de 6 points particuliers nous permettrons de faire un tout assez complet (mais probablement pas exhaustif) de ce sujet.

• script-fu-register est une procédure.
• identifier la fonction.
• sa position dans le menu.
• commentaires, auteur, copyright, date.
• types d'images supportés par la fonction.
• les paramètres.

Le Scheme exige une syntaxe avec des ouverture et fermeture de parenthèses emboîtées. Cette procédure n'échappe pas à la règle.

Dans un second temps, il convient de spécifier le nom de votre fonction tel que vous l'avez déclarée ; la syntaxe exige que cela soit fait entre guillemets.

Vient ensuite une ligne permettant de définir le chemin d'accès dans le menu de Gimp ; la syntaxe exige que cela soit fait entre guillemets.

En premier, vous devez indiquer depuis qu'elle fenêtre de Gimp le script pourra être appelé. Il y a 4 possibilités :

<Image> 

C'est la fenêtre image de Gimp, le plan de travail. Cela convient bien aux scripts travaillant sur des images déjà existante.

<Toolbox>

C'est la fenêtre d'outils de Gimp. Cela convient bien aux scripts qui n'utiliseront aucunes images existantes et en créeront une nouvelle.

<Load> et <Save> 

Vous avez la possibilité d'écrire des scripts de lecture ou de sauvegarde d'image(s). Par exemple pour des traitements par lots.

Ensuite vous spécifiez les différents niveaux de menu. Vous êtes totalement libre, c'est à dire que vous pouvez indiquer un ou des menus déjà existant, ou créer un ou des menus personnels inexistant. (A noter que les menus existant doivent être indiqués en anglais : le menu Calque est en fait Layer). La syntaxe exige que chaque niveaux soit précédé d'un slash (/).

Les 4 lignes suivante sont des commentaires qui apparaîtront à la fois dans la base de procédure (<toolbox> Exts > Script-fu > Explorer la base de procédure), et dans la fenêtre à propos du dialogue du script (si il y en a un !) ; la syntaxe exige que cela soit fait entre guillemets.

• Une ligne de commentaires vous permettant d'écrire un texte assez volumineux.
• Le nom de l'auteur du script.
• Le copyright
• La date.

Ce paramètres permet de filtrer l'utilisation du script suivant le mode de l'image. Ainsi avec des images utilisant un mode non supporté, le script ne pourra être lancé.

Les 3 modes de base sont : RVB, niveaux de gris et Couleurs indexées :

	RVB	Niveaux de Gris	Couleurs Indexées
Sans le canal Alpha	"RGB"	"GRAY"	"INDEXED"
Avec le canal Alpha	"RGBA"	"GRAYA"	"INDEXEDA"
Sans ou avec le canal Alpha	"RGB*"	"GRAY*"	"INDEXED*"
Tous les modes	"RGB* GRAY* INDEXED*" ou ""

Il est tout à fait possible de combiner ces paramètres. Divers exemples :

"RGB GRAYA"

"RGB* GRAY*"

"RGBA INDEXEDA"

"RGB* GRAY INDEXEDA"

6.1 les variables des paramètres

Chaque paramètres déclarés dans le script-fu-register doit être lié a une variable dans la déclaration de la fonction correspondante. La première variable assignée au premier paramètre, la seconde au second paramètre, la troisième au troisième paramètre, ainsi de suite...

Voici un exemple (notez que le code de la fonction n'y apparaît pas) :

Le nom de ces variables est a votre discrétion, mais attribuez un nom unique pour chaque.

6.2 Les paramètres

6.2.1 Les paramètres obligatoires

Si votre script travaille avec une image existante vous devrez impérativement utiliser 2 paramètres obligatoires, à écrire en premier paramètre.

Ce paramètre permet d'identifier l'image active dans Gimp. Ainsi cette image sera celle que l'utilisateur voudra utiliser.

Ce paramètre permet d'identifier le calque actif dans Gimp. Ainsi ce calque sera celui que l'utilisateur voudra utiliser. Ce paramètre est obligatoires, même si vous ne l'utilisez pas concrètement dans votre script.

 

6.2.2 Les paramètres optionnels

De nombreux types de paramètres peuvent être utilisés, offrant un vaste panel d'objets (tirette, bouton, listbox...). A chaque fois vous spécifiez une chaîne décrivant le paramètres et vous lui octroyez une valeur par défaut.

 

6.2.2.1 la boîte de valeur numérique simple

La valeur est numérique ou alphanumérique. syntaxe :

SF-VALUE "Nom du parametre" "100"

Si vous désirez spécifier des guillemets dans les chaînes, il vous faudra les faire précéder d'un anti-slash (\) comme en JavaScript.

Par exemple : SF-VALUE "Description" "\"valeur\""

 

6.2.2.2 la boîte de valeur numérique complexe

La valeur est numérique. syntaxe :

• la valeur par défaut est celle qui s'affichera au lancement du dialogue du script et qui s'affichera en cliquant sur Réinitialiser.
• le mini est le seuil minimal autorisé pour les valeurs. Un clic droit sur le bouton bas l'affiche.
• le maxi est le seuil maximal autorisé pour les valeurs. Un clic droit sur le bouton haut l'affiche.
• l'incrément est celui obtenu en cliquant sur un des 2 boutons
• l'incrément rapide est uniquement disponible en mode tirette, il est obtenu en cliquant sur la barre avant ou après la tirette.
• le nombre de décimal permet de définir le nombre de chiffre disponible après la virgule. 0 indique que la valeur est un entier.
• le mode, 0 permet d'afficher une tirette, alors que 1 affichera uniquement les boutons.

SF-ADJUSTMENT "Nom du parametre" '(10 1 30 1 10 0 1)

SF-ADJUSTMENT "Nom du parametre" '(10 1 30 0.1 10 1 0)

 

6.2.2.3 la textbox

La valeur est alphanumérique. syntaxe :

SF-STRING "Nom du parametre" "The Gimp"

Si vous désirez spécifier des guillemets dans les chaînes, il vous faudra les faire précéder d'un anti-slash (\) comme en JavaScript.

Par exemple : SF-STRING "Description" "\"The Gimp\""

 

6.2.2.4 la checkbox

Une valeur de type binaire. syntaxe :

• Flag peut prendre les valeurs TRUE (vrai) ou FALSE (faux).

SF-TOGGLE "Nom du parametre" TRUE

 

6.2.2.5 la listbox

Une valeur a choisir parmi d'autres. syntaxe :

SF-OPTION "Nom du parametre" '("texte 1" "texte 2" "etc...")

 

6.2.2.6 la colorbox

Définie une couleur. syntaxe :

• liste est le trio de couleur primaire '(rouge vert bleu)

SF-COLOR "Nom du parametre" '(63 252 0)

 

6.2.2.7 la boite de fonte

Définie une fonte. syntaxe :

SF-FONT "Nom du parametre" "Arial"

 

6.2.2.8 la boite de brosse

Définie une brosse. syntaxe :

SF-BRUSH "Nom du parametre" '("Circle (03)" 1.0 44 0)

 

6.2.2.9 la boite de pattern

Définie un motif. syntaxe :

SF-PATTERN "Nom du parametre" "Parque #1"

 

6.2.2.10 la boite de gradient

Définie un dégradé. syntaxe :

SF-GRADIENT "Nom du parametre" "German flag smooth"

 

6.2.2.11 la boite de fichiers

Définie un fichier. syntaxe :

Sous une forme absolue ou relative, exemple :

SF-FILENAME "Nom du parametre" (string-append "" gimp-data-dir "/scripts/images/texture.jpg")

gimp-data-dir permet de spécifier le chemin des données de Gimp, suivi d'un chemin relatif. string-append permet une concaténation de chaîne, vide ici, mais indispensable pour ne pas générer  une erreur.

A noter les dossiers séparés par un slash (forme linux) et non pas un anti-slash.

 

6.2.2.12 la boite de chemin de fichier

Définie un chemin de fichier. syntaxe :

SF-DIRNAME "Nom du parametre" "c:/blender"

A noter les dossiers séparés par un slash (forme linux) et non pas un anti-slash.

 

6.2.2.13 la boite d'images

Indépendamment de l'image active obtenu par la même option, vous pouvez l'utiliser afin d'obtenir une liste de toutes les sessions image ouverte.

SF-IMAGE "Nom du parametre" 0

 

6.2.2.14 la boite de calques

Indépendamment du calque actif obtenu par la même option, vous pouvez l'utiliser afin d'obtenir une liste de tous les calques d'une image.

 

6.2.2.15 la boite de calques

Une liste de tous les canaux d'une image.

 

6.2.2.16 la boite de drawable

Une liste des calques et des canaux d'une image.

Caractères indésirables

Certains caractères provoque une erreur "invalid UTF-8 strings" s'ils sont utilisés dans les chaînes, tel le é, è, ç, ù, à, ^ (tous les caractères avec l'accent circonflexe), ¨ (tous les caractères avec le tréma), §, £, ¤.

 

Méfiez-vous des guillemets, et choisissez les options adaptées à vos besoin

Ainsi pour definir un mode de calque au moyen d'un

en utilisant une variable mode par exemple. Nous écrirons :

En revanche, pour définir le nom du calque par le même moyen nous aurions une erreur. Ainsi la forme accompagné d'une variable name :

puis,

serait impropre.

Vous noterez que le nom doit être dans la procédure gimp-layer-new spécifiée entre guillemets. Aussi vous faudra-t-il utiliser la forme :

qui serait juste.

Petit inconvénient qui pourrait-être évité en utilisant une autre option :

 

utilisation de l'underscore

Vous pouvez utiliser un _ (underscore) dans 2 conditions différentes qu'il faut bien distinguer :

• Dans un but de traduction :

Par exemple essayez la forme suivante,

Bien que le texte "Seed" soit en anglais, le _ indique à Gimp de chercher à traduire ce texte. Il consulte son catalogue de mot, et s'il le trouve, il traduit en fonction de la langue utilisez sur votre ordinateur. En français cela donnera "Graine". Attention, ne vous attendez pas à un traducteur bi-lingue, vous seriez déçu !

• Afin de créez un raccourci clavier :

Par exemple essayez cette autre forme,

Cette fois, il ne s'agit pas de traduction. Le texte affiché dans le menu est non pas Exemple mais Exemple. Le soulignement du E indique qu'en tapant la touche clavier <b>e</b>, vous feriez apparaitre le dialogue du script, de même que si vous aviez cliqué sur lui avec votre souris.

Vous pouvez mettre ce _ où vous le désirez :

Enfin, minuscule ou majuscule, c'est du pareil au même.

Notons que le focus joue des tours. Il ne suffit pas de faire apparaitre le menu pour que le raccourci fonctionne. il faut aussi que le curseur de la souris soit à l'intérieur du menu, sinon vous pouvez tapez sur les touches jusqu'a la saint glinglin, le dialogue ne s'affichera pas !