TOOL BASIC 7.5  (c)1989  by KUBISOFT

Tool Basic Syntax Erläuterungen des Autors / Author's explanations Parameter / Parameters Befehle / Commands Funktionen / Functions

Tool Basic Download D64 mit Beispielprogrammen / D64 with samples [Toolbasic.D64]

---

Parameter / Parameters
 

Erläuterungen zu den verwendeten Parametern  Explanations about the used parameters
Parameter	englische Übersetzung English translation	Bemerkungen remarks
<adr>=<adresse>	<address>	Adresse (16-Bit-Integer) {0..65535} Address (16 Bit Integer)
<buchstabe>	<char>	Zeichen Character
<farbe>	<colour>	VIC Farbcode {0..15} VIC colourcode
<nr>	<no>	Nummer Number
<Quell­Farbe>	<scource colour>	Alte Farbe, die geändert werden soll colour to change (old colour)
<string>	<string>	Zeichenkette Textstring
<wert>	<value>	8-Bit-Integer (Byte) {0..255} 8 Bit Integer (Byte)
<x>	<x>	x-Grafik-Koordinate {0..159} graphic: x-coordinate
<y>	<y>	y-Koordinate {0..199} graphic: y-coordinate
<Ziel­Farbe>	<target colour>	Neue Farbe, die die alte ersetzt new colour (replaces old color)

---

Befehle / Commands

POINT <farbe>,<x>,<y>
setzt Punkt mit <farbe>={0..15} an <x>,<y>
set Point with <color>={0..15} at <x>,<y>

LINE <farbe>,<x>,<y>[TO <x>,<y>|,<farbe>,<x>,<y>][...]
zieht wahlweise Linienzüge mit <farbe>, oder erlaubt das Absetzen und Neu­Ansetzen mit anderer Farbe (d.h. die eckige Klammer mit der Auswahl kann beliebig wiederholt werden).
Beispiel: LINE 1,150,100 TO 130,120 TO 140,160, 2,56,35 TO 22,34

ANIM
Colorcycling: Tauscht global auf dem Bildschirm im Multicolormodus eine Quell­ durch eine Zielfarbe aus. Welche das genau sind, wird bestimmt durch SCOL
Colorcycling: global change (on the whole multi color mode screen) of a source color to a target color. The colors have to be defioned by SCOL

SCOL <Quell­Farbe>,<Ziel­Farbe>
beide Farben von 0 bis 15
both colors ranges from 0 to 15

RSTCOL
setzt die Farbersatztabelle für ANIM auf Standard (d.h. überhaupt kein Austausch!)

CALL <adr>
ruft Programm im Z80­Code an Adresse <adr> auf. Dieses Programm muss mit RET beendet werden. Die Obergrenze des Stacks liegt bei &FF00

FKEY [<nr>,<string>]
ist ein vollwertiger Ersatz für den KEY­Befehl, der es allerdings erlaubt, mit <nr>=9,10 auch die HELP­Taste, sowie die Kombination Shift­RUN/STOP zu verändern. FKEY ohne Parameter zeigt F1 bis F10 an

VPOKE <adresse>,<wert>
schreibt <wert>={0..255} an <adresse>={0..65535}des VDC­RAM

VSET <nr>,<wert>
schreibt <wert> in Register <nr> des VDC

BOOST ON|OFF
schaltet 2 MHz im Rahmen an oder aus
switches 2 MHz mode in the border on / off

OLD
macht ein vorheriges NEW rückgängig (wohl *der* Klassiker in allen BASIC­Erweiterungen :)

MERGE
verbindet zwei Programme... ob die Syntax so wie bei LOAD ist, kann ich allerdings nicht mit Sicherheit sagen. Jedenfalls sollten die Zeilennummern des nachgeladenen Programms größer sein, als die höchste des zuerst geladenen Programms

POP
entfernt ein GOSUB vom Runtime­Stack
removes a GOSUB from runtime stack

BELL
Lässt den Signalton erklingen

ESC <buchstabe>
führt ESC + Buchstabe aus. Aus dem Listing meine ich zu entnehmen, dass man durch Anhängen weiterer Buchstaben ganze Sequenzen ausführen kann

ULINE ON|OFF
schaltet Underline (nur VDC!) für nachfolgende PRINTs an oder aus

FLASH ON|OFF
schaltet Blinken (nur VDC!) für nachfolgende PRINTs an oder aus

DMCLR
löscht alle Arrays ­ (ersehen vom Listing) ­ aber wohl nicht die Backdescriptoren der Strings, und funktioniert daher wohl nicht richtig (irgendwie war mir das Teil damals schon suspekt.)

MODE <nr>
<nr> von 1 bis 2. Gibt an, was geschehen soll, wenn alle Farbquellen eines Zeichens beim Zeichnen erschöpft sind. Je nach Aktion wird der Punkt
a) entweder übersprungen oder
b) gelöscht und ggf. übermalt.

QUIT
deaktiviert die Erweiterung
deactivats the extension

DOKE <adresse>,<wert>
Schreibt 16­Bit <wert> mit Low­Byte an <adresse> und High­Byte an <adresse>+1. Beachtet (meines Wissens) korrekt die Angabe von BANK

---

Funktionen / Functions

TEST(<x>,<y>)
liest die Farbe von 0..15 des Pixels <x>,<y> <x>={0..159},<y>={0..199}

VPEEK(<adr>)
liest das Byte bei <adr> aus dem VDC­RAM
reads byte at <address> from VDC RAM

VGET(<nr>)
liest das VDC­Register <nr> aus
reads VDC register <no>

LOW(<wert>)
ergibt das Low­Byte des 16­Bit­Wertes <adr>

HIGH(<wert>)
ergibt das High­Byte des 16­Bit­Wertes <adr>

RLUM(<farbe>)
liest die Helligkeit von <farbe> aus einer festen Tabelle, liefert Werte von 0(=dunkel, schwarz) bis 8 (=hell, weiß)

ADR(<low>,<high>)
berechnet <low>+256*<high>

FRAC(<wert>)
berechnet den gebrochenen Anteil von <wert>, d.h. <wert>­INT(<wert>).

CBR(<wert>)
berechnet die Kubikwurzel von <wert>

ASN,ACS,COT,ACT(<wert>)
sind Arcussinus, Arcuscosinus, Cotangens und Arcuscotangens von <wert>

DEEK(<adr>)
ließt Low­Byte von <adr>, High­Byte von <adr>+1, und liefert LO+256*HI zurück.

MOD(<num>,<quo>)
liefert den Rest bei der Division von <num> durch <quo>