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/.
| 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.
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:
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.
| 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)
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.
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.
| 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 |
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«.
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
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.