# Els paràmetres de l'API de Script-Fu

Aquesta secció no és part del programa d'aprenentatge original.

Al costat dels tipus de paràmetres anteriors n'hi ha d'altres en mode interactiu, cadascun d'ells crea un giny en el control del diàleg. Trobareu una llista d'aquests paràmetres amb descripcions i exemples en l'script de prova `plug-ins/script-fu/scripts/test-sphere.scm` subministrat amb el codi font del GIMP.

Tipus de paràmetre | Descripció
--- | ---
`SF-ADJUSTMENT` | Crea un giny d'ajustament en el diàleg. SF-ADJUSTMENT "label" '(value lower upper step_inc page_inc digits type) Llista d'arguments del giny Element Descripció "label" Text imprès abans del giny. valor Valor imprès al principi. lower / upper Els valors mini / maxi (rang d'elecció). step_inc Incrementa/redueix el valor. page_inc Incrementa/redueix el valor utilitzant les tecles Pàgina. dígits Dígits després del punt (part decimal). tipus Un de: SF-SLIDER o 0, SF-SPINNER o 1
`SF-COLOR` | Crea un botó de color en el diàleg. SF-COLOR "label" '(red green blue) o SF-COLOR "label" "color" Llista d'arguments del giny Element Descripció "label" Text imprès abans del giny. (vermell verd blau) Llista dels tres valors per als components vermell, verd i blau. "color" Nom del color en notació CSS.
`SF-FONT` | Crea un giny per a la selecció de la lletra tipogràfica en el diàleg. Retorna un nom de la lletra com una cadena. Hi ha dos procediments nous del gimp-text per a facilitar l'ús d'aquest paràmetre de tornada: (gimp-text-fontname image drawable x-pos y-pos text border antialias size unit font) (gimp-text-get-extents-fontname text size unit font) on el paràmetre «font» és el nom de la lletra tipogràfica que s'obté. La mida especificada en el «fontname» s'ignora. S'utilitza només al gestor de la lletra. Us preguntarà que doneu un valor útil (24 píxels és una opció correcta). SF-FONT "label" "fontname" Llista d'arguments del giny Element Descripció "label" Text imprès abans del giny. "nom de la tipografia" Nom de la lletra tipogràfica per defecte.
`SF-BRUSH` | Crearà un giny en el diàleg de control. El giny consisteix en una zona de previsualització (que quan es prem produeix una previsualització emergent) i un botó amb l'etiqueta «...». El botó obre un diàleg on es poden seleccionar els pinzells i modificar-ne cadascuna de les característiques. SF-BRUSH "Brush" '("Cercle (03)" 100 44 0) En aquest cas, el diàleg del pinzell s'obrirà amb el pinzell per defecte Cercle (03) opacitat 100, espaiat 44 i en mode normal (valor 0). Si aquesta selecció no canvia el valor passat a la funció com a paràmetre, serà '("Cercle (03)" 100 44 0).
`SF-PATTERN` | Crearà un giny en el diàleg de control. El giny consisteix en una zona de previsualització (que quan es prem produeix una previsualització emergent) i un botó amb l'etiqueta «...». El botó obre un diàleg on es poden seleccionar els patrons. SF-PATTERN "Pattern" "Maple Leaves" El valor retornat quan es crida l'script és una cadena que conté el nom del patró. Si la selecció anterior no s'ha modificat, la cadena contindrà «Fulles d'auró».
`SF-GRADIENT` | Crearà un giny en el diàleg de control. El giny consisteix en un botó que conté una previsualització del degradat seleccionat. Si es prem el botó, apareixerà un diàleg de selecció del degradat. SF-GRADIENT "Gradient" "Deep Sea" El valor retornat quan es crida l'script és una cadena que conté el nom del degradat. Si la selecció anterior no s'ha modificat, la cadena contindrà «Mar profund».
`SF-PALETTE` | Crearà un giny en el diàleg de control. El giny consisteix en un botó que conté el nom de la paleta seleccionada. Si premeu el botó, apareixerà un diàleg de selecció de la paleta. SF-PALETTE "Palette" "Named Colors" El valor retornat quan es crida l'script és una cadena que conté el nom del patró. Si la selecció anterior no s'ha modificat, la cadena contindrà «Colors amb nom».
`SF-FILENAME` | Crearà un giny en el diàleg de control. El giny consisteix en un botó que conté el nom d'un fitxer. Si premeu el botó, apareixerà un diàleg de selecció del fitxer. SF-FILENAME "label" (string-append "" gimp-data-directory "/scripts/beavis.jpg") El valor retornat quan es crida l'script és una cadena que conté el nom del fitxer.
`SF-DIRNAME` | Només és útil en mode interactiu. Molt semblant a SF-FILENAME, però el giny creat permet triar un directori en lloc d'un fitxer. SF-DIRNAME "etiqueta" "/var/tmp/images" El valor retornat quan es crida l'script és una cadena que conté el nom del directori.
`SF-OPTION` | Crearà un giny en el diàleg del control. El giny és un quadre combinat (combo-box) que mostra les possibles opcions. La primera opció és l'opció per defecte. SF-OPTION "label" '("option1" "option2") El valor retornat quan es crida l'script és el nombre de l'opció triada, 0 correspon a la primera opció.
`SF-ENUM` | Crearà un giny en el diàleg de control. El giny és un quadre combinat que mostra tots els valors possibles per un tipus d'enumeració donat. Ha de ser el nom d'enumeració registrada, sense el prefix del «GIMP». El segon paràmetre especifica el valor per defecte. SF-ENUM "Interpolació" '("InterpolationType" "lineal") El valor retornat quan es crida l'script correspon al valor enumerat triat.