Script-Fu

Als erstes einige Grundlagen.
Jede Script-Fu(Scheme) Funktion werden in runde Klammern eingefasst. Der erste Ausdruck innerhalb der runden Klammern kann eine Funktion, ein Operator, Einleitung einer Schleife u.s.w sein, nachfolgend sind die dazugehörigen Argumente,Faktoren b.z.w Parameter.

(gimp-image-new 100 100 RGB)

( + 6 2) = 8

( + (- 6 2) (- 7 3)) = 8

(if ( = a b)

(...)

)

Variablen können global definiert werden. Diese global definierten Variablen sind bis zum Beenden des Scriptes gültig.

(define zahl 6) ;;zahl = 6
(define text "Hallo Welt") ;;text = "Hallo Welt"

Möchten sie den Wert der Variable "zahl" verändern nachdem die Variable mit define b.z.w let ,let* u.s.w deklariert wurde, können sie das wie folgt tun.

(set! zahl 8) ;;zahl = 8
(set! text "Hallo Berlin") ;;text = "Berlin"

Lokale Variablen werden wie folgt definiert und sind nur innerhalb der rot gekennzeichneten Klammern gültig. Innerhalb des grün gekennzeichneten Bereiches werden die Variablen definiert. Lokale Variablen können natürlich mit Hilfe von set! einen neuen Wert zugewiesen bekommen.

(let*(
(sizeX 100)
(sizeY 200)
)
(img (car (gimp-image-new sizeX sizeY RGB)))
...
)

Um mehrere Werte zu speichern und diese zu gegebener Zeit abzurufen, werden Listen genutzt.
Diese Listen werden wie folgt definiert.

(set! weinrot ''(231 37 136))

Listen in Scheme bestehen aus Listenkopf(das erste Element) und Listenende(Rest). Mittels car greift man auf den Listenkopf und mittels cdr auf das Listenende zu.

(car weinrot) =231 (cdr weinrot) = (37 136) (car (cdr(cdr weinrot))) = 136

Mit Hilfe von Listen greift man auf jeden einzelnen Wert die eine Funktion ausgibt und kopiert sie in die jeweilige Variable. Zum Beispiel die Funktion "(gimp-drawable-offsets)" gibt die x und y Koordinate eines Drawables zurück. So kann man mittels car auf den ersten Wert x und mittels cdr auf den zweiten Wert y zugreifen.

(let*
(
(coordinate_x (car (gimp-drawable-offsets)))
(coordinate_y (cdr (gimp-drawable-offsets)))
)

Diese Angaben zu den Variablen, Operationen, Listen u.s.w können auch über die Script-Fu Console(Filter->Script-Fu->Script-Fu Console) überprüft werden.
Das waren einige Grundlagen zu Script-Fu(Scheme). Wer weitere Informationen zu Script-Fu(Scheme) wünscht, sollte sich den "Links" Bereich dieser Homepage ansehen.

Im wesentlichen gibt es zwei Bereiche bei Scripten in Gimp. Das ist zum einem der Registrierbereich(grün,orange) und zum anderen der Funktionsbereich(Rest).

Die ersten drei Zeilen sind Kommentare und werden mit einen Semikolon eingeleitet. Kommentare sollten von Anfängern, sowie bei sehr komlexen Scripten genutzt werden, um die lesbarkeit des Scriptes zu gewährleisten.

Ab Gimp-2.4 müssen alle Variablen die per set! einen Wert zugewiesen bekommen, vorher bekannt gegeben werden(Vorwärtsdeklaration). Dies geschieht zwischen in der 10. und 11. Zeile. Die dort gesetzten Variablen bekommen ihren Wert in der 16. b.z.w 19. Zeile zugewiesen, und besitzen ihre Gültigkeit bis zur 25. Zeile.

In der vierten Zeile wurde die Prozedur definiert die später im DB-Browser(Xtns->DB-Browser) registriert wird. Die Syntax(Schreibweise) für diese Prozedur wird mit einen define eingeleitet (nicht zu verwechseln mit den deklarieren globaler Variablen).

(define (Prozedurname Argument Argument ...)
...
)

Der Rückgabewert einer Prozedur ist immer die letzte Anweisung.

(define (hal-world input)
(let*((append-str " Welt"))
(string-append input append-str) ;; letzte Anweisung
)
)
(hal-world "Hallo") ;; Rückgabewert "Hallo Welt"

Am Beispiel der 8. Zeile erkläre ich genauer wie man mit den Prozeduren die im DB-Browser (Xtns->DB-Browser) definiert und registriert sind, umgeht.

Hier ein Auszug zu "gimp-layer-copy" aus den DB-Browser

Nun muss noch wie in der Beschreibung von "gimp-layer-copy" steht der kopierte Layer(cp-layer) noch dem aktuellen Bild(image) hinzugefügt werden. Die geschieht in der 8. Zeile mit der Prozedur

(gimp-image-add-layer image cp-layer -1)

Wichtig ist das alle geforderten Parameter (wie in Beschreibung), belegt sind.

In der 27. Zeile wird mittels (gimp-displays-flush) angewiesen das bearbeitete Bild auf den Bildschirm anzuzeigen. Diese Prozedur gilt nur für Scripte die auf bereits geöffnenten Bildern angwandt werden. Für Scripte die ein neues Bild erzeugen, sollte die Prozedur (gimp-display-new) angewandt werden.

Es gibt die Möglichkeit Gimp Funktionen zu gruppieren, das heisst, die Prozeduren die zwischen (gimp-undo-push-group-start image) die in der 5. Zeile und (gimp-undo-push-group-end image) in der 26. Zeile stehen, mit der Tastenkombination(Strg+z) rückgänig gemacht werden. Das ist in sofern sinnvoll, wenn sich der User des Skriptes nicht gefällt, wie das Bild beabeitet wurde b.z.w das Skript mit anderen Parameter gestartet werden soll. Ohne diese Gruppierung müsste der User jede einzelne Procedur rückänig machen.

Ab der 29. bis zur 38. Zeile liegt der Registrierungsbereich. Folgende Argumente müssen angegeben werden. Wichtig ist das die Reihenfolge, die in der folgenden Tabelle angegeben ist, eingehalten wird.

In der 34. und 35. Zeile werden Parameter übergeben die wichig sind um ein geöffnetes Bild zu bearbeiten(siehe anschliessende Tabelle). Diese Parameter werden über den Prozedurenkopf (define(script-fu-after-expose-scheme image layer0)) übergeben. Das heisst das der erste Parameter der in der Registrierprozedur erzeugt wird (SF-IMAGE "IMAGE" 0) auch an den ersten Parameter der Prozedur (define(script-fu-after-expose-schemeimage layer0) übergeben wird. Dies gilt analog für den zweiten, drttten ...u.s.w. Parameter. Es können noch weitere Parameter übergeben werden(siehe anschliessende Tabelle) die vom User über vorgefertigte Eingabemasken eingeben werden können.

Mit diesen Grundlagen sollte man in der Lage sein Skripte in Script-Fu für Gimp zu erstellen.

Viel Spass!!!