++++++++++ Readme zu WayFinder ++++++++++


WayFinder - ein sehr einfallsreicher Name - ist eine Art Knobelspiel - nur dass das Knobeln hier der 
Computer bernimmt. Es gilt, mglichst viele Wege durch ein Labyrinth aus Feldern zu finden. Was mit 
bloem Auge leicht nachzuvollziehen ist, ist fr den Computer harte Knochenarbeit; und darum ging es
bei diesem Programm fr mich: Nachzuvollziehen, dass Vorgnge, die fr den Menschen selber so einfach 
erscheinen, in Wirklichkeit hochkomplexe Vorgnge sind - wir nur nichts davon merken.


WayFinder wurde in freeBASIC Version 0.13b programmiert.



1. Allgemeine Hinweise zu WayFinder

   WayFinder wurde fr den Deutschen QuickBASIC Programmierwettbewerb programmiert, und ist folglich Freeware.
   Jeder, der Spa daran hat, kann das Programm beliebig oft verwenden, verschenken und kopieren.
   
   Ich fnde es jedoch schn, wenn der Quellcode und mein Name dabei nicht verndert wrden, und diese Readme
   zusammen mit dem Programm weitergegeben wrde.



2. ber WayFinder und seine Funktionen


   - Aufbau der Felder
     
     Die Felder haben ihren Ursprung (1|1) oben links, hnlich dem Graikkoordinatensystem von QuickBASIC & freeBASIC.
     Die x-Achse ist - dem Programmierer wohl bekannt - die horizontale Seite, die y-Achse wird von der vertikalen 
     Seite reprsentiert.


   - Um das Programm nicht zu monoton werden zu lassen, bietet WayFinder 3 Unterfuntionen: 
    
           1. Die Funktion "Zufllig generiertes Feld erstellen"
              Hier wird ein zuflliges Feld erstellt; Sie knnen lediglich die Gre und Breite des Feldes bestimmen.
              Der zulsige Maximalwert fr sowohl Hhe als auch Breite betrgt 100. WayFinder beginnt nun, Wege von 
              oben nach unten zu suchen. Ist die Suche abgeschlossen, werden Sie ber das Ergebnis der Suche informiert, 
              und knnen - sollten Wege gefunden worden sein - diese von WayFinder in einer Datei abspeichern lassen. 
              Diese Datei finden Sie im Unterverzeichnis "Felder". Die Datei wird im Textdormat erstellt, es empfiehlt 
              sich daher die Endung .TXT. Ein anderer Speicherort ist nicht mglich. Um sich den Aufbau einer solchen
              Datei anzusehen, knnen Sie die Datei sample.TXT im Unterverzeichnis "Felder" verwenden.
              
           2. Sie knnen auch, wenn Ihnen die zufllig generierten Felder nicht gefallen, eigene Felder erstellen.
              Dazu gibt es die Unterfunktion "Eigenes Feld erstellen". Mit Hilfe ihrer knnen Sie die Gre des Feldes
              whlen - wie schon bei der Funktion "Zufllig generiertes Feld erstellen" - aber hinzu kommt die 
              Mglichkeit, jedes einzelne Kstchen des Feldes bearbeiten zu knnen. Mit Hilfe der Tasten W und Q knnen 
              Sie die Gre des Feldes in x-Richtung hin variieren; fr die nderung der y-Achse sind die Tasten A und S
              vorgesehen. Die zulssige Maximalgre betrgt auch hier fr sowohl die Breite als auch die Hhe 100 Ksten. 
              Wenn Ihnen das Feld nicht gefllt, knnen Sie seinen gesamten Inhalt kurzerhand mit der Tastenkombination 
              Strg + L lschen. Das Gegenstck exisistiert auch; mit der Tastenkombination Strg + F fllen Sie das gesamte 
              Feld. Mit den Pfeiltasten bewegen Sie den Cursor; mit Enter fllen Sie den ausgewhlten Kasten, mit 
              Backspace leeren Sie ihn. Wenn Ihnen das Feld gefllt wie es ist, knnen Sie es mit der Tastenkomnination 
              Strg + S abspeichern. Als Dateinamen mssen Sie lediglich einen Namen angeben; das Feld wird automatisch 
              mit der Dateiendung .way im Unterverzeichnis "Felder" von WayFinder gespeichert. Ein anderer Speicherort 
              ist auch hier nicht mglich.
             
           3. Um Ihr soeben abgespeichertes Feld zu laden, knnen Sie es in der Befehlszeile hinzufgen (siehe unten), 
              oder die Funktion "Eigenes Feld laden" nutzen.  Hierbei geben Sie lediglich den Dateinamen an, und das 
              Feld wird geladen, und auf einen Tastendruck wird der Weg gesucht. Dieses Feld muss im Unterordner "Felder"
              liegen. Es exisitert ein einfaches vorgefertigtes Feld namens sample, dass Sie mir dieser Option laden 
              knnen.
                

   - Kommandozeile 

     WayFinder kann manuell bedient werden oder aber ber die Kommandozeile angesteuert werden. 
     Die Syntax fr die Kommandozeile ist ziemlich einfach:

       /f               Vollbild

       /w Dateiname     Dateiname des Feldes, das nach Wegen durchsucht werden soll. Der Dateiname ist der Name des 
                        Feldes *ohne* Endung und *ohne* Pfadangabe. Die entsprechende Datei muss sich im Unterverzeichnis
                        "Felder" befinden.
                        Bsp: WayFinder.exe /w sample
                        Dieses Beispiel ldt das Feld sample.way.

     Bitte versuchen Sie keine anderen Kombinationen; WayFinder hat zwar eine Fehlererkennungsroutine fr die 
     Kokandozeile eingebaut, aber es ist mglich, dass WayFinder aufgrund einer fehlerhaften Kommandozeile
     auch fehlerhaft arbeitet.



3. Abschlieende Worte:

   Ich wei nicht, ob der Suchalgorhythmus zu Jedermanns Zufriedenstellung arbeitet; es ging mir beim Programmieren nicht
   darum, einen Suchalgorhythmus zu schreiben, der *alle* Wege findet. Ich kann jedoch mit Stolz behaupten, dass WayFinder
   - *sollte* ein Weg existieren - diesen auch findet, und darum ging es mir dabei.

   Wenn Sie noch Fragen haben, die ich mit dieser Readme nicht klren konnte, schreiben Sie eine Nachricht an 

   jb
   www.qb-forum.de

   Und nun: Schaffen Sie es, WayFinder auszuztricksen? Viel Spa dabei!

   Jens Boos