Olá mundo!

Este tutorial percorre a estrutura mínima de um plug-in do Scheme. Algumas linhas são “padrão”: são necessárias para que o Lumi carregue o arquivo, mesmo que você ainda não as entenda completamente.

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

Em um nível alto você irá:

Defina uma função
Cadastre-o para que apareça no banco de dados de procedimentos
(Opcional) Adicione uma entrada de menu
Instale o arquivo em uma pasta de plug-ins

Definir uma função

Uma função, também conhecida como procedimento, é um pedaço de código com nome e finalidade, recebe uma entrada e produz uma saída.

Entrada > Função > Saída

Registre a Função

Cadastrar é o ato de colocar o nome da função em uma lista para que Lumi saiba disso.

(scheme-register-procedure "scheme-hello-world"...

Link para o menu

Isso informa ao Lumi onde encontrar sua função em seu sistema de menu.

(scheme-menu-register "scheme-hello-world" "<Image>/Funky")

Isso exibe o menu “Funky” na barra de menu principal. Altere o caminho para colocar o plug-in em outro lugar. O caminho <Image>/Funky significa que o plug-in aparecerá na categoria de menu Imagem. Você pode alterar <Image> para <Tools>, <Filters>, etc., dependendo de onde deseja que o plug-in apareça.

Comentários

No Scheme, a linguagem base do Scheme, os comentários geralmente são feitos precedendo uma linha de texto útil com ;;. O uso de comentários dependerá de sua fluência como codificador – se você codificar ocasionalmente, mais comentários ajudarão. Se você codificar o tempo todo, o código será tão fácil de ler quanto o comentário. Além disso, ao programar funcionalmente, o código tende a se tornar descritivo o suficiente para ser lido como um script.

Sintaxe

O código tende a ter pequenas regras sobre como colocar itens em uma linha, para que possamos ler a linha facilmente. Por exemplo, uma frase pode ter um espaço após uma vírgula ou ponto final. Ajuda na legibilidade.

O código pode organizar as coisas de maneira semelhante, o que pode parecer estranho à primeira vista:

(define (function-name input-a
                       input-b
                       input-c))

Código de exemplo

Aqui está o exemplo completo. A maioria dos procedimentos Lumi são prefixados com lumi-. Por exemplo, lumi-message imprime uma string no manipulador de mensagens configurado.

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

(define (scheme-hello-world)

  ;; Set the message handler to output the message to a GUI dialog box
  (lumi-message-set-handler 0)
  (lumi-message "Hello world!\n")

  ;; Set the message handler to output the message to the Error Console
  (lumi-message-set-handler 2)
  (lumi-message "Hello world!\n")

  ;; Send the message to the terminal, the OS window that launched Lumi
  (display "Hello world!\n"))


(scheme-register-procedure "scheme-hello-world"
  "Hello world!"
  "A Scheme procedure plug-in"
  "Mark Sweeney"
  "Under GNU GENERAL PUBLIC LICENSE Version 3"
  "2024")

(scheme-menu-register
  "scheme-hello-world"
  "<Image>/Funky")

Instale o plug-in

Vá para Lumi -> Editar -> Preferências -> Pastas -> Plug-ins.
Adicione sua pasta de plug-ins repo à lista.
Crie uma pasta para o plug-in e salve o código de exemplo acima como hello-world.scm:

your-plug-ins-repo/hello-world/hello-world.scm

Clique com o botão direito no arquivo hello-world.scm.
Vá para Propriedades -> Permissões -> Permitir execução de arquivo como programa.
Reinicie o Lumi.

Experimente o plug-in

O plug-in agora deve aparecer no menu “Funky” na janela principal do Lumi. Clique nele e deverá exibir a mensagem “Olá, mundo!” mensagem. Tente modificar o código, como alterar o texto da mensagem, e salve o arquivo. Ao executar o plug-in novamente, suas alterações serão refletidas sem reiniciar o Lumi.

Experimente alterar o caminho do menu. Por exemplo, "<Image>/File" irá colocá-lo dentro do menu Arquivo e "<Image>/File/Funky" irá criar uma nova seção no menu Arquivo. Essa é uma ótima maneira de personalizar onde seu plug-in aparece e de organizar suas ferramentas.

O navegador de procedimentos Refatoração