Una de las operaciones más comunes que realiza el autor en GIMP es crear una caja con algún texto en ella para una página web, un logotipo o algo así. Nunca se sabe el tamaño adecuado de una imagen cuando se empieza. No sabe cuánto espacio llenará el texto con la tipografía ni el tamaño de tipografía que quiere.

Los maestros de Script-Fu (y los estudiantes) reconocen rápidamente que este problema puede resolverse fácilmente y automatizado con Script-Fu.

Crearemos un script, llamado «Text Box», que creará una imagen, con el tamaño correctamente ajustado a una línea de texto, que el usuario introduce. También, dejaremos al usuario elegir la fuente, el tamaño de la fuente y el color del texto.

Hasta ahora, hemos trabajado en la consola de Script-Fu. Ahora, sin embargo, vamos a cambiar para editar códigos de archivos de texto.

Dónde situar sus códigos es cuestión de preferencias, si tiene acceso a la carpeta de scripts predefinida de GIMP, puede situarlos allí. Sin embargo, es preferible dejar los códigos personales en la carpeta personal de scripts, para mantenerlos separados de los instalados de fabrica.

En la carpeta .gimp-2.8, que GIMP crea en su carpeta personal, debería encontrar una carpeta llamada scripts. GIMP, buscará automáticamente en su carpeta .gimp-2.8 la carpeta scripts, y añadirá los scripts de esta carpeta a la base de datos de Script-Fu. Debería situar sus scripts personales aquí.

Cada guión Script-Fu define al menos una función, que es la función principal del script. Es donde hace el trabajo.

Cada script debe registrarse también en la base de datos de procedimientos, para poder acceder a el bajo GIMP.

Se define la función principal, primero:

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

Aquí se ha definido una nueva función llamada script-fu-text-box que toma cuatro parámetros que más tarde corresponderán al texto, a una tipografía, al tamaño de la tipografía y al color del texto. La función generalmente está vacía y no hace nada. Hasta ahora, todo va bien; nada nuevo, nada lujoso.

Las convenciones de nombres en Scheme parecen preferir minúsculas con guiones y se han seguido en el nombre de la función. Sin embargo, se parte de la convención con los parámetros. Se quieren nombres más descriptivos para los parámetros y variables, y se añade el prefijo «in» a los parámetros, así se puede ver rápidamente qué valores entran en el script, en lugar de que los que se crean en él. Se usa el prefijo «the» para las variables definidas en el script.

Es la convención de GIMP para nombrar sus funciones de script script-fu-abc, porque así están listadas en la base de datos de procedimientos, todas ellas se mostrarán bajo Script-Fu cuando se estén listando las funciones. Esto también ayuda a distinguirlas de los complementos.

Ahora se registra la función con GIMP. Esto se hace llamando a la función script-fu-register. Cuando GIMP lee en un script, ejecutará esta función, que registrará el script en la base de datos de procedimientos. Puede situar esta llamada a la función donde quiera en su script, pero normalmente se sitúa al final, después de las otras líneas de código.

Aquí está el listado de registro de esta función (se explicarán todos estos parámetros enseguida):

  (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;\
      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>/File/Create/Text")
      

Si guarda estas funciones en un archivo de texto con el sufijo .scm en su carpeta de scripts, seleccione Filtros → Script-Fu → Actualizar scripts, este script nuevo aparecerá como Archivo → Crear → Texto → Text Box.

Si llama a este nuevo script, no hará nada, desde luego, pero puede ver los apuntes creados cuando se registra el script (más información de lo que hicimos, se descubrirá luego).

Finalmente, si abre el visor de procedimientos Ayuda → Visor de procedimientos), verá que nuestro script aparece en la base de datos.

Para registrar el script en GIMP, se llamará a la función script-fu-register, se rellenarán los siete parámetros requeridos y se añadirán los parámetros propios, junto con una descripción y los valores predefinidos para cada parámetro.

Figura 13.4. El menú del script.

Una vez que se han listado los parámetros requeridos, se necesitan listar los parámetros que corresponden a los parámetros que su script necesita. Al listar estos parámetros, se dan indicaciones del tipo que son. Esto es por el diálogo que aparece cuando el usuario selecciona el script. También se pueden proporcionar valores predefinidos.

Esta sección del proceso de registro tiene el siguiente formato: