# Eigene Programme schreiben: Was Folk mitbringt Diese Seite zeigt, was die mitgelieferten Programme (`builtin-programs/`) für eigene Folk-Programme bereitstellen. Ein Programm ist ein Stück Code auf einem Blatt Papier mit AprilTag. `$this` ist immer das eigene Blatt. ## Grundprinzip - `Claim …` – eine Aussage machen: `Claim $this is cool` - `Wish …` – etwas wünschen, ein anderes Programm erfüllt es: `Wish $this is outlined blue` - `When … { … }` – auf Aussagen reagieren; `/name/` ist eine Variable: `When /someone/ is cool { … }` - Mehrere Bedingungen mit `&` verknüpfen: `When $this points up at /p/ & /p/ is cool { … }` ## Ein neues Programm anlegen 1. Web-Oberfläche öffnen: `http://:4273/new`. 2. Code eingeben, mit Ctrl/Cmd+S speichern, mit Ctrl/Cmd+P drucken. 3. Gedrucktes Blatt unter Kamera/Projektor legen – das Programm läuft. **Programme am Tisch bearbeiten:** Tastatur (mit eigenem Tag) unter das Blatt legen, sodass sie nach oben darauf zeigt. Es erscheint ein Editor. | Taste | Wirkung | |---|---| | Ctrl+S | Speichern (Programm läuft sofort mit neuem Code) | | Ctrl+P | Neu drucken | | Ctrl+Z / Ctrl+Y | Rückgängig / Wiederholen | | Ctrl+C / X / V | Kopieren / Ausschneiden / Einfügen | | Ctrl+R | Änderungen verwerfen | | Ctrl+- / Ctrl+= | Schrift kleiner / größer | | Ctrl+B | Erstellt ein neues leeres Programm (Blank) | Geänderte Programme zeigen „(edited …)“ als Titel. ## Beschriften & Hervorheben ```tcl Wish $this is labelled "Hallo Welt" ;# Text mitten auf dem Blatt Wish $this is outlined green ;# farbiger Rahmen Wish $this is titled "Überschrift" ;# Text über dem Blatt Wish $this is footnoted "Fußnote" ;# Text unter dem Blatt Wish $this is left-margined "links" ;# bzw. right-margined Wish $this is filled red ;# Blatt einfärben ``` ## Formen & Text zeichnen Koordinaten beziehen sich auf das eigene Blatt. Längen brauchen eine Einheit (`mm`, `cm`, `m`) oder sind relativ (`50%`). ```tcl Wish $this draws a circle Wish $this draws a circle with radius 2cm color red filled true Wish $this draws a rect with width 5cm height 2cm offset {right 50%} Wish $this draws a triangle with radians 0.5 color yellow Wish $this draws a shape with sides 7 radius 3cm Wish $this draws text "Hallo" with position {10% 20%} scale 1cm color white Wish $this draws a polyline {{0cm 0cm} {5cm 2cm} {8cm 0cm}} with dashed true Wish $this draws a polygon {{0cm 0cm} {4cm 0cm} {2cm 3cm}} with color blue ``` - Formen: `circle`, `rect`, `triangle`, `square`, `pentagon` … `octagon`, oder beliebig viele Ecken via `sides`. - Position: `position {x y}`, `x … y …`, oder `offset {right 3cm}` / `{up 50%}` relativ zur Blattmitte. - Weitere Optionen: `color`, `filled`, `thickness`, `radians`, `layer`. - Farben: Namen wie `red`, `green`, `blue`, `yellow`, `white`. ## Bilder, GIFs, Shader ```tcl Wish $this displays image "katze.png" ;# aus ~/folk-images/ Wish $this displays image "/pfad/zu/bild.jpg" Wish $this draws sprite "lauf.png" with frames 8 columns 4 fps 12 Wish $this draws toy shader { … GLSL im ShaderToy-Stil … } ``` JPEG, PNG und GIF (animiert) werden unterstützt. ## Mit anderen Blättern interagieren ```tcl # Zeigen: Ist ein anderes Blatt über meinem? When $this points up at /p/ { Wish $p is labelled "Ich werde angezeigt" } # Richtung: up, down, left, right; optional Reichweite: When $this points right with length 0.5 at /p/ { … } # Zeit (Sekunden) für Animationen When the clock time is /t/ { Wish $this is labelled [clock format [expr {int($t)}] -format %T] } ``` ## Kamera & Erkennung ```tcl # Kamerabild des eigenen Blatts anzeigen When $this has camera slice /slice/ { Wish $this displays camera slice $slice } # Umrisse von Gezeichnetem auf dem Blatt erkennen lassen Wish $this has contours ``` Optional (benötigen installierte ML-Modelle): Objektverfolgung (SAM2), Texterkennung (CRAFT, TrOCR), Bildvergleich (DINOv2), Laserpointer- Erkennung (`Wish to detect laser blobs`). ## Ton & Musik ```tcl Wish to play audio drums.wav ;# aus assets/sounds/ oder user-programs//sounds/ Wish to play audio /pfad/zu/datei.mp3 ``` WAV, FLAC und MP3. `music.folk` bindet zusätzlich TidalCycles an. ## Rechner & Außenwelt ```tcl # Befehl ausführen, Ausgabe zeilenweise erhalten Wish $this runs Unix command "ls" with arguments [list "-l"] When $this has Unix output lines /lines/ { Wish $this is labelled [join $lines \n] } # Eigene Webseite unter http://:4273/hallo Wish the web server handles route "/hallo" with handler { html {

Hallo aus Folk

} } ``` ## Fehler finden - Bei einem Fehler blinkt der Rahmen des Blatts rot, die Meldung steht als Titel darüber (Warnungen: gelb). - Web-Oberfläche (`http://:4273/`): Liste aller Programme, aktuelle Statements (`/statements`), Kamerabild (`/camera`), erkannte Blätter (`/quads`), Programmcode (`/program/`). ## Beispiele `builtin-programs/demos.folk` enthält kleine Startbeispiele (Tags 45000–45008): Beschriften, Zeigen, Uhrzeit, Kamerabild.