Jedna z nejčastějších operací, kterou v Gimpu provádím, je vytvoření textu pro webovou stránku, logo nebo něco takového. V takovém případě ale nikdy nevím, jak velký obrázek mám vytvořit, protože nevím přesně, kolik místa text v požadovaném řezu písma a velikosti zabere.

Mistr Script-Fu (ale i nadaný student) si brzy uvědomí, že lze takový problém snadno a automaticky řešit pomocí Script-Fu.

Proto vytvoříme skript, který pojmenujeme Text Box a který vytvoří obrázek o velikosti přesně odpovídající zadanému textu. Uživatel bude mít možnost zvolit i řez písma, jeho velikost a barvu.

Do této chvíle jsme pracovali se Script-Fu konzolí. Od této chvíle však budeme pracovat s textovými soubory.

Kam skripty uložíte záleží jen na vás. Pokud máte přístup do výchozího adresáře Gimpu pro skripty, můžete uložit své skripty tam. Já nicméně raději ukládám své vlastní skripty do vlastního adresáře, abych je měl oddělené od skriptů dodávaných přímo s Gimpem.

V adresáři .gimp-2.2, který Gimp vytvořil ve vašem domovském adresáři, byste měli najít podadresář jménem scripts. Gimp tento adresář automaticky prohledává a skripty, které v něm nalezne, přidává do Script-Fu databáze. Nejjednodušší bude, pokud své skripty uložíte právě sem.

Každý Script-Fu skript definuje alespoň jednu funkci, hlavní funkci skriptu. Ta je zodpovědná za činnost skriptu.

Každý skript musí být navíc zaregistrován v databázi procedur, aby k němu mohlo být přistupováno z Gimpu.

Nejprve definujeme hlavní funkci:

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

Takto jsme definovali funkci jménem script-fu-text-box se čtyřmi parametry, které se vztahují k textu, písmu, velikosti písma a jeho barvě. Funkce je zatím prázdná a proto nic nedělá. Zatím nic zajímavého ani složitého.

Konvence jazyka Scheme pro vytváření jmen upřednostňují malá písmena a pomlčky, tak jako jsme učinili při výběru jména funkce. Při pojmenovávání jejích parametrů jsme se však od konvence odchýlili. Mám rád jména popisná, která o funkci nebo parametru hodně říkají, proto jsme pro parametry použili předponu in, která naznačuje, že parametry obsahují hodnoty předávané skriptu, nikoliv skriptem vytvořené. Pro proměnné vytvořené uvnitř skriptu používám předponu the.

V Gimpu je zvykem pojmenovávat všechny Script-Fu funkce podle vzoru script-fu-jmeno-funkce, protože v databázi procedur jsou pak všechny pěkně pohromadě a jsou snadno odlišitelné od zásuvných modulů.

Nyní je třeba funkci v Gimpu zaregistrovat. To se dělá voláním funkce script-fu-register. Při načítání skriptu Gimp tuto funkci spustí, a tak je skript zaregistrován v databázi procedur. Tuto funkci můžete ve skriptu umístit kamkoliv, ale obvykle se nachází úplně na konci.

Zde je výpis naší registrační funkce (její parametry vzápětí vysvětlím):

      
        (script-fu-register
          "script-fu-text-box"                        ;func 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"             ;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" "<Toolbox>/Xtns/Script-Fu/Text")
      
      

Pokud tyto funkce zapíšete do souboru s příponou .scm, který uložíte do vašeho adresáře pro skripty, a pak zvolíte z nabídky Panelu nástrojů Rozš. → Script-Fu → Obnovit skripty, objeví se nový skript jako Rozš. → Script-Fu → Text → Text Box.

Pokud ale skript spustíte, neudělá samozřejmě nic užitečného, ale uvidíte výzvy vytvořené při registraci skriptu (podrobnosti dále).

Pokud otevřete Prohlížeč procedur, volbou Rozš. → Prohlížeč procedur), zjistíte, že náš nový skript je skutečně uveden v databázi.

Aby byl náš skript v Gimpu zaregistrován, voláme funkci script-fu-register, zadáme sedm povinných parametrů, parametry specifické pro náš skript, popis a implicitní hodnotu každého parametru.

Po uvedení obecných, povinných parametrů je třeba uvést parametry, které vyžaduje náš skript. V seznamu těchto parametrů je také třeba uvést jejich typ, což umožní správně zobrazit dialog, ve kterém uživatel parametry nastavuje. Také zadáme výchozí hodnoty těchto parametrů.

Tato část registračního procesu používá následující formát: