                           Die Anleitung zu

                              Little 15

                             Version 2.0
                          8. September 1995

                                 von

                            Dirk Hagedorn
                           In der Esmecke 9
                           D-59846 Sundern

                     MausNet: Dirk Hagedorn @ MK2



Inhaltsverzeichnis
==================

 1 Einfhrung
   1.1 Willkommen zu Little 15!
   1.2 Play it again, GEM!
   1.3 Fairware
   1.4 Systemvoraussetzungen
   1.5 Installation
       1.5.1 Installation als Programm
       1.5.2 Installation als Accessory

 2 Die Mens

 3 Die Dialoge
   3.1 Der Hauptdialog
   3.2 Dialog `ber Little 15'

Anhang
======

 A Rechtliche Informationen
   A.1 Copyright
   A.2 Haftungsausschlu
   A.3 Warenzeichen

 B Bezugsquellen

 C SysGem



1 Einfhrung
============


1.1 Willkommen zu Little 15!
----------------------------

Little 15 ist eine GEM-Umsetzung eines kleinen Geduldspiels, welches
jeder sicherlich schon einmal irgendwann in den Hnden gehalten hat.

Es geht darum, auf einem 4 x 4 groen Spielfeld 15 Spielsteine in die
richtige Reihenfolge zu bringen. Dabei bewegt man einfach einen an
das freie Feld grenzenden Stein auf das freie Feld.

Seit der Version 2.00 wird auch der C-Quelltext von Little 15 fr
Pure-C und die GEM-Library SysGem2 mitgeliefert, damit man einmal zu
sehen bekommt, wie leicht die Programmierung eines sauberen GEM-
Spiels mit SysGem ist.

Erschrecken Sie bitte nicht ob der Gre des Quelltextes, denn ein
nicht geringer Teil behandelt die Darstellung der Info-Dialoge. Die
interessansten Teile des Quelltextes sind sicherlich die Routinen
open_game, handle_game, draw_field. Alles andere ist nur langweiliger
Krempel. ;-)

Vielleicht animiert Sie dieser Quelltext ja, auch einmal ein GEM-
Spiel zu schreiben. Falls Sie dann auf die SysGem-Library zurckgrei-
fen, knnen Sie sicherlich viele Routinen direkt bernehmen und nur
kleine Anpassungen vornehmen.


1.2 Play it again, GEM!
-----------------------

Little 15 ist ein Spiel aus der "Play it again, GEM!"-Reihe und zeich-
net sich (wie alle anderen Spiele der Reihe) dadurch aus, da es kon-
sequent aktuelle GEM-Standards beachtet, als da wren

    Dialog- und Alertboxen in Fenstern,

    Lauffhigkeit unter jedem GEM-Betriebssystem, also TOS, Multi-
     TOS, MagiC, MagiCMac sowie Geneva,

    Lauffhigkeit unter allen Auflsungen ab 640 x 400 Punkten mit
     beliebiger Farbtiefe (natrlich auch auf Grafikkarten),

    nahezu vollstndige Bedienung via Tastatur mglich,

    Untersttzung von MultiTOS- und ICFS-Ikonifizierung,

    Untersttzung des VA-Protokolls (soweit mglich und sinnvoll),

    Untersttzung des Hypertextsystems ST-Guide

In der "Play it again, GEM!"-Reihe sind bisher (Stand: 08.09.1995)
erschienen:

+----------------------------------------------------------------+
| Name              | Version | Status    | Preis | Archiv       |
|-------------------+---------+-----------+-------+--------------|
| DWBH              | 1.02    | Shareware | 15 DM | DWBH102.LZH  |
| MoveIt            | 1.50    | Shareware | 10 DM | MOVIT150.LZH |
| Nanjing           | 1.1     | Shareware | 15 DM | NANJIN11.LZH |
| Tricky            | 2.71    | Shareware | 15 DM | TRICK271.LZH |
|-------------------+---------+-----------+-------+--------------|
| Invers            | 1.0     | Fairware  |  0 DM | INVERS10.LZH |
| Little 15         | 2.0     | Fairware  |  0 DM | LITT_200.LZH |
| Magisches Quadrat | 1.0     | Fairware  |  0 DM | MAGQUA10.LZH |
| Solitaire         | 1.5     | Fairware  |  0 DM | SOLIT15.LZH  |
| 3D-Lab            | 0.1     | Fairware  |  0 DM | 3DLAB010.LZH |
+----------------------------------------------------------------+


1.3 Fairware
------------

Little 15 ist Fairware!

Sollte Ihnen Little 15 gefallen, so wird Ihnen nahegelegt, dem Autor
eine kleine Spende (so um die 10 DM) zukommen zu lassen. Sollten Sie
sich, trotz der Tatsache, da Ihnen Little 15 gefllt, nicht zu einer
Spende hinreien lassen, so seien Sie bitte wenigstens so fair, und
teilen Sie dem Autor per Brief, Postkarte oder eMail mit, da Ihnen
Little 15 gefllt.

    Spenden bitte per Bankberweisung auf das Konto...

         Dirk Hagedorn
         Kontonummer 3 561 164
         BLZ 466 500 05
         Sparkasse Arnsberg-Sundern

     Denken Sie bitte daran, auf dem berweisungsformular Ihren Na-
     men, Ihre Anschrift sowie "Little 15" als Stichwort anzugeben,
     damit ich spter auch wei, warum ich auf einmal unermelichen
     Reichtum erlangt habe. ;-)

    oder als Bargeld oder als Verrechnungsscheck an...

         Dirk Hagedorn
         In der Esmecke 9
         59846 Sundern
         Deutschland

Allen freundlichen Spendern mchte ich mich im Voraus sehr herzlich
bedanken!


1.4 Systemvoraussetzungen
-------------------------

Fr den Einsatz von Little 15 bentigen sie einen atari-kompatiblen
Rechner mit einem tos-kompatiblen Betriebssystem und eine Auflsung
von mindestens 640 x 400 Punkten; die Farbtiefe spielt keine Rolle.

Little 15 luft auch in niedrigeren Auflsungen, allerdings kann ich
nicht versprechen, da die Dialoge dann auf den Bildschirm passen
oder die verwendeten Images und Icons die korrekten Ausmae besitzen.

Um an die Mglichkeit der Ikonifizierung zu gelangen, bedarf es entwe-
der der AES mit einer Versionsnummer grer oder gleich 4.1 (solche
AES bieten MultiTOS ab Version 1.07 sowie MagiC ab Version 3.0) oder
eines installierten ICFS (Iconifying Server).

Um in den Genu der Onlinehilfe zu gelangen, mssen die den ST-Guide
installieren. Wie dies funktioniert, das entnehmen Sie bitte der
Anleitung zum ST-Guide.


1.5 Installation
----------------


1.5.1 Installation als Programm

Die Installation gestaltet sich sehr einfach. Kopieren Sie einfach
alle zu Little 15 gehrende Dateien in einen beliebigen Ordner.

Falls Sie ein Freund des Hypertextsystems ST-Guide sind, so kopieren
Sie die Dateien mit den Endungen .HYP und .REF in den Ordner, in dem
Sie alle anderen Hypertexte gesammelt haben. Dann steht Ihnen die
komplette Anleitung zu Little 15 jederzeit zum Abrufen bereit.


1.5.2 Installation als Accessory

Hierzu benennen Sie die Programmdatei mit der Endung 'APP' in 'ACC'
um und kopieren sie in das Wurzelverzeichnis Ihres Bootlaufwerks bzw.
in den Ordner, in dem sich alle anderen Accessories befinden.

Um Little 15 nun als Accessory verfgbar zu haben, mssen Sie nach
dem Kopieren zunchst Ihren Rechner neu booten.



2 Die Mens
===========

*Das Spiel-Men*

 Neu:        Startet gem den Einstellungen im Optionen-Men ein
             neues Spiel.

 Info:       ffnet den Dialog `ber Little 15'

 Hilfe:      Der ST-Guide wird aufgefordert, den Hypertext zu Little
             15 anzuzeigen.

 Beenden:    Little 15 wird nach Abfrage beendet. Beim Betrieb als
             Accessory werden lediglich alle Fenster geschlossen.

*Das Optionen-Men*

 Zahlen:     Beim Start eines neuen Spiels werden mit Zahlen beschrif-
             tete Spielsteine verwendet.

 Buchstaben: Beim Start eines neuen Spiels werden mit Buchstaben
             beschriftete Spielsteine verwendet.

 Der Rest:   Hier stellen Sie die Schwierigkeitsstufe ein. Je hher
             diese Schwierigkeitsstufe, desto fter werden die Spiel-
             steine beim Start eines neuen Spiels hin- und
             hergeschoben.



3 Die Dialoge
=============


3.1 Der Hauptdialog
-------------------

Der Hauptdialog ist aufgeteilt in die Menzeile und das Spielfeld.
Die Bedeutung der Menzeile wurde im vorherigen Kapitel bereits
beschrieben.

Im Spielfeld sehen Sie die Spielsteine, die je nach den Einstellungen
im Optionen-Men mit Zahlen oder Buchstaben beschriftet sind. Klicken
Sie an das freie Feld grenzenden Spielstein an, um


3.2 Dialog `ber Little 15'
---------------------------

In diesem Dialog sehen sie genauere Informationen bezglich der Ver-
sionsnummer und des Erstellungsdatums dieses Programms. Desweiteren
erkennt man den Namen der Person, auf die dieses Programm registriert
wurde.

Durch Auswahl des Buttons Rechtliches wird der Dialog `Rechtliche
Informationen' geffnet, in dem man in einer Kurzform die Dinge fin-
det, die man bei der Weitergabe dieses Programms beachten mu.

Whlt man den Button Autor, so ffnet sich der Dialog `Autor' mit
weiteren Informationen zu - na wem wohl - dem Autor dieses Programms.




A Rechtliche Informationen
==========================


A.1 Copyright
-------------

Die Rechte an der Dokumentation sowie dem Softwareprogramm Little 15
liegen bei Dirk Hagedorn Software.

Little 15 darf auf beliebige nichtkommerzielle Weise an Dritte weiter-
gegeben werden, wenn alle folgenden Voraussetzungen erfllt werden:

    Das Programm darf generell nur kostenlos weitergegeben werden.
     Der Upload in gebhrenfreie Mailboxen ist ausdrcklich erwnscht
     und erlaubt.

    Fr die Weitergabe auf Disketten im Rahmen einer Public-Domain-
     Serie drfen keine Gebhren verlangt werden, die einen Betrag
     von 10 DM (exklusive Versandkosten) berschreiten.

    Die Weitergabe dieses Programms als Beigabe zu einer kommerziel-
     len Software ist dann gestattet, solange dem Kunden keine zustz-
     lichen Kosten entstehen.

    Die Weitergabe per CD-ROM bedarf meiner schriftlichen
     Genehmigung.

    Dem Archiv drfen keine weiteren Dateien hinzugefgt werden,
     insbesondere keine Mailboxwerbung und keine Werbung fr PD-
     Serien.

    Das Programm darf nur mit allen zugehrigen Dateien und in unver-
     nderter Form weitergegeben werden.


A.2 Haftungsausschlu
---------------------

Trotz sorgfltiger Entwicklung und umfangreichen Tests kann keine
Gewhrleistung fr die Richtigkeit des Inhalts dieser Dokumentation
und die einwandfreie Funktion von "Little 15" bernommen werden.

Dirk Hagedorn Software kann keine Haftung fr irgendwelche direkten
oder indirekten Schden - einschlielich aber nicht beschrnkt auf
materielle oder finanzielle - bernehmen, die durch die Benutzung von
"Little 15" oder dessen Untauglichkeit fr einen bestimmten Zweck
entstehen.


A.3 Warenzeichen
----------------

Innerhalb dieser Dokumentation wird auf Warenzeichen Bezug genommen,
die nicht explizit als solche ausgewiesen sind. Aus dem Fehlen einer
Kennzeichnung kann nicht geschlossen werden, da ein Name frei von
den Rechten Dritter ist.



B Bezugsquellen
===============

Die jeweils aktuelle Version von Little 15 ist beim Autor gegen Ein-
sendung einer formatierten Diskette sowie eines adressierten und mit
2 DM frankierten Rckumschlags erhltlich.

Besitzer eines Modems finden die aktuelle Version dieses Programms in
der Maus MK2 (02371-944925) im ffentlichen Programmteil.

Der Archivname lautet jeweils "LITT_???.LZH", wobei "??" durch die ak-
tuelle Versionsnummer ersetzt wird.

Auf jeweils neue Versionen wird in der MausNet-Gruppe "ATARI.NEWS"
hingewiesen.



C SysGem
========

SysGem von Andreas Pietsch ist eine leistungsfhige GEM-Library fr
Pure-C. Trotz Ihrer Leistungsfhigkeit ist sie sehr leicht zu handha-
ben. Sie sich als C-Programmierer einmal anzuschauen, lohnt sich
wirklich.

Aktuelle Versionen liegen immer in der Maus WI2, der Heimatbox von
Andreas Pietsch. Der Archivname lautete SGEM200C.LZH fr die Version
2.00.




                    Dieser Text wurde erzeugt mit
                                   
                                 UDO
                                   
                              Release 4
                           (Atari-Version)
                                   
                        Copyright (c) 1995 by
                        Dirk Hagedorn Software
                           In der Esmecke 9
                           D-59846 Sundern
                     MausNet: Dirk Hagedorn @ MK2
                                   
                                   
        UDO ist ein Programm, welches Textdateien, die in der
          eigenen UDO-Syntax erstellt wurden, in das ASCII-
        ST-Guide-, LaTeX-, Rich Text-, Pure-C-Help-, 1stWord-,
               HTML- und WinHelp-Format umwandeln kann.


