Anleitung zu den Programmen NEWTRIS.PRG und NEWTRIS.ACC: 1. Hinweise zur Benutzung der Programme 2. TETRIS und COLUMNS 2.1 TETRIS 2.2 COLUMNS 3. Tastenbelegung 4. Belegung der Meneintr„ge 5. Ver„nderungen gegenber frheren Versionen 6. Sonstiges 1. Hinweise zur Benutzung der Programme NEWTRIS ist freeware, d. h. die Programme drfen frei kopiert und weitergegeben werden; Ver„nderungen an den Programmen oder den zu den Programmen geh”renden Dateien NEWT_PRG.RSC und NEWTRIS.TXT sind nicht zul„ssig. Es muž mindestens der komplette Ordner NEWTRIS weitergegeben werden; dieser enth„lt die Dateien NEWTRIS.ACC (Resource im Programm enthalten!), NEWTRIS.PRG und NEWT_PRG.RSC, sowie die Datei NEWTRIS.TXT, welche eine Anleitung zu den Programmen enth„lt (und welche sie gerade lesen sollten). Die Weitergabe des (kompletten) Ordners NEWTRIS und des Accessorys NEWTRIS.ACC im Rootdirectory des Datentr„gers (bei Disketten A:\ bzw. B:\) ist also zul„ssig! Das Accessory NEWTRIS.ACC kann durch Umbenennen in NEWTRIS.PRG als normales GEM-Programm (ohne Menleiste) benutzt werden (das Programm NEWTRIS.PRG benutzt eine Menleiste). NEWTRIS l„uft (mindestens) in allen ST-Aufl”sungen auf allen ATARI STs; daneben sollte NEWTRIS auch in anderen Aufl”sungen und auch auf dem (neuen) ATARI TT laufen - und das mit derselben Geschwindig- keit wie auf dem ST (d. h. die Objekte fallen mit derselben Ge- schwindigkeit wie auf dem ST herunter; gilt auch fr STs mit Be- schleunigerkarten). 2. TETRIS und COLUMNS 2.1 TETRIS TETRIS wurde 1986 von A. Pajitnov und V. Gerasimov erfunden und auf einem IBM-kompatiblen System programmiert. Ziel des Spiels ist es, in einem Schacht herunterfallende Objekte so in diesem zu plazieren, daž der Schacht m”glichst sp„t berl„uft. Dabei wird jede w„hrend des Spiels komplettierte Reihe von Bl”cken gel”scht, womit der freiwerdende Raum fr weitere Objekte genutzt werden kann (und verdeckte L”cher wieder frei werden!). Das gerade 'fallende' Objekt kann nach links und rechts bewegt sowie gegen den Uhrzeigersinn gedreht werden, um es besser einpassen zu k”nnen. Ferner besteht die M”glichkeit, sich das n„chste Objekt anzeigen zu lassen. M”gliche Objekte: ## ## # # ## # ## ## ### ### ## ### #### 2.2 COLUMNS Auch bei COLUMNS gilt es, zu verhindern, daž Objekte, die einen Schacht hinunterfallen, diesen zum šberlauf bringen. Ein Objekt be- steht aus drei Segmenten; es stehen sechs verschiedene Segmenttypen zur Verfgung, die sich in Farbe und/oder Muster unterscheiden. Falls mindestens drei Segmente horizontal, vertikal oder diagonal nebeneinanderliegen, verschwinden diese aus dem Schacht; eventuell darber liegende Segmente rcken nach, was zu Kettenreaktionen fhren kann. Ebenso wie bei TETRIS k”nnen die Objekte nach links und rechts bewegt sowie fallengelassen werden; die Segmente k”nnen von oben nach unten durchrotiert werden. 3. Tastenbelegung '7': Objekt nach links bewegen '8': TETRIS: Objekt gegen den Uhrzeigersinn drehen COLUMNS: Objekt von oben nach unten 'rotieren' '9': Objekt nach rechts bewegen '4' oder SPACE: Objekt fallenlassen '1': Vorschau an/aus '6': Level (Spielgeschwindigkeit) w„hrend des Spiels er- h”hen - dies hat keinen Einfluž auf den Startlevel ESC: Spielpause 'E': Abbruch des gerade laufenden Spiels (nicht des Programms!) Ab der Version 1.6 kann die Tastenbelegung (aužer fr die Funktionen Spielabbruch und Spielpause) ver„ndert und sp„ter in der Datei NEWTRIS.CFG gespeichert werden. 4. Belegung der Meneintr„ge Bemerkungen: NEWTRIS.PRG: Die ber die Menleiste erreichbaren Funktionen k”nnen auch durch Tastenkombinationen (CONTROL + Taste (^Taste), ALTERNATE + Taste (Taste) aktiviert werden. So bewirkt z. B. CONTROL + 'P' dasselbe wie das Anklicken des Eintrags 'Play...' (fr TETRIS) im Game-Men. NEWTRIS.ACC: Statt einer Menleiste wird eine Dialogbox (in einem Fenster mit der Titelzeile NEWTRIS) benutzt. Alle Funktionen der Men- leiste sind ber Buttons der Dialogbox erreichbar (aužer bei NEWTRIS.ACC: Quit-Button ist nicht anw„hlbar (graue Schrift; disabled)); eine Funktion wird - wie bei GEM-Dialogboxen blich - durch Anklicken des entsprechenden Buttons aktiviert. NEWTRIS: Info... Eine Kurzinformation ber das Programm wird angezeigt File: Clear Highscores Die Highscorelisten k”nnen gel”scht werden; diese werden aber (noch) nicht gespeichert Save Configuration Die Highscorelisten werden zusammen mit den eingestellten Optionen (z. B. Startlevel), der Tastenwiederholungsein- stellung und der Tastenbelegung in der Datei NEWTRIS.CFG ab- gespeichert; die Datei NEWTRIS.CFG wird in dem Verzeichnis abgelegt, in dem sich das Programm NEWTRIS.PRG (bzw. das Accessory NEWTRIS.ACC) befindet. Also sollte i. a. vor dem Abspeichern die Spieldiskette eingelegt werden! Key Repeat Tastaturwiederholung an/aus Quit Verlassen des Programms; falls sich die Highscoreliste ge„ndert hat und noch nicht gespeichert wurde, wird sie - nach Nachfrage - gespeichert Game: Help... Die Tastaturbelegung wird angezeigt und kann ver„ndert werden; es wird nicht auf Dubletten geprft! Leere Felder werden bei šbernahme mit 'E' belegt. Das Spiel kann immer mit ESC unterbrochen bzw. mit 'E' abgebrochen werden! Erlaubt sind alle Buchstaben, Ziffern und SPACE, sowie die mittels der CONTROL-Taste erreichbaren Zeichen. Fr die Cursortasten mssen folgende Zeichen eingegeben werden: Cursor nach oben: CONTROL + A Cursor nach unten: CONTROL + B Cursor rechts: CONTROL + C Cursor links: CONTROL + D Sowohl fr TETRIS als auch fr COLUMNS gibt es je drei Menein- tr„ge: 'Options...', 'Play...' und 'See Highscores'. Der Eintrag 'Options...' dient zum Setzen der Optionen; einge- stellt werden k”nnen Startlevel, Vorschau an/aus, die Belegung des Schachts zu Spielbeginn (nur TETRIS) und das Aussehen der TETRIS-Objekte. Durch Anklicken von 'Play...' wird das entsprechende Spiel ge- startet. 'See Highscores' zeigt die Highscoreliste des entsprechenden Spiels an. 5. Ver„nderungen gegenber frheren Versionen * Version 1.6: 1. Anpassung an TOS 1.4: Falls TOS 1.4 (oder jnger) vorhanden ist, ermittelt das Pro- gramm NEWTRIS.PRG seinen Aufrufpfad mittels shel_find, indem es sich selbst sucht; das bedeutet, daž man das Programm nicht um- benennen sollte (damit sollten zus„tzlich installierte Programm- endungen (sowie .APP und .TTP) nicht fr dieses Programm ver- wendet werden; im brigen kann ein Virus relativ leicht fest- stellen, ob eine Datei ausfhrbar ist oder nicht - SAGROTAN kann das ja schliežlich auch! Ferner lassen sich die Endungen der ausfhrbaren Programme mit der AES-Funktion shel_get bestimmen - das allerdings drfte fr die Plagegeister nicht gerade einfach sein). Falls sich das Programm nicht selbst findet oder eine „ltere TOS-Version (altes ROM-TOS, Blitter-TOS) vorliegt, wird der aktuelle Pfad als Aufrufpfad benutzt; Maustaste rechts + Doppelklick links in ein gerade nicht aktives Fenster u. „. kann dann dazu fhren, daž einzelne Dateien nicht gefunden werden! 2. Anpassung an beliebige Bildschirmformate Sofern der Platz auf dem Bildschirm fr das Spielfenster aus- reicht, sollte NEWTRIS laufen; in der niedrigen Aufl”sung des ATARI ST ist das Programm jedoch nicht lauff„hig, da nicht ge- ngend Bildschirmfl„che zur Verfgung steht. Der Aufl”sungstest erfolgt nicht mit der XBIOS-Funktion Getrez, sondern mittels VDI und AES (u. a. vq_extnd, wind_get und wind_calc). Auf dem ATARI TT sollte ein Betrieb des Programms in folgenden Aufl”sungen m”glich sein: * ST Mid 640 x 200 * ST High 640 x 400 * TT Mid 640 * 480 * TT High 1280 * 960 3. W„hlbare Tastaturbelegung Die Tasten, mit denen die TETRIS-Objekte gedreht, nach links oder rechts bewegt, fallengelassen, die Vorschau ein- und ausgeschaltet sowie die Spielgeschwindigkeit heraufgesetzt wer- den kann, k”nnen (fast) frei definiert werden: erlaubt sind hierbei alle Buchstaben, Ziffern und Space; diese Einstellungen k”nnen selbstverst„ndlich auch gespeichert werden. * Version 1.7: 1. NEWTRIS l„uft jetzt auch in der niedrigen Aufl”sung des ST (und wahrscheinlich noch in einigen anderen, z. B. TT Low) 2. Die Tastaturwiederholungseinstellung gilt nur fr die Dauer des Spiels * Version 1.8: Programmcodeoptimierung: die Programme sind gegenber der Version 1.7 um ca. 2,5 KByte krzer * Version 1.9: 1. Im monochromen Modus kann zwischen den in frheren Versionen blichen Musterbl”cken (Squares) und Graustufenbl”cken (Grey Shades) gew„hlt werden 2. Im Farbmodus k”nnen entweder 3 oder - sofern verfgbar - 7 Far- ben fr die Objekte verwendet werden 3. Das Highscorefenster kann auch mit der Tastatur bedient werden: - Cursor up: 1 Zeile nach oben - Cursor down: 1 Zeile nach unten - SHIFT + Cursor up: 1 Seite rckw„rts - SHIFT + Cursor down: 1 Seite vorw„rts * Version 1.9a: 1. (Interne) Programmcodeoptimierung 2. Beseitigung einiger Bugs: z. B. funktionieren in der ACC-Version die Buttons 'Key Repeat' und 'Preview' wieder so, wie sie es schon in Version 1.5 taten - n„mlich richtig. In den Versionen 1.8 und 1.9 wurde die Abfrage der Dialogbox auf form_button um- gestellt; dabei hat sich leider ein kleiner Bug eingeschlichen - wohl auch wegen der wenig genauen Dokumentation der Funktion form_button: das AES behandelt den Wechsel von unselektiert nach selektiert und den Wechsel von selektiert nach unselektiert ver- schieden (d. h. die Ausgabeparameter werden bei form_button anders gesetzt)! * Version 2.0: 1. TETRIS und COLUMNS in einem Programm integriert 2. Tastenbelegung: jetzt auch CONTROL-Codes erlaubt; ASCII-Codes 1 - 4 (CONTROL A - D) repr„sentieren die Cursortasten, damit Steuerung mittels Cursortasten m”glich! * Version 2.1: 1. Die meisten Dialogboxen erscheinen an Mausposition. 2. AES-Slider-Problem des Blitter-TOS (TOS 1.2) (1 Klick auf Pfeil oder grauen Bereich, 2 Meldungen!) mittels evnt_multi(MU_BUTTON | other_events, 2, 3, 1, ...) gel”st bzw. l”sbar! (other_events: irgendwelche anderen Ereignisse) Unter TOS 1.2 erscheint direkt nach dem Laden keine Dialogbox mehr. * Version 2.2: Nach dem Start eines Spiels oder bei einer Spielpause sind jetzt der Mauszeiger sichtbar und die Mens nicht gesperrt, andere Prozesse (Hauptprogramm und Accessories) k”nnen weiter be- arbeitet werden: z. B. kann man nun innerhalb einer Textver- arbeitung 5 Minuten Tetris spielen, eine Spielpause einlegen, das Spielfenster schliežen und danach mit dem Tippen fortfahren; das unterbrochene Spiel kann jederzeit - solange die Accs nicht gesperrt sind - fortgesetzt werden. Als 'Abfallprodukt' kann man bei Spielbeginn oder bei einer Spielpause: - Das Spielfenster verschieben. - Das Spielfenster schliežen; dieses kann durch Anklicken des entsprechenden 'Play'-Meneintrags bzw. 'Play'-Buttons wieder ge”ffnet werden. - Einstellungen vornehmen: so kann z. B. die Tastaturbelegung ver„ndert werden. Die Ver„nderungen wirken sich dann - sofern sinnvoll - auf das laufende Spiel aus (Tastaturbelegung, verwendete Bl”cke, Highscore). 6. Sonstiges 1. Falls jemand das Programm auf einem ATARI TT getestet hat, m”ge er mir bitte das Ergebnis dieses Tests mitteilen. 2. Falls jemand grožen Gefallen an dem Programm finden sollte: denken sie an den Autor und honorieren Sie bitte die Mhe, die in diesem Programm steckt! (das gilt natrlich auch fr andere PD-Programme und -Autoren) 3. Feedback ist durchaus erwnscht! Daher sollten Anregungen, Verbesserungsvorschl„ge sowie eventuell auftretende Fehler dem Autor bermittelt bzw. gemeldet werden. Eventuelle Mitteilungen richten Sie bitte an: Alexander Borrmann Agnesstr. 33/442 8000 Mnchen 40 Tel. 089/2714639