Toolbox-1/README.md

215 lines
4.8 KiB
Markdown

HIVE TOOLBOX 1
==============
Nach einer gründlichen Aufräumarbeit im TriOS ist diese Toolbox 1 das erste
Paket einer ganzen Serie von Anwendungen, Democodes, Tools und Mediendateien
für den Hive. Viele Fragmente gab es bisher schon auf meiner Festplatte oder
sind bei der Programmierung vom TriOS entstanden, aber meist hatten sie mehr
einen experimentellen Charakter und fehlte noch eine Kleinigkeit. Einige
wenige Dateien sind Beispiele von Parallax oder aus der Community, die ich
an den Hive angepasst habe. In dieser Toolbox enthalten sind Codebeispiele
aus folgenden Themenbereichen:
- Bellatrix-Programmierung: Dabei handelt es sich um reinen Bellatrix-Code,
also ohne Anbindung und Kommunikation zu Regnatix.
- Graphics-Objekt: Wie werden einfache Grafiken erzeugt, die Maus eingebunden,
Animationen erzeugt usw.
- Grundlegende Ansteuerung der zwei SID-COG's im Administra-Code admsid.adm
- Regnatix-Code: Ein einfaches Hallo-Welt und ein Beispiel, wie die Parameter-
übergabe von Regime funktioniert
Ich hoffe, dass diese Fragmente ein wenig zum Experimentieren einladen und
zeigen können, wie einfach die Programmierung der Slavechips und des Hive ist.
Alle Demos sind direkt in Regime startbar und werden entweder mit ESC oder der
rechten Maustaste abgebrochen. Teilweise ist noch die linke Taste und das
Scrollrad mit einer Funktion belegt - einfach mal testen.
Vorraussetzungen zum Selbstcompilieren: Als Compiler muß Brat's Spin Tool -
kurz BST - verwendet werden. In den Einstellungen des Compilers
(Tools/Compiler Preferences/Search Paths) muss das lib-Verzeichnis im TriOS
eingetragen werden, damit der Compiler die benötigten Bibliotheken findet.
Downloadlink BST: http://www.fnarfbargle.com/bst.html
Um mit der makelog-Batchdatei alle ausführbaren Dateien in einem Rutsch zu
erstellen, muß sich die Commandline-Version des Compilers (bstc) im Pfad
befinden. Außerdem müssen die Quelltexte in folgender Struktur vorliegen:
Hauptverzeichnis (beliebiger Name und Ort)
|
+-Bin
|
+-TriOS
|
+-Toolbox-1
Diese Struktur ist nötig, damit auch der Kommandozeilencompiler bstc.exe auf
die Bibliotheken von TriOS zugreifen kann. Alternativ könnte man natürlich auch
den Pfad in der Batchdatei anpassen. Das Bin-Verzeichnis wird automatisch
erstellt und enthält die auf die SD-Card zu spielenden Daten.
-------------------------------------------------------------------------------
Name : 1-koord.bel
Chip : Bellatrix
Video : TV
- Initialisierung des Graphics-Objektes
- Einfache Grafikbefehle, Textausgabe
- Darstellung des Koordinatensystems
Name : 2-dots
Chip : Bellatrix
Video : TV
- Füllt den Bildschirm mit Kreisen verschiedener Farbe.
Name : 3-objekt
Chip : Bellatrix
Video : TV
- Verwendung und Animation von Vektorobjekten
Name : 4-boing
Chip : Bellatrix
Video : TV
- Animiertes Vektorobjekt
Name : 5-scroll
Chip : Bellatrix
Video : TV
- Animiertes Vektorobjekt mit Textcroller
Name : 6-mouse1
Chip : Bellatrix
Video : TV
- Bewegung und Drehung eines Vektorobjektes mit der Maus.
Name : 6-mouse2
Chip : Bellatrix
Video : TV
- Mauspfeil mit Koordinatenkreuz
- Numerische Koordinatenanzeige
Name : 7-sat
Chip : Bellatrix
Video : TV
- Animation, kreisendes Objekt
Name : 8-sinus
Chip : Bellatrix
Video : TV
- Vektorobjekt mit hinterlegtem Sinus
- Verwendung der Sinustabelle
Name : 9-lissa1
Chip : Bellatrix
Video : TV
- Lissajou-Figur mit Maussteuerung
Name : 9-lissa2
Chip : Bellatrix
Video : TV
- Lissajou-Animation aus 256 Linienfragmenten
Name : 10-ani1
Chip : Bellatrix
Video : TV
- Mauscursor mit Objekt an Gummiseil
Name : 10-ani2
Chip : Bellatrix
Video : TV
- Mauscursor mit zwei per Gummisiel gekoppelten Objekten
Name : 11-logo1
Chip : Bellatrix
Video : TV
- Hive-Logo
Name : 11-logo2
Chip : Bellatrix
Video : TV
- Animation aus zwei drehenden Hive-Logos mit Scrolltext
Name : 12-matr
Chip : Bellatrix
Video : VGA + TV
- Gleichzeitige Ausgabe von verschiedenen Bildern an VGA und TV
- Matrix-Anzeige auf VGA
- Echtzeit Farbscroller ohne Bildpuffer auf TV
Name : 13-gdemo
Chip : Bellatrix
Video : TV
- Graphics-Demo von Parallax
Name : 14-gpal
Chip : Bellatrix
Video : TV
- Anzeige der Graphics-Farbpallette von Parallax
- Numerische Anzeige des Farbwertes unter Mauscursor
Name : 15-sid1, 15-sid2
Chip : Regnatix
Video : VGA
- Einfacher Trackersound auf SID 1 bw. SID 2
- admsid.adm muss vorher geladen werden!
Name : 16-hallo
Chip : Regnatix
Video : VGA
- Hive Version von "Hallo Welt!"
Name : 17-para
Chip : Regnatix
Video : VGA
- Beispiel wie Parameter von der Kommandozeile an die Anwendung übergeben
werden
Name : 18-tdemo
Chip : Regnatix
Video : VGA
- Einfache Anwendung der Zeichenausgabefunktionen