El complemento de filtro

Usamos un complemento procedure para el tutorial Primer paso. Esos tipos de complementos funcionan sin necesidad de una imagen o un elemento de diseño como entrada. Por lo general, usamos un complemento para cambiar una imagen y sus elementos de diseño. Los complementos como estos se denominan complementos de filtro.

¿Qué es un dibujable?

Un dibujable en Lumi se refiere a un elemento de imagen en el que se puede dibujar, como una capa o un canal. Los complementos de filtro suelen funcionar con estos elementos.

Un ejemplo simple de complemento de filtro

# !/usr/bin/env lumi-scheme-interpreter-0.1

(define (scheme-simple-filter-plug-in image drawables)
  ;; Use a let statement to define a message variable and core code
  (let ((message "hello, world"))
    ;; Display the message in Lumi's error console
    (lumi-message message)
    ;; Invert the colors of the first selected drawable
    (lumi-drawable-invert (vector-ref drawables 0) 1)))

;; Register the plug-in
(scheme-register-filter
  "scheme-simple-filter-plug-in"           ;; Main procedure name
  "Simple Filter Plug-in Demo"             ;; The name as it appears in the Lumi menu
  "Tests a basic Scheme filter plug-in"    ;; Tool-tip description
  "Author Name"                            ;; Give yourself some credit
  "License"                                ;; License
  "Date written"                           ;; Date written
  "*"                                      ;; Indicates this plug-in requires an image
  SF-ONE-OR-MORE-DRAWABLE)                 ;; Requires one or more selected drawables

;; Specify the menu location for the plug-in
(scheme-menu-register
  "scheme-simple-filter-plug-in"
  "<Image>/Plug-in")

Copie el texto y guárdelo como simple-filter-plug-in.scm en una carpeta llamada simple-filter-plug-in dentro de una de las carpetas de complementos de Lumi. Una carpeta de complementos de Lumi es cualquier carpeta enumerada en: Lumi > Editar > Preferencias > Carpetas > Complementos

En Linux, haga clic derecho en el archivo simple-filter-plug-in.scm, vaya a Propiedades > Permisos y marque Permitir ejecutar el archivo como programa. Una vez que el archivo esté en el lugar correcto, ejecutable y libre de errores de sintaxis, cuando se reinicie Lumi, aparecerá en la barra de encabezado del menú superior, dentro de un menú llamado Plug-in.

Ejecutando el complemento

1. Abra una imagen (este complemento de filtro requiere una imagen para funcionar).
2. Abra Windows > Diálogos acoplables > Consola de errores para ver un mensaje.
3. Seleccione Demostración del complemento de filtro simple en el menú Complemento.
4. Una de las capas seleccionadas tendrá sus colores invertidos y se imprimirá un mensaje en la consola de error.

Edición del complemento

Puede personalizar el complemento editando su archivo .scm. Por ejemplo, para cambiar el mensaje mostrado:

1. Abra el archivo y localice la línea que define message.
2. Reemplace "hello, world" con su texto personalizado.
3. Guarde el archivo.

En Lumi versión 3, no es necesario actualizar los complementos para que los cambios guardados surtan efecto. Simplemente vuelva a ejecutar el complemento para ver el mensaje actualizado.

Examen de complemento

Línea Shebang

La primera línea garantiza que el script funcione como un complemento en Lumi 3:

# !/usr/bin/env lumi-scheme-interpreter-0.1

Definición del procedimiento

El procedimiento acepta dos argumentos: la imagen activa y los dibujables seleccionados.

(define (scheme-simple-filter-plug-in image drawables)

Lógica central

Una declaración let define una variable y realiza operaciones en el elemento dibujable.

(let ((message "hello, world"))
  (lumi-message message) ;; Displays a message in Lumi's error console
  (lumi-drawable-invert (vector-ref drawables 0) 1)) ;; Inverts the colors of the first selected drawable

Registro de complemento

El complemento está registrado en Lumi como complemento de filtro:

(scheme-register-filter
  "scheme-simple-filter-plug-in"           ;; Register the main procedure
  "Simple Filter Plug-in Demo"             ;; The name as it appears in the Lumi menu
  "Tests a basic Scheme filter plug-in"    ;; Tool-tip description
  "Author Name"                            ;; Author's name
  "License"                                ;; License type
  "Date written"                           ;; Date written
  "*"                                      ;; Indicates the plug-in requires an image
  SF-ONE-OR-MORE-DRAWABLE)                 ;; Requires one or more selected drawables

Registro de menú

Esta línea especifica la ubicación del menú para el complemento:

(scheme-menu-register
  "scheme-simple-filter-plug-in"
  "<Image>/Plug-in")

Solución de problemas

Si no aparece un complemento, verifique su ubicación, nombre y propiedad ejecutable.

La ubicación debe estar en una ruta de búsqueda de complemento. El nombre del archivo debe coincidir con el nombre de la carpeta que lo contiene. El archivo debe configurarse como ejecutable.

La Consola de errores es una herramienta valiosa para solucionar problemas de complementos personalizados. Si su complemento no se comporta como se esperaba, consulte aquí para ver mensajes de error o registros. La ventana Terminal también puede proporcionar información de depuración e informar problemas de carga.