Witaj świecie!

W tym samouczku omówiono minimalną strukturę wtyczki Scheme. Niektóre linie mają charakter szablonowy: są wymagane, aby Lumi załadował plik, nawet jeśli jeszcze ich w pełni nie rozumiesz.

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

Na wysokim poziomie będziesz:

Zdefiniuj funkcję
Zarejestruj go tak, aby pojawił się w bazie danych procedur
(Opcjonalnie) Dodaj pozycję menu
Zainstaluj plik w folderze wtyczek

Zdefiniuj funkcję

Funkcja, znana również jako procedura, to fragment kodu o nazwie i przeznaczeniu. Pobiera dane wejściowe i generuje dane wyjściowe.

Wejście > Funkcja > Wyjście

Zarejestruj funkcję

Rejestracja polega na umieszczeniu nazwy funkcji na liście, aby Lumi o niej wiedziała.

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

Link do menu

Dzięki temu Lumi znajdzie swoją funkcję w systemie menu.

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

Spowoduje to wyświetlenie menu „Funky” na pasku menu głównego. Zmień ścieżkę, aby umieścić wtyczkę w innym miejscu. Ścieżka <Image>/Funky oznacza, że wtyczka pojawi się w kategorii menu Obraz. Możesz zmienić <Image> na <Tools>, <Filters> itd., w zależności od tego, gdzie chcesz, aby wtyczka się pojawiała.

Komentarze

W Scheme komentarze zazwyczaj umieszcza się poprzedzając pomocny wiersz tekstu znakiem ;;. Im więcej komentarzy, tym łatwiej wrócić do kodu po czasie — szczególnie gdy dopiero uczysz się Scheme.

Składnia

Kod ma zazwyczaj niewiele zasad dotyczących umieszczania elementów w wierszu, dzięki czemu możemy łatwo odczytać wiersz. Na przykład zdanie może zawierać spację po przecinku lub kropce. Pomaga to w czytelności.

Kod może organizować rzeczy w podobny sposób, co na pierwszy rzut oka może wyglądać dziwnie:

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

Przykładowy kod

Oto pełny przykład. Większość procedur Lumi ma przedrostek lumi-. Na przykład lumi-message drukuje ciąg znaków do skonfigurowanej procedury obsługi wiadomości.

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

(define (scheme-hello-world)

  ;; Ustaw obsługę wiadomości, aby wysyłała wiadomość do okna dialogowego GUI
  (lumi-message-set-handler 0)
  (lumi-message "Hello world!\n")

  ;; Ustaw obsługę wiadomości, aby wysyłała wiadomość do konsoli komunikatów
  (lumi-message-set-handler 2)
  (lumi-message "Hello world!\n")

  ;; Wyślij wiadomość do terminala, okna systemu operacyjnego, które uruchomiło 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")

Zainstaluj wtyczkę

Przejdź do Lumi -> Edycja -> Preferencje -> Foldery -> Wtyczki.
Dodaj swój folder wtyczek repo do listy.
Utwórz folder dla wtyczki i zapisz powyższy przykładowy kod jako hello-world.scm:

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

Kliknij prawym przyciskiem myszy plik hello-world.scm.
Przejdź do Właściwości -> Uprawnienia -> Zezwalaj na wykonywanie pliku jako programu.
Uruchom ponownie Lumi.

Wypróbuj wtyczkę

Wtyczka powinna teraz pojawić się w menu „Funky” w głównym oknie Lumi. Kliknij ją — powinien wyświetlić się komunikat „Hello world!”. Spróbuj zmodyfikować kod, na przykład zmienić tekst wiadomości, i zapisz plik. Po ponownym uruchomieniu wtyczki wprowadzone zmiany zostaną odzwierciedlone bez ponownego uruchamiania Lumi.

Spróbuj poeksperymentować, zmieniając ścieżkę menu. Na przykład "<Image>/File" umieści go w menu Plik, a "<Image>/File/Funky" utworzy nową sekcję w menu Plik. Jest to świetny sposób na dostosowanie miejsca wyświetlania wtyczki i uporządkowanie narzędzi.

Przeglądarka procedur Refaktoryzacja