3.6. Extender el script: Text Box
| 3. Un tutorial de Script-Fu |

### 3.6. Extender el script: Text Box

#### 3.6.1. Mantener correctamente deshacer

Cuando crea un script, quiere dar a sus usuarios la habilidad para deshacer sus acciones, podrían cometer un error. Esto es fácil de efectuar llamando a las funciones `gimp-undo-push-group-start` y `gimp-undo-push-group-end` sobre el código que manipula la imagen. Puede pensar que son declaraciones marcadas que dejan al GIMP saber cuando empezar y parar la grabación de manipulaciones sobre la imagen, así esas manipulaciones pueden ser deshechas más tarde.

Si crea una imagen nueva, no tiene sentido usar estas funciones porque no cambia una imagen existente. Cuando está cambiando una imagen existente, debe asegurarse que quiere usar estas funciones.

Deshacer un script trabaja casi perfectamente cuando usa estas funciones.

#### 3.6.2. Extender el script un poco más

Ahora que hemos creado un excelente y manejable script para crear cajas de texto, añadamosle dos capacidades:

- La imagen se redimensiona exactamente alrededor del texto, no hay sitio para nada, como sombras o efectos especiales (muchos scripts redimensionan la imagen cuando es necesario.

- Este script podría facilmente ser usado en otro script para trabajar con texto. Extendiéndolo para que devuelva la imagen y las capas, así otros scripts pueden llamar a este script y usar la imagen y las capas que creemos.

#### 3.6.3. Modificando los parámetros y la función de registro

Para dejar al usuario especificar la cantidad del bufer, añadiremos un parámetro a nuestra función y a la función de registrar:

            (define (script-fu-text-box inTest inFont inFontSize inTextColor inBufferAmount)
            (let*
                  (
                     ; define our local variables
                     ; create a new image:
                     (theImageWidth  10)
                     (theImageHeight 10)
                     (theImage (car
                                    (gimp-image-new
                                     theImageWidth
                                     theImageHeight
                                     RGB
                                    )
                               )
                     )
                     (theText)          ;a declaration for the text
                                        ;we create later

                     (theBuffer)        ;added

                     (theLayer
                               (car
                                   (gimp-layer-new
                                    theImage
                                    theImageWidth
                                    theImageHeight
                                    RGB-IMAGE
                                    "layer 1"
                                    100
                                    NORMAL
                                   )
                               )
                     )
                  ) ;end of our local variables

             [Code here]
           )

            (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
              SF-ADJUSTMENT  "Buffer amount" '(35 0 100 1 10 1 0)
                                                          ;a slider
            )
            (script-fu-menu-register "script-fu-text-box" "<Toolbox>/Xtns/Script-Fu/Text")

#### 3.6.4. Añadir el nuevo código

Vamos a añadir código en dos sitios: antes de redimensionar la imagen y al final del script (para devolver la nueva imagen, la capa y el texto).

Después de obtener el ancho y alto del texto, necesitamos redimensionar estos valores basados en la cantidad del bufer especificado por el usuario. No queremos cometer ningún error, chequeando para asegurar que está en el rango de 0-100%, porque no es vital y porque no hay razón para que el usuario no pueda dar un valor como 200 % de bufer para añadir.

            (set! theBuffer (* theImageHeight (/ inBufferAmount 100) ) )

            (set! theImageHeight (+ theImageHeight theBuffer theBuffer) )
            (set! theImageWidth  (+ theImageWidth  theBuffer theBuffer) )

Todo lo que hacemos aquí es configurar el bufer basado en la altura del texto, y añadirlo dos veces a ambos, el alto y ancho de nuestra nueva imagen. (Lo añadiremos dos veces porque el bufer necesita ser añadido a ambos lados del texto).

Ahora que hemos redimensionado la imagen para permitir un bufer, necesitamos centrar el texto bajo la imagen. Esto se hace para moverlo a las coordenadas (x, y) de (`theBuffer`, `theBuffer`). Añadí esta linea después de redimensionar la capa y la imagen:

            (gimp-layer-set-offsets theText theBuffer theBuffer)

Adelante y guarde su script, e inténtelo después de refrescar la base de datos.

Todo lo que queda por hacer es devolver nuestra imagen, la capa y la capa del texto. Después de mostrar la imagen, añadimos esta linea:

            (list theImage theLayer theText)

Esta es la última linea de la función, hace que esta linea esté disponible a otros scripts que quieran usarla.

Para usar nuestro nuevo script text box en otro script, podriamos escribir algo como lo siguiente:

            (set! theResult (script-fu-text-box
                             "Some text"
                             "Charter" "30"
                             '(0 0 0)
                             "35"
                            )
            )
            (gimp-image-flatten (car theResult))

Felicitaciones, está en el camino para su ¡Cinturón Negro de Script-Fu!.

3.5. Dar algo de sustancia a nuestro script |  | 3.7. Your script and its working