Једна од најчешћих операција коју обављам у Гимпу је прављење оквира са неким текстом у њему за веб страницу, логотип или шта већ. Међутим, никада не знате тачно колику почетну слику треба направити када почињете. Не знате колико ће простора текст заузети са фонтом и величином фонта коју желите.

Овај проблем се може решити и аутоматизовати помоћу Скрипт-фуа.

Зато ћемо направити скрипту под називом „Текстуални оквир“ (Text Box), која прави слику исправне величине тако да се тесно уклапа око линије текста коју корисник унесе. Такође ћемо омогућити кориснику да изабере фонт, величину фонта и боју текста.

До сада смо радили у Скрипт-фу конзоли. Сада ћемо, међутим, прећи на уређивање датотека скрипти. Датотеке скрипти треба да буду обичне текстуалне датотеке које можете уређивати у уређивачу текста или кода. Име које дате није толико важно, осим што треба да препознате скрипту. Датотеци скрипте треба да дате екстензију „.scm“.

Где ћете поставити своје скрипте је ствар избора. У Гимповим поставкама фасцикли можете видети у којим фасциклама Гимп тражи скрипте. Тамо је такође могуће додати нову фасциклу. Фасцикла у којој Гимп чува своје скрипте обично није најбољи избор за ваше скрипте, али за остало слободно изаберите оно што вам највише одговара.

Свака Скрипт-фу скрипта дефинише барем једну функцију, која је главна функција скрипте. Ту обављате посао.

Свака скрипта се такође мора регистровати у бази процедура како бисте јој могли приступити унутар Гимпа.

Прво ћемо дефинисати главну функцију:

        (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.

Чини се да конвенције именовања у Scheme-у преферирају мала слова са цртицама, што сам пратио при именовању функције. Међутим, одступио сам од конвенције код параметара. Волим описнија имена за своје параметре и променљиве, те стога додајем префикс „in“ параметрима како бих брзо видео да су то вредности које се прослеђују скрипти, а не оне које су унутар ње направљене. Користим префикс „the“ за променљиве дефинисане унутар скрипте.

Конвенција Гимпа је да се функције скрипти именују као script-fu-abc, јер ће се тада, када буду излистане у бази процедура, све појавити под Скрипт-фу ставком. Ово такође помаже да се разликују од прикључака.

Сада региструјмо функцију у Гимпу. Ово се ради позивањем функције script-fu-register. Када Гимп учита скрипту, он ће извршити ову функцију која региструје скрипту у бази процедура. Овај позив функције можете поставити где год желите у својој скрипти, али га ја обично стављам на крај, након целог осталог кода.

Ево листинга за регистровање ове функције (објаснићу све њене параметре за минут):

  (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")
      

Сачувајте ове функције у текстуалну датотеку са наставком .scm у поддиректоријуму вашег директоријума са скриптама, са истим именом као и ваша датотека скрипте, а затим поново покрените Гимп. Нова скрипта ће се појавити као Филтери → Туторијал → Текстуални оквир.

Ако покренете ову нову скрипту, она наравно неће урадити ништа, али можете видети упите које сте направили приликом регистровања скрипте (више информација о томе шта смо урадили биће речи у наставку).

Коначно, ако покренете Прегледач процедура (Помоћ → Прегледач процедура), приметићете да се наша скрипта сада појављује у бази података.

Да бисмо регистровали нашу скрипту у Гимпу, позивамо функцију script-fu-register, попуњавамо седам обавезних параметара и додајемо сопствене параметре наше скрипте, заједно са описом и подразумеваном вредношћу за сваки параметар.

Када наведемо захтеване параметре, тада треба да наведемо параметре који одговарају параметрима који су потребни нашој скрипти. Када наводимо ове параметре, дајемо наговештаје о томе које су они врсте. Ово је за прозорче које се појављује када корисник изабере нашу скрипту. Такође наводимо и подразумевану вредност.

Овај одељак процеса регистрације има следећи формат:

Када региструјемо нашу скрипту, морамо да кажемо ГИМП-у где би требало да се налази у изборнику.

Најбоље место у изборнику за вашу скрипту зависи од њене функције. Већина скрипти се налази у изборницима Филтери и Боје.

За тренутну скрипту, која ствара нову слику, бирамо подмени Филтери → Увежбавање. То је оно што ради линија са функцијом script-fu-menu-register. Тако смо овде регистровали нашу скрипту „Текстуална кутија“: Филтери → Увежбавање → Текстуална кутија.

Било који подмени који наведете у својој скрипти, а који још не постоји, ГИМП ће аутоматски направити.