### 3.4. Il primo script Script-Fu

Do you not need to stop and catch your breath? No? Well then, let's proceed with your fourth lesson — your first Script-Fu Script.

#### 3.4.1. Creare uno script Text Box

Una delle operazioni più comuni che si intraprendono in GIMP è la creazione di un rettangolo con del testo per una pagina web, un logo o altro. Tuttavia quando si comincia non si sa quanto far grande l'immagine iniziale. Non si sa quanto spazio occuperà il testo con il font e la dimensione del font che si desidera.

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

Si creerà quindi uno script, intitolato Text Box, che crea un'immagine delle dimensioni corrette per contenere una linea di testo immessa dall'utente. Si consentirà inoltre all'utente di scegliere il font, la dimensione del font e il colore del testo.

#### 3.4.2. Modificare e memorizzare gli script

Finora abbiamo lavorato nella console Script-Fu. Ora, tuttavia, passeremo alla modifica dei file di script. I file di script dovrebbero essere file di testo semplice, modificabili in un editor di testo o di codice. Il nome che si dà non è così importante, se non per poter riconoscere lo script. Si consiglia di assegnare al file di script l'estensione «.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.

#### 3.4.3. Lo stretto necessario

Ogni script Script-Fu definisce almeno una funzione che è la funzione principale dello script. Questa è la funzione dove si fa il lavoro.

Ogni script deve registrarsi nel database delle procedure per poter risultare accessibile a GIMP.

Si definisca dapprima la funzione principale:

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

Here, we've defined a new function called `script-fu-text-box` that takes four parameters, which will later correspond to some text, a font, the font size, and the text's color. The function is currently empty and thus does nothing. So far, so good — nothing new, nothing fancy.

#### 3.4.4. Convenzioni per i nomi

Le convenzioni sui nomi di Scheme sembrano dare la preferenza a lettere minuscole con trattini, convenzione seguita nel dare il nome alla funzione. Tuttavia ci si è allontanati dalla convenzione con gli argomenti. Si sono preferiti nomi più descrittivi per argomenti e variabili e quindi si è aggiunto il prefisso "in" agli argomenti in modo da distinguerli rapidamente come argomenti passati allo script piuttosto che creati al suo interno. Si è usato il prefisso "the" per variabili definite all'interno dello script.

Fa parte di una convenzione di GIMP di denominare le funzioni degli script `script-fu-abc`, poiché quando vengono elencate nel database delle procedure sono tutte raggruppate sotto il prefisso script-fu. Ciò aiuta anche a distinguerle dai plug-in.

#### 3.4.5. Registrare la funzione

Reistrare ora la funzione in GIMP. Ciò si ottiene richiamando la funzione `script-fu-register`. Quando GIMP legge uno script, esegue questa funzione che registra lo script nel database delle procedure. Si può posizionare questa funzione in ogni parte dello script, ma di solito la si posiziona alla fine, dopo tutto il codice.

Ecco il listato per registrare questa funzione (si chiariranno a breve gli argomenti):

      (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>/Filters/Tutorial")

Salvare queste funzioni in un file di testo con suffisso `.scm` in una sottocartella della propria cartella degli script, con lo stesso nome del file script, poi riavviare GIMP. Il nuovo script apparirà come Filtri → Tutorial → Casella di testo.

Se si invoca questo nuovo script naturalmente non succede nulla, ma si possono osservare le richieste di parametri definite quando si registra lo script (ulteriori informazioni più avanti).

Infine, se si richiama il Navigatore di procedure (Aiuto → Navigatore di procedure), si noterà che lo script ora appare nel database.

#### 3.4.6. Passi per la registrazione dello script

Per registrare lo script in GIMP si richiama la funzione `script-fu-register`, passando i sette parametri richiesti e aggiungendo gli argomenti dello script insieme con una descrizione e un valore predefinito per ciascun argomento.

Gli argomenti richiesti

- Il nome della funzione definita. Questa è la funzione che viene chiamata quando si invoca lo script (il punto di entrata). È obbligatoria perché si possono definire altre funzioni all'interno dello stesso file e GIMP deve sapere quale tra queste funzioni richiamare. Nell'esempio si è definita solo una funzione, text-box, che è stata registrata.

- L'etichetta di menu è il nome che verrà visualizzato nel menu. Per specificare la posizione, vedere Sezione 3.4.9, «Registrare la posizione di menu».

- Una descrizione dello script che viene visualizzata nel Navigatore delle procedure.

- Un nome autore (l'autore dello script).

- Informazioni sul Copyright.

- La data di creazione dello script o quella della sua ultima revisione.

- The types of images the script works on. This may be any of the following: RGB, RGBA, GRAY, GRAYA, INDEXED, INDEXEDA. Or it may be none at all — in our case, we're creating an image, and thus don't need to define the type of image on which we work.

#### 3.4.7. Registrare i parametri dello script

Dopo aver elencato gli argomenti necessari occorre elencare gli argomenti che corrispondono a quelli necessari al nostro script. Quando si elencano questi argomenti si danno indicazioni sui loro tipi, questo serve per la finestra di dialogo che compare quando l'utente seleziona lo script. Si deve anche fornire un valore predefinito.

Questa sezione del processo di registrazione ha il seguente formato:

Tipo argomento | Descrizione | Esempio
--- | --- | ---
`SF-IMAGE` | Se lo script opera su un'immagine già aperta, questo dovrebbe essere il primo argomento dopo quelli richiesti. GIMP passa un riferimento all'immagine in questo parametro. | 3
`SF-DRAWABLE` | Se lo script opera su un'immagine aperta questo dovrebbe essere il secondo argomento dopo `SF-IMAGE`. Si riferisce al livello attivo. GIMP passa un riferimento al livello attivo in questo parametro. | 17
`SF-STRING` | Accetta stringhe. | "Del testo"
`SF-COLOR` | Indica che questo argomento richiede un colore. | '(0 102 255)
`SF-TOGGLE` | Viene mostrata una casella di scelta per richiedere un valore booleano. | TRUE o FALSE (vero o falso)

#### 3.4.8. Le API dei parametri Script-Fu [5]

| Nota
Beside the above parameter types there are more types for the interactive mode, each of them will create a widget in the control dialog. You will find a list of these parameters with descriptions and examples in the test script `plug-ins/script-fu/scripts/test-sphere-v3.scm` shipped with the GIMP source code.

Tipo argomento | Descrizione
--- | ---

`SF-ADJUSTMENT`

Crea un widget di regolazione nella finestra di dialogo.

SF-ADJUSTMENT "etichetta" '(valore inferiore superiore passo_inc pagina_inc cifre tipo)

Elenco argomenti del widget

Elemento | Descrizione
--- | ---
"etichetta" | Testo stampato prima del widget.
valore | Valore stampato alla partenza.
inferiore / superiore | I valori inferiore / superiore (campo libero).
passo_inc | Incrementa/decrementa il valore.
pagina_inc | Incrementa/decrementa il valore usando i tasti pagina.
cifre | Cifre dopo la il punto (la parte decimale).
tipo | Uno di: SF-SLIDER o 0, SF-SPINNER o 1

`SF-COLOR`

Crea un pulsante di colore nella finestra di dialogo.

SF-COLOR "etichetta" '(rosso verde blu)

o

SF-COLOR "etichetta" "colore"

Elenco argomenti del widget

Elemento | Descrizione
--- | ---
"etichetta" | Testo stampato prima del widget.
'(rosso verde blu) | Elenco i tre valori per le componenti rosso, verde e blu.
"colore" | Nome colore in notazione CSS.

`SF-FONT`

Crea un widget di selezione caratteri nel pannello. Restituisce un nome di carattere come stringa. Ci sono due nuove procedure per la gestione del testo di GIMP per facilitare l'uso di questo parametro restituito:

(gimp-text-fontname image drawable x-pos y-pos text border antialias size unit font)

(gimp-text-get-extents-fontname text size unit font)

dove font è il nome del carattere ottenuto. La dimensione specificata nel nome del carattere viene silenziosamente ignorata. Viene usata solo nel selettore del font. Per questa ragione viene richiesto di impostarla ad un valore sensato (24 pixel è una buona scelta).

SF-FONT "etichetta" "nomecarattere"

Elenco argomenti del widget

Elemento | Descrizione
--- | ---
"etichetta" | Testo stampato prima del widget.
"nomecarattere" | Nome del carattere predefinito.

`SF-BRUSH`

Crea un widget nel pannello di controllo. Il widget consiste in un'area di anteprima (che se premuta porta in primo piano una finestra di anteprima) ed un pulsante con etichetta "...". Il pulsante provocherà a sua volta la creazione di una finestra di dialogo in primo piano dove si potrà selezionare i pennelli e qualsiasi caratteristica di questi potrà essere modificata.

SF-BRUSH "Brush" '("Circle (03)" 100 44 0)

Qui il pannello pennelli verrà portato in primo piano con un pennello predefinito circolare (03) con opacità 100, spaziatura 44 e modalità di disegno Normale (valore 0).

Se questa selezione non è stata modificata, il valore passato alla funzione come parametro sarà '("Circle (03)" 100 44 0).

`SF-PATTERN`

Crea un widget nel pannello di controllo. Il widget consiste di un'area di anteprima (che se premuta porta in primo piano una finestra di anteprima) ed un pulsante con etichetta "...". Il pulsante porta a sua volta in primo piano una finestra di dialogo con la quale è possibile selezionare i motivi.

SF-PATTERN "Motivo" "Maple Leaves"

Il valore restituito all'invocazione dello script è una stringa contenente il nome del motivo. Se la selezione precedente non è stata modificata la stringa contiene "Maple Leaves".

`SF-GRADIENT`

Crea un widget nel pannello di controllo. Il widget consiste in un pulsante contenente un'anteprima del gradiente selezionato.

Se il pulsante viene premuto viene portata in primo piano una finestra di dialogo di scelta del gradiente.

SF-GRADIENT "Gradiente" "Deep Sea"

Il valore restituito quando lo script viene invocato è una stringa contenente il nome del gradiente. Se la selezione precedente non è stata modificata, la stringa contiene "Deep Sea".

`SF-PALETTE`

Crea un widget nella finestra di controllo. Il widget consiste in un pulsante contenente il nome della tavolozza selezionata.

Se il pulsante viene premuto viene portata in primo piano una finestra di dialogo di scelta della tavolozza.

SF-PALETTE "Tavolozza" "Colori con nome"

Il valore restituito quando lo script viene invocato è una stringa contenente il nome della tavolozza. Se la selezione precedente non è stata alterata, la stringa dovrebbe contenere "Colori con nome".

`SF-FILENAME`

Esso conterrà un widget nel pannello di controllo. Il widget consiste in un pulsante contenente il nome di un file.

Se viene premuto il pulsante, viene portata in primo piano una finestra di selezione file.

SF-FILENAME "etichetta" (string-append "" gimp-data-directory "/scripts/beavis.jpg")

Il valore restituito quando lo script viene invocato è una stringa contenente il nome del file.

`SF-DIRNAME` | Utile sono in modalità interattiva. Molto simile a SF-FILENAME, il widget creato permette di scegliere una directory invece di un file. SF-DIRNAME "etichetta" "/var/tmp/images" Il valore restituito quando lo script viene invocato è una stringa contenente il nome della directory.
`SF-OPTION` | Crea un widget nella finestra di controllo. Il widget è un combo-box (NdT: una combinazione di casella di testo e lista a discesa) che mostra le opzioni passate come lista. La prima opzione è la predefinita. SF-OPTION "etichetta" '("opzione1" "opzione2") Il valore restituito quando lo script viene invocato è il numero delle opzioni scelte, dove la prima opzione viene contata come 0.

`SF-ENUM`

Crea un widget nel pannello di controllo. Il widget è un combo-box che mostra tutti i valori enum per il dato tipo enum. Quest'ultimo deve essere il nome di un enum registrato, senza il prefisso "Gimp". Il secondo parametro specifica il valore predefinito, usando il nick del valore enum.

SF-ENUM "Interpolazione" '("TipoInterpolazione" "lineare")

Il valore restituito, quando lo script viene invocato, corrisponde al valore scelto.

#### 3.4.9. Registrare la posizione di menu

Una volta registrato il nostro script, bisogna dire a GIMP dove trovarlo nel menu.

La posizione migliore per il proprio script nel menu dipende dalla sua funzione. La maggior parte degli script si trova nei menu Filtri e Colori.

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

Qualsiasi sottomenu specificato nello script che non esiste ancora, verrà creato automaticamente da GIMP.

[5] Questa sezione non è una parte originale di questa guida.

3.3. Liste, liste e ancora liste |  | 3.5. Aggiunta di ulteriori funzionalità

Report a bug in GIMP Segnalate l'errore sulla piattaforma apposita