kind: reference search: TIC-80, Fantasy-Konsole, Lua, TIC, BOOT, cls, spr, map, mget, btn, btnp, print, trace, sfx, music, rect, circ, line, pix, Sprite, Kachel, Konsole, Cartridge, ipairs, Tabelle

TIC-80

TIC-80 zum Nachschlagen, so wie in Star Catcher: die Konsole und die Editoren, der Bildschirm, die Befehle zum Zeichnen, für Eingaben und Töne, die Karte, und Lua, die Sprache, in der man TIC-80 programmiert. TIC-80 selbst öffnest du unter /tic80/.

1. Konsole und Editoren

In der Konsole Was es tut
new lua ein neues Spiel in Lua, mit einem kleinen Beispielprogramm
save stars.lua speichert als Textdatei in /workspace/TIC-80; danach reicht StrgS
load stars.lua lädt ein gespeichertes Spiel
ls, cd ordner zeigt die Dateien, wechselt den Ordner
run startet das Spiel, wie StrgR
help api, help spr alle Befehle; was ein Befehl erwartet
Taste Was sie tut
Esc zwischen Konsole und Editor wechseln; ein laufendes Spiel beenden
StrgR, StrgS starten, speichern
F1 bis F5 Code, Sprites, Karte, Töne (SFX), Musik
StrgF, StrgG, Strg/ im Code-Editor: suchen, zu einer Zeile springen, eine Zeile zum Kommentar machen und zurück

Eine Spieldatei (»Cartridge«) enthält alles: oben den Code, darunter als Kommentare die Sprites, die Karte und die Töne. Bearbeite sie entweder in TIC-80 oder in Visual Studio Code, nicht in beiden zugleich.

2. Bildschirm und Farben

Der Bildschirm ist 240 Pixel breit und 136 hoch. (0, 0) ist oben links, x wächst nach rechts, y nach unten. Eine Farbe ist eine Nummer von 0 bis 15:

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

Ein Spiel besteht aus Funktionen, die TIC-80 selbst aufruft:

Funktion Wann TIC-80 sie aufruft
TIC() 60-mal in der Sekunde, jedes Mal für ein ganzes Bild; muss es geben
BOOT() einmal beim Start, vor dem ersten TIC(): zum Vorbereiten

Weil TIC() 60-mal in der Sekunde läuft, ist eine Bewegung um 1 Pixel pro Aufruf 60 Pixel in der Sekunde. Wer die Bilder zählt (t = t + 1 in TIC()), hat eine Uhr: t // 60 sind die Sekunden. time() gibt die Millisekunden seit dem Start.

3. Zeichnen

Befehl Was er zeichnet
cls(farbe) füllt den ganzen Bildschirm
pix(x, y, farbe) einen Pixel; pix(x, y) ohne Farbe liest seine Farbe
line(x0, y0, x1, y1, farbe) eine Linie
rect(x, y, breite, hoehe, farbe) ein gefülltes Rechteck, (x, y) ist die Ecke oben links; rectb nur den Rand
circ(x, y, radius, farbe) einen gefüllten Kreis um (x, y); circb nur den Rand
elli(x, y, a, b, farbe) eine Ellipse mit den Halbachsen a und b; ellib nur den Rand
tri(x1, y1, x2, y2, x3, y3, farbe) ein gefülltes Dreieck; trib nur den Rand
print(text, x, y, farbe) einen Text; dahinter fixed (alle Zeichen gleich breit, true/false), scale (Vergrößerung), smallfont (kleine Schrift). Gibt die Breite in Pixeln zurück

Was später gezeichnet wird, liegt oben. Deshalb steht cls meist am Anfang des Zeichnens, dann der Hintergrund, zuletzt Figuren und Text. Umlaute kennt die Schrift nicht: ae, oe, ue, ss.

Einen Text in die Mitte setzen: erst unsichtbar messen, dann zeichnen.

local w = print("GAME OVER", 0, -6)   -- über dem Bildschirm: nur messen
print("GAME OVER", (240 - w) // 2, 64, 12)

4. Sprites und Karte

Ein Sprite sind 8 × 8 Pixel aus dem Sprite-Editor (F2). Rechts im Editor stehen alle, nummeriert von links oben nach rechts, 16 in einer Zeile: In der zweiten Zeile beginnt Nummer 16.

spr(1, x, 112, 14, 1, 0, 0, 2, 2)
Stelle Bedeutung hier
id die Nummer des Sprites 1
x, y wo seine Ecke oben links hinkommt x, 112
colorkey diese Farbe bleibt durchsichtig; −1 heißt keine 14
scale Vergrößerung: 2 zeichnet jeden Pixel als 2 × 2 1
flip spiegeln: 0 nicht, 1 waagerecht, 2 senkrecht, 3 beides 0
rotate drehen im Uhrzeigersinn: 0, 1 (90°), 2 (180°), 3 (270°) 0
w, h so viele Sprites nebeneinander und untereinander, als ein Bild 2, 2: 16 × 16 Pixel

Mehrere Sprites als ein Bild sind die im Editor nebeneinander und untereinander: Bei Sprite 1 mit w = 2, h = 2 sind das 1, 2, 17 und 18, denn eine Zeile im Editor hat 16 Sprites. Eine Figur, die nach links läuft, ist dieselbe mit flip = 1. Für eine Animation wechselt die Nummer, etwa spr(1 + (t // 10) % 2 * 2, …) für zwei Bilder, die sich alle 10 Bilder abwechseln.

Die Karte

Im Map-Editor (F3) setzt du Sprites in ein großes Raster aus Zellen, je 8 × 8 Pixel; ein Bildschirm voll sind 30 × 17 Zellen.

Befehl Was er tut
map() zeichnet den ersten Bildschirm der Karte, ab Zelle (0, 0)
map(zx, zy, w, h, sx, sy, colorkey) zeichnet w × h Zellen ab Zelle (zx, zy) an die Bildschirmstelle (sx, sy) in Pixeln; mit colorkey wird eine Farbe durchsichtig
mget(zx, zy) welches Sprite in Zelle (zx, zy) steht
mset(zx, zy, id) setzt eins hinein, etwa um eine eingesammelte Münze zu entfernen

Von Pixeln zu Zellen geht es mit // 8: Eine Figur bei (x, y) steht in Zelle (x // 8, y // 8). Ob sie in eine Wand liefe, fragt mget an der Stelle, an der sie nach dem Schritt stünde, bevor sie ihn macht.

5. Eingaben und Töne

Nummer 0 1 2 3 4 5 6 7
Knopf oben unten links rechts A B X Y
Tastatur ↑ ↓ ← → Z X A S
Befehl wahr, …
btn(4) solange der Knopf gedrückt ist: zum Laufen
btnp(4) nur im ersten Bild, in dem er gedrückt ist: zum Springen, Schießen, Neustarten
key(nummer), keyp(nummer) dasselbe für jede Taste der Tastatur; die Nummern zeigt help keys
mx, my, links = mouse() wo die Maus ist und ob die linke Taste gedrückt ist

Spieler 2 hat die Knöpfe 8 bis 15, in derselben Reihenfolge.

Befehl Was er tut
sfx(0, "C-6", 8) spielt Ton 0 aus dem SFX-Editor (F4) als C in der 6. Oktave, 8 Bilder lang; ohne Dauer so lang, bis ein anderer Ton kommt. Erhöhte Töne mit #: "F#4"
sfx(1, "E-4", 30, 1) auf Kanal 1 statt 0: Zwei Töne auf verschiedenen Kanälen klingen zugleich, auf demselben ersetzt der neue den alten
sfx(-1) beendet den Ton auf Kanal 0
music(0), music() spielt Musikstück 0 aus dem Musik-Editor (F5) in einer Schleife; ohne Nummer hört die Musik auf

6. Lua

Lua ist klein: ein paar Wörter für Verzweigungen und Schleifen, und für alles Zusammengesetzte eine einzige Sorte Wert, die Tabelle.

Was In Lua
Kommentar -- bis zum Zeilenende, über mehrere Zeilen --[[ … ]]
Variable x = 112 gilt überall; local x = 112 nur in dieser Funktion oder diesem Block
nichts, wahr, falsch nil, true, false; nur nil und false sind falsch, auch 0 ist wahr
vergleichen ==, ~= (ungleich), <, <=; verknüpfen mit and, or, not
rechnen + - * /; / gibt immer eine Kommazahl, 7 // 2 ist 3, 7 % 2 ist 1
Text "Score: " .. score hängt an; #text ist die Länge
verzweigen if x < 0 then … elseif … else … end
zählen for i = 1, 10 do … end, mit 10; rückwärts for i = 10, 1, -1 do
solange while x < 100 do … end
Funktion function newStar(i) … return … end
Zufall math.random(0, 232): eine ganze Zahl von 0 bis 232, beide mitgezählt
runden, Betrag, kleiner math.floor(x), math.abs(x), math.min(a, b), math.max(a, b)

Roberto Ierusalimschy (geboren 1960), Waldemar Celes und Luiz Henrique de Figueiredo, brasilianische Informatiker, entwarfen Lua 1993 in der Gruppe Tecgraf an der Katholischen Universität in Rio de Janeiro. Bis 1992 schottete Brasilien sich mit hohen Handelsschranken gegen Computer und Software aus dem Ausland ab, also bauten sie ihre Werkzeuge selbst. Wer in Roblox ein Spiel baut, schreibt Luau, eine Sprache, die aus Lua entstanden ist.

Lua heißt auf Portugiesisch »Mond«: Eine der Sprachen, aus denen Lua hervorging, hieß SOL, »Sonne«.

Tabellen

Eine Tabelle ist eine Liste, ein Objekt mit Namen für seine Teile, oder beides:

stars = {}                          -- eine leere Liste
stars[1] = { x = 40, y = 0 }        -- ein Stern: Teile mit Namen
table.insert(stars, { x = 90, y = -20 })   -- hinten anhängen
trace(#stars)                       -- wie viele: 2, in der Konsole
for i, s in ipairs(stars) do        -- der Reihe nach, i ist die Nummer
    s.y = s.y + 1                   -- s.y ist dasselbe wie s["y"]
end

Eine Liste zählt in Lua ab 1, nicht ab 0: stars[1] ist der erste, stars[#stars] der letzte. table.remove(stars, i) nimmt den i-ten heraus, und alle dahinter rücken auf. Wer beim Durchgehen löscht, geht deshalb rückwärts, sonst wird der Nachfolger eines gelöschten übersprungen:

for i = #stars, 1, -1 do
    if stars[i].y > 136 then
        table.remove(stars, i)
    end
end

7. Wenn etwas nicht klappt

trace(wert) schreibt einen Wert in die Konsole, ohne das Bild zu stören; mit Esc siehst du ihn. Bricht das Spiel mit einer Meldung ab, steht darin die Zeile:

  • attempt to index a nil value (global 'player') – Die Tabelle player gibt es noch nicht: vertippt, oder sie wird erst später angelegt.
  • attempt to perform arithmetic on a nil value – Mit einer Variablen gerechnet, die nie einen Wert bekommen hat, oft wegen eines Tippfehlers wie scroe.
  • attempt to call a nil value (global 'newstar') – Die Funktion heißt anders (newStar, Groß und klein zählt), oder sie steht weiter unten als ihr erster Aufruf außerhalb einer Funktion.
  • 'end' expected – Ein end fehlt. Die Zeilennummer in Klammern nennt, wo der Block begann.
  • 'then' expected, 'do' expected – Nach if fehlt then, nach for oder while fehlt do.

8. Zum Nachschlagen