Jednou z mojich najčastejšie používaných operácií v GIMPe je tvorba textu pre webovú stránku, logá alebo niečo podobné. Na začiatku však nikdy presne neviete, s akým veľkým obrázkom máte začať. Neviete, koľko miesta si bude vyžadovať text s nastaveným typom a veľkosťou písma.

Majster v Script-Fu (ale aj študent) si rýchlo uvedomí, že tento problém je možné veľmi jednoducho vyriešiť a zaizovať pomocou Script-Fu.

Vytvoríme skript, ktorý pomenujeme Text Box. Skript vytvorí obrázok o veľkosti presne zodpovedajúcej textu. Text zadá používateľ. Aj výber písma, jeho veľkosť a farbu textu necháme na používateľa.

Až doteraz sme pracovali v konzole Script-Fu. Teraz však prejdeme na úpravu textových súborov skriptov.

Kde budete skripty ukladať je na vás. Ak máte prístupové práva do východzieho adresára skriptov, skripty môžete ukladať tam. Svoje skripty ukladám do osobného adresára skriptov, t. j. držím ich oddelene od skriptov dodávaných spolu s GIMPom.

V adresári .gimp-2.6, ktorý GIMP vytvoril vo vašom osobnom adresári, môžete nájsť adresár pod menom scripts. GIMP bude tento adresár (.gimp-2.6) aicky prehľadávať a skripty, ktoré v ňom nájde, pridá do databázy Script-Fu. Vaše vlastné skripty by ste preto mali umiestniť práve sem.

Každý Script-Fu definuje prinajmenšom jednu funkciu, podľa ktorej skript funguje. Toto je miesto, kde sa najviac natrápite.

Každý skript musí byť naviac zaregistrovaný do databázy procedúr aby ste doň mohli vstupovať z GIMPu.

Najprv zadefinujeme hlavnú funkciu:

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

Takto sme definovali novú funkciu, ktorú sme pomenovali script-fu-text-box. Obsahuje štyri parametre popisujúce nejaký text, písmo, veľkosť písma a jeho farbu. Funkcia je momentálne prázdna a teda nič nerobí. Zatiaľ je to v pohode. Nič nové, nič zložité.

Podľa konvencie Scheme, uprednostňujú sa malé písmená a pomlčky. Tejto konvencie som sa pridŕžal aj pri pomenovaní našej funkcie. Pri pomenovaní parametrov funkcie som sa však konvencie nedržal. Pre parametre a premenné rád používam popisné mená. Preto predpona „in“ pri parametroch mi naznačí, že parametre obsahujú hodnoty predávané skriptu, a nie, že sú skriptom vytvorené. Pre premenné definované vo vnútri skriptu používam predponu „the“.

V GIMPe je dobrým zvykom pomenovať funkcie skriptov podľa vzorca script-fu-menofunkcie. Je to výhodné, lebo v databáze procedúr všetky funkcie nájdete zoradené pod menom script-fu. Toto usporiadanie tiež pomáha odlíšiť funkcie od zásuvných modulov.

Teraz poďme funkciu v GIMPe registrovať. Robí sa to volaním funkcie script-fu-register. GIMP pri čítaní skriptu funkciu vykoná, čím sa skript zaregistruje do databázy procedúr. Túto funkciu môžete v skripte umiestniť ľubovoľne. Ja ju však dávam na koniec kódu.

Nasleduje výpis registrácie tejto funkcie (Všetky parametre tejto funkcie vysvetlím za chvíľku):

  (script-fu-register
    "script-fu-text-box"                        ;meno funkcie
    "Text Box"                                  ;meno popisu
    "Creates a simple text box, sized to fit\
      around the user's choice of text,\
      font, font size, and color."              ;popis
    "Michael Terry"                             ;autor
    "copyright 1997, Michael Terry;\
      2009, the GIMP Documentation Team"        ;copyright
    "October 27, 1997"                          ;dátum vzniku
    ""                     ;typ obrázku s ktorým skript pracuje
    SF-STRING      "Text:"         "Text Box"   ;premenná reťazca
    SF-FONT        "Font:"         "Charter"    ;premenná písma
    SF-ADJUSTMENT  "Font size"     '(50 1 1000 1 10 0 1)
                                                ; tlačidlo
    SF-COLOR       "Color:"        '(0 0 0)     ;premenná farby
  )
  (script-fu-menu-register "script-fu-text-box" "<Image>/File/Create/Text")
      

Ak tieto funkcie uložíte do osobného adresára skriptov ako textový súbor s príponou .scm, potom vyberiete položky Filters (Filtre) → Script-Fu → Refresh Scripts, tento nový skript sa objaví pod položkami File (Súbor) → Create → Text → Text Box.

Ak tento skript spustíte, samozrejme, že nevykoná vôbec nič, ale aspoň uvidíte výzvy vytvorené pri registrácii skriptu (viac informácií o tom, čo sme urobili, vysvetlíme v ďalšom texte).

Nakoniec, ak otvoríte Prehliadač procedúr (Procedure Browser) ( Help → Procedure Browser), zistíte, že náš skript sa objaví v databáze.

Aby bol náš skript v GIMPe zaregistrovaný, vyvoláme funkciu script-fu-register, zadáme sedem povinných parametrov, pridáme parametre nášho skriptu spolu s popisom a štandardnými hodnotami pre každý parameter.

Obrázok 13.4. Ponuka nášho skriptu

Po zadaní povinných parametrov musíte zadať aj parametre, ktoré vyžaduje náš skript. Pri zapisovaní týchto parametrov musíme uviesť aj o aké typy sa jedná. Toto je dôležité pre dialógové okno ktoré sa otvorí, keď používateľ vyberie náš skript. Musíme zadať aj východziu hodnotu.

Táto časť registračného procesu má nasledovný formát: