     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 Meneintrge
     5. Vernderungen gegenber frheren Versionen
     6. Sonstiges



1. Hinweise zur Benutzung der Programme

   NEWTRIS ist freeware, d. h. die Programme drfen frei kopiert und
weitergegeben werden; Vernderungen an den Programmen oder den zu den
Programmen gehrenden Dateien NEWT_PRG.RSC und NEWTRIS.TXT sind nicht
zulssig. Es mu mindestens der komplette Ordner NEWTRIS weitergegeben
werden; dieser enthlt 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 enthlt (und
welche sie gerade lesen sollten).
Die Weitergabe des (kompletten) Ordners NEWTRIS und des Accessorys
NEWTRIS.ACC im Rootdirectory des Datentrgers (bei Disketten A:\ bzw.
B:\) ist also zulssig!
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 luft (mindestens) in allen ST-Auflsungen auf allen 
ATARI STs; daneben sollte NEWTRIS auch in anderen Auflsungen 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 mglichst spt berluft. Dabei wird 
jede whrend des Spiels komplettierte Reihe von Blcken gelscht, 
womit der freiwerdende Raum fr weitere Objekte genutzt werden 
kann (und verdeckte Lcher wieder frei werden!).
Das gerade 'fallende' Objekt kann nach links und rechts bewegt 
sowie gegen den Uhrzeigersinn gedreht werden, um es besser 
einpassen zu knnen.
Ferner besteht die Mglichkeit, sich das nchste Objekt anzeigen 
zu lassen.

Mgliche 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 knnen die Objekte nach links und rechts
bewegt sowie fallengelassen werden; die Segmente knnen 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) whrend des Spiels er-
          hhen - 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 (auer fr die Funktionen
Spielabbruch und Spielpause) verndert und spter in der Datei
NEWTRIS.CFG gespeichert werden.



4. Belegung der Meneintrge

Bemerkungen:
NEWTRIS.PRG:
          Die ber die Menleiste erreichbaren Funktionen knnen 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 (auer bei
     NEWTRIS.ACC: Quit-Button ist nicht anwhlbar (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 knnen gelscht 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 
          gendert hat und noch nicht gespeichert wurde, wird sie 
          - nach Nachfrage - gespeichert
Game:
     Help...
          Die Tastaturbelegung wird angezeigt und kann verndert
          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-
     trge: 'Options...', 'Play...' und 'See Highscores'.
     Der Eintrag 'Options...' dient zum Setzen der Optionen; einge-
     stellt werden knnen 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. Vernderungen 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 zustzlich 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 schlielich 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 Auflsung des
      ATARI ST ist das Programm jedoch nicht lauffhig, da nicht ge-
      ngend Bildschirmflche zur Verfgung steht. Der Auflsungstest
      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
      Auflsungen mglich sein:
           * ST Mid       640 x 200
           * ST High      640 x 400
           * TT Mid       640 * 480
           * TT High     1280 * 960
   3. Whlbare 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, knnen (fast) frei definiert werden: erlaubt sind
      hierbei alle Buchstaben, Ziffern und Space; diese Einstellungen
      knnen selbstverstndlich auch gespeichert werden.

 * Version 1.7:

   1. NEWTRIS luft jetzt auch in der niedrigen Auflsung 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 Musterblcken (Squares) und Graustufenblcken (Grey
      Shades) gewhlt werden
   2. Im Farbmodus knnen 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 rckwrts
       - SHIFT + Cursor down: 1 Seite vorwrts

 * 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 - nmlich 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) reprsentieren die Cursortasten, damit
      Steuerung mittels Cursortasten mglich!



6. Sonstiges

   1. Falls jemand das Programm auf einem ATARI TT getestet hat, mge
      er mir bitte das Ergebnis dieses Tests mitteilen.
   2. Falls jemand groen 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, Verbesserungsvorschlge 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
