Создание текста для веб-страницы, логотипа — довольно часто используемая операция в GIMP. Однако трудно предугадать, какого размера нужно создать исходное изображение, чтобы весь текст поместился без лишнего места с указанным шрифтом и размером.

Такую задачу довольно легко решить и автоматизировать с помощью Script-Fu.

Мы создадим сценарий под названием Text Box который создаст изображение с правильным размером для текста, введённого пользователем. Пользователь также может указать шрифт, размер шрифта и цвет текста.

До сих пор мы работали в консоли Script-Fu. Теперь же перейдём к редактированию файлов сценариев. Файлы сценариев должны быть простыми текстовыми файлами, которые можно редактировать в текстовом или кодовом редакторе. Имя, которое вы зададите файлу, не так важно, главное, чтобы вы могли его узнать. Файлу сценария следует задать расширение «.scm».

Место хранения сценариев выбираете по своему усмотрению. В настройках папок GIMP можно увидеть, в каких папках GIMP ищет сценарии. Там же можно добавить новую папку. Папка, в которой GIMP хранит собственные сценарии, обычно не является лучшим выбором для ваших сценариев, но в остальном можно выбрать то, что вам больше подходит.

Каждый сценарий Script-Fu определяет по крайней мере одну функцию, которая служит главной функцией сценария. Здесь и совершается главная работа.

Каждый сценарий должен зарегистрироваться с базой процедур, чтобы можно было получить к нему доступ из GIMP.

Мы создадим сначала главную функцию:

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

Здесь мы определили функцию с названием script-fu-text-box, которая берёт четыре параметра. Эти параметры позже соотнесутся с текстом, шрифтом, размером и цветом. Функция сейчас пустая и ничего не делает. Пока ничего нового.

В основном Scheme придерживается маленьких букв с чёрточками для создания названий объектов. Мы следовали этому принципу для названия функции, но не параметров. Для параметров мы выбрали описательные названия с приставкой «in», указывающая, что эти переменные были даны функции, а не декларированы в самой функции или сценарии, для которых мы будем использовать приставку «the».

Согласно своему порядку, GIMP именует пользовательские сценарные функции по типу script-fu-abc, поскольку, когда они присутствуют в процедурной базе данных, они показываются в списке Script-Fu при запросе списка функций. Также, такой порядок наименования помогает отличать их от расширений.

Теперь мы зарегистрируем функцию с GIMP. Это делается вызовом функции script-fu-register. Когда GIMP читает текст сценария, он вызывает эту функцию, и она зарегистрирует нашу функцию в базе процедур. Вызвать эту функцию можно в любом месте сценария, но мы возьмём за правило вызывать её в конце сценария.

Вот исходный код для регистрации функции (параметры будут описаны ниже):

  (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 в подкаталоге вашего каталога сценариев с тем же именем, что и у вашего файла сценария, и перезапустите GIMP. Новый сценарий появится в меню Фильтры → Инструкция → Text Box.

Если вы вызовите этот сценарий, он естественно ничего не сделает, но вы увидите все запросы, созданные во время регистрации сценария. Об этом ниже.

И наконец, если вы вызовете просмотрщик процедур (Справка → Просмотрщик процедур), вы увидите там свой новый сценарий.

Чтобы зарегистрировать сценарий с GIMP, нужно вызвать функцию script-fu-register, заполнить семь необходимых параметров, добавить параметры сценария с описанием и значением по умолчанию для каждого.

После объявления списка необходимых параметров нужно указать параметры, которые соответствуют параметрам сценария. При объявлении списка параметров, мы даём подсказку об их типах. Это делается для диалога параметров, который появится при вызове нашего сценария. Мы также предоставляем значения по умолчанию.

Эта часть процесса регистрации имеет следующий формат:

После регистрации сценария необходимо указать GIMP, где он должен находиться в меню.

Оптимальное расположение сценария зависит от его функции. Большинство сценариев находится в меню Фильтры и Цвет.

Для текущего сценария, который создаёт новое изображение, мы выбираем подменю Фильтры → Инструкция. Именно это делает строка с функцией script-fu-menu-register. Таким образом, мы зарегистрировали наш сценарий Text Box здесь: Фильтры → Инструкция → Text Box.

Любое подменю, которое вы укажете в своём сценарии и которое ещё не существует, будет автоматически создано GIMP.