DOKUMENTATION ZUM   B A B - R O U T E N P L A N E R   (Version 1.05)



     **********************************************************************
     *                                                                    *
     *                   B A B - R O U T E N P L A N E R                  *
     *                                                                    *
     *         1992,93,94 by Frank O. Hamm                               *
     *                        Am Wldchen 8                               *
     *                        40882 Ratingen                              *
     *                                                                    *
     *        Internet : frhamm@I1.Informatik.RWTH-Aachen.DE (preferred)  *
     *                                                                    *
     *        MausNet  : Frank Hamm @ W                                   *
     *                                                                    *
     *                                                                    *
     *        Konto-Nr.: 3 121 434 00                                     *
     *        bei      : Dresdner Bank AG Ratingen                        *
     *        BLZ      : 300 800 00                                       *
     *                                                                    *
     **********************************************************************



SHAREWARE
---------

Dieses Programm ist Shareware. Das heit, da jeder das Programm bis zu drei
Wochen lang testen darf. Bis dahin sollte sich jeder von den Strken und
Schwchen des Programms ein Bild gemacht haben. Wer der Meinung ist, da es
sich um ein gutes Programm handelt, das er auch weiterhin nutzen will, zahlt
den lcherlichen Betrag von 20,- DM an mich (Konto-Nr. siehe oben). Alle
anderen lschen das Programm wieder von ihren Datentrgern.

Wer mir auerdem noch das Registrierformular ausgefllt zuschickt, erhlt von
mir - nach Eingang des Geldes auf meinem Konto - einen persnlichen Schlssel
zugesandt. Durch Eingabe desselben in die entsprechende Maske im Programm wird
aus der unregistrierten Version eine registrierte. Anschlieend erscheint z.B.
der Sharewarehinweis nicht mehr.

Zudem erhalten registrierte Benutzer bei Erscheinen einer neuen Version des
Programms eine Mitteilung von mir. Zumindest fr die nchste Version garantiere
ich, da der alte Schlssel auch die neue Version wieder in eine registrierte
umwandelt. Das heit: keine neue Registrierung, keine neue Shareware-Gebhr.
Wer die neue Programmversion nicht aus Mailboxen oder auf andere Weise beziehen
kann, mge sich dann gegebenenfalls mit mir in Verbindung setzen.

Achtung:
Registrierte Benutzer, von denen ich nur die "normale" Postadresse habe, er-
halten nur bei der ersten neuen Programmversion eine Nachricht von mir.
Allerdings knnen Sie mir dann einen an Sie adressierten und ausreichend
frankierten Rckumschlag zusenden. Bei Erscheinen der nchstfolgenden Version
werden Sie diesen dann mit einem entsprechenden Schreiben zurckbekommen.
Registrierte Benutzer, die zudem ihre E-Mail-Adresse angegeben haben, werde
ich bei jeder neuen Version auf diesem Wege unterrichten.


     **********************************************************************
     *                                                                    *
     *  Wer das Programm lnger als drei Wochen benutzt und sich nicht    *
     *  registrieren lt, arbeitet mit einer Raubkopie. Zudem schadet    *
     *  er der Shareware-Idee.                                            *
     *  Das Shareware-Prinzip kann nur funktionieren, wenn sich alle an   *
     *  die Spielregeln halten. Sollte ich negative Erfahrungen mit der   *
     *  Verbreitung dieses Programms als Shareware machen, werde ich in   *
     *  Zukunft wieder Abstand davon nehmen.                              *
     *                                                                    *
     **********************************************************************



Die Weitergabe der unregistrierten Programmversionen ist ausdrcklich er-
wnscht!!! Dabei sind jedoch zwei Spielregeln einzuhalten:

1.) Immer alle Dateien weitergeben. Das sind im einzelnen:
    BAB_1_05.PRG  , das Programm
    BAB_1_05.RSC  , die Resource-Datei
    BAB_1_05.TXT  , dieser Text
    REG_FORM.TXT  , das Registrier-Formular
    BAB_ICON.RSC  , ein Programmicon im RSC-Format
2.) Keine Datei verndern.



HAFTUNG
-------

Das Programm wurde ausfhrlich von mir getestet. Dabei habe ich weder Fehler
noch Schden an Hard- und/oder anderer Software feststellen knnen. Dennoch
kann ich keinerlei Haftung fr eventuelle, aus der Benutzung dieses Programms
entstehende, Schden jedweder Art bernehmen. Die Benutzung dieses Programms
erfolgt somit auf eigenes Risiko.



SYSTEM
------

Das Programm luft nur in der hohen ST-Auflsung. (s. auch: Planungen)
1 MByte Speicher ist leider notwendig. (Wenn ich mir heute berlege, was ich
frher alles mit 48 KByte Hauptspeicher gemacht habe.)
Es sollte mit allen TOS-Versionen zurechtkommen, getestet habe ich es mit
TOS 1.04 und TOS 2.06.
Wer positive oder negative Erfahrungen bei der Zusammenarbeit mit anderer
Hard- und/oder Software macht, mge mir das doch bitte kurz mitteilen (am bes-
ten per E-Mail). Bei Fehlern wrde mir eine mglichst genaue Beschreibung des
Fehlers sicherlich helfen, ihn schnell zu beseitigen.
Merke: genaue Fehlerbeschreibung => schnelle Behebung!


PROGRAMM
--------

Der BAB-Routenplaner ermittelt die krzeste (Autobahn-)Strecke zwischen einem
eingegebenen Startpunkt und einem eingegebenen Zielpunkt.
Das ist eine sehr kurze Beschreibung der Fhigleiten des Programms, denn es
kann noch viel mehr.
Deshalb hier ein kurzer berblick ber alle Menpunkte.

Start-/Zieleingabe:
Es erscheint zunchst eine Maske, in die man fr Start- und Zielort mindestens
einen Buchstaben eingeben mu. Sinnvoll wird es in der Regel erst ab drei oder
mehr Buchstaben. Anschlieend erscheinen in einer weiteren Maske alle Auf-/Ab-
fahrten, Kreuze, Dreiecke etc., die die eingegebene Zeichenkette enthalten.
Dabei wird Gro- und Kleinschreibung nur dann unterschieden, wenn bei der
Eingabe mindestens ein Grobuchstabe eingegeben wurde. Mittels der Pfeil-
tasten kann man nun sowohl den richtigen Startort wie auch den gewnschten
Zielort auswhlen.

Streckenausschlu:
In dieser Maske knnen Strecken angegeben werden, die bei der Routenplanung
nicht benutzt werden sollen. Dies ist insbesondere dann interessant, wenn ge-
wisse Streckenabschnitte gesperrt bzw. durch Staus blockiert sind. Da man fr
die Eingabe jedoch die Streckennummer bentigt, sollte man immer einmal die
Route ohne Streckenausschlu berechnen lassen. Danach kann man alle uner-
wnschten Abschnitte in die Maske eintragen. Die Streckennummern stehen bei
der Ausgabe immer ganz links.

Streckenberechnung:
Nach Anwahl dieses Menpunktes berechnet das Programm die krzeste Entfernung
zwischen Start- und Zielpunkt unter Bercksichtigung der ausgeschlossenen
Streckenabschnitte. Sobald der Mauszeiger wieder die Pfeilform annimmt, kann
man weiterarbeiten. (Die Berechnung kann bis zu einer Minute dauern, was aller-
dings nur sehr selten der Fall ist.)

Streckenausgabe:
Das Programm gibt auf dem ausgewhlten Ausgabegert (s.u.) die zuletzt berech-
nete Strecke aus.
Dabei gibt es einige Besonderheiten:
1.) Knotenpunkte, an denen man auf eine andere Strecke wechseln mu (Wechsel
    der Streckenbezeichnung) sind durch eine horizontale Linie hervorgehoben.
2.) Bei einigen Knotenpunkten steht hinter der Bezeichnung ein *. Dies heit,
    da es sich nicht um einen Standardknotenpunkt handelt. Zumeist kann man
    hier nicht aus jeder Richtung kommend "wenden", also in die Richtung zu-
    rckfahren, aus der man gekommen ist. Ebenso bedeutet der *, da man an
    diesen Knotenpunkten verstrkt auf die Beschilderung achten sollte, da die
    Verknpfung etwas unbersichtlich ist.
3.) Einige Knotenpunkte haben hinter der Bezeichnung noch in Klammern eine
    Zahl stehen. An diesen Knotenpunkten kann man nicht aus jeder Richtung
    kommend in jede Richtung weiterfahren. Damit das Programm auch wirklich
    nur solche Routen berechnet, die auch tatschlich gefahren werden knnen,
    war dies ntig. Die hchste Anzahl an "verschiedenen Knoten im gleichen
    Knotenpunkt" findet man brigens am Autobahnkreuz Wuppertal-Nord. Wer Lust
    hat, kann sich ja mal Gedanken darber machen, wieviele es sein mssen.
Wenn man als Ausgabemedium den Bildschirm gewhlt hat (Standard), kann man
das GEM-Fenster sowohl per Maus wie auch per Tastatur bedienen. Die Mausbe-
dienung entspricht dem Standard. Bei der Tastatur scrollen Up-/Down-Pfeil je-
weils um eine Seite hoch bzw. runter. Mit der ESC-Taste schliet man das Fen-
ster.

Ausgabemedium:
In der Dialogbox kann man das gewnschte Ausgabemedium auswhlen.
Die Ausgabe auf Diskette (Diskette steht auch fr Platte...) ist nur mglich,
wenn das Programm registriert ist. Bei der unregistrierten Version erscheint
ein entsprechender Hinweis.

Druckeroptionen:
Hier kann man einige Optionen bei der Druckerausgabe einstellen. Die Sachen
sollten eigentlich selbsterklrend sein. Ansonsten: probieren.
Allgemein ein Wort zum Drucker:
Alle Steuerbefehle entsprechen dem ESC/P-Standard. Vor Beginn der Ausgabe wird
mittels ESC R 2 der deutsche Zeichensatz eingestellt. Das "" wird bei der
Ausgabe entsprechend gewandelt und richtig ausgegeben.

Ende:
Mu ich dazu noch was sagen?

Info:
Es erscheinen nacheinander zwei Info-Seiten.

Registrierung:
Dieser Punkt ist nur bei unregistrierten Versionen whlbar. Nach Aufruf
erscheint eine Maske, in die man den eigenen Namen und den von mir mitgeteilten
Schlssel eintragen kann. Beim Schlssel sind fhrende Nullen mit einzugeben.
Nach Anklicken von OK wird das Programm kurze Zeit spter automatisch beendet.
----> Achtung: 1) Sollten Sie einen falschen Schlssel eingegeben haben, werden
                  Sie das Programm leider nicht mehr zum Laufen bringen.
                  Kontrollieren Sie deshalb Ihre Eingabe sorgfltig. Behalten
                  Sie eine Kopie der unregistrierten Version.
               2) Beachten Sie auch die Hinweise, die ich Ihnen mit Ihrem
                  Schlssel mitteile.


STRECKEN
--------

Das Programm enthlt (fast) alle Autobahnauf- und -abfahrten, Kreuze, Dreiecke
etc. sowie die Strecken zwischen ihnen. Daneben sind noch einige Bundesstraen
und innerstdtische Verbindungen enthalten. Diese berbrcken Lcken im Bundes-
autobahnnetz. Ansonsten wrde z.B. die Route von Mnchen-West (Autobahnende A8)
nach Mnchen-Schwabing ber Ulm, Feuchtwangen/Crailsheim und Nrnberg fhren.
Die Auswahl dieser Zusatzstrecken ist sicherlich etwas willkrlich erfolgt.
Wer hier Verbesserungs- und/oder nderungsvorschlge hat, mge mir diese doch
bitte mitteilen.

Leider ist es mir noch nicht gelungen, irgendwo eine Karte aufzutreiben, aus
der man die Streckenlngen im Autobahnnetz wirklich exakt erhlt (mglichst auf
den Meter genau). Wer mir eine solche Liste (kostenlos) besorgen kann, erhlt
von mir ohne Zahlung der Shareware-Gebhr eine registrierte Version des Pro-
gramms. Aber auch fr Hinweise auf eine solche Karte bzw. Datensammlung bin ich
immer dankbar.

Da das deutsche Fernstraennetz stetig erweitert wird, sind natrlich die Daten
dieses Programms quasi permanent veraltet. Um dem abzuhelfen, rufe ich dazu
auf, mir alle, nicht in diesem Programm enthaltenen, Strecken umgehend mitzu-
teilen. Ebenso bitte ich um Hinweise auf Fehler in der Datenbasis (falsche
Streckenlngen, falsche Bezeichnungen etc.).


GESCHICHTE
----------

Irgendwann einmal nervte mich die ewige Streckenkilometeraddiererei, wenn ich
nur annhernd wissen wollte, wie lang eine bevorstehende Fahrt sein wrde. Was
lag also nher, als ein Programm zu schreiben, das diese Arbeit bernahm. Aber
wenn schon Programm, dann bitte richtig. Das Programm sollte also die krzeste
Strecke zwischen zwei Punkten selbst finden und diese dann ausgeben. Natrlich
braucht der verwhnte Benutzer eine Einbindung in eine graphische Benutzerober-
flche. Somit war das Programmkonzept umrissen. Spter kam noch die Idee mit
dem Streckenausschlu hinzu.

Die erste Testversion (1.01) stand Mitte 1992. Allerdings war der Datenbestand
noch etwas klglich. Das nderte sich mit der Version 1.02, die Ende 1992
fertig war. In der Version 1.03 habe ich dann noch einige kleine Fehler ver-
bessert. Diese Version war seit Anfang 1993 bei mir im Einsatz und hat mir gute
Dienste geleistet. Diese Version wurde stetig verbessert und verfeinert.
Mit der Version 1.04 wollte ich die Verbreitung meines Programms starten.
In der Version 1.04 ist die Datenbasis jetzt Bestandteil des Programms. Bis
zur Version 1.03 war dies eine eigenstndige Datei. Da jedoch kleine nderungen
an den Daten fatale Folgen haben konnten und immer noch haben knnen, entschlo
ich mich, die Daten in das Programm zu integrieren, wo eine bewute oder
unbewute Vernderung unwahrscheinlicher ist. Ich warne davor, hier nderungen
vorzunehmen. Auerdem sind in die Version 1.04 einige Sicherheitsabfragen
eingebaut worden, die bei einem Privateinsatz nicht ntig waren. (Meine
Hardware kenne ich ...) Auerdem war in 1.04 die Ausgabe auf Datentrger noch
nicht mglich.
Da aber erstens alles anders kommt und zweitens als man denkt, wurde aus der
Verbreitung der Version 1.04 nichts. Das Prinzip, eine unregistrierte Version
zu verbreiten, und allen, die eine Registrierung wnschen, eine entsprechende
Version per Diskette zukommen zu lassen, erschien mir dann doch ein wenig zu
umstndlich. Also bastelte ich, hackte und grbelte ber unverstndlichen
Fehlern des Compilats, bis schlielich die Version 1.05 rauskam. Diese ist
jetzt quasi eine doppelte Version.


PLANUNGEN
---------

Zunchst einmal soll eine Anpassung an andere Auflsungen erfolgen. Wenn ich
mal wieder etwas mehr Zeit habe, werde ich wohl auch noch eine graphische
Streckenausgabe einbauen.
Um dies zu realisieren, werde ich vermutlich schon bei der nchsten Version die
Ausgabe mittels GDOS implementieren.

Ebenso plane ich eine Option einzubauen, die die Vorgabe von festen Strecken-
punkten ermglicht (die berhmte Handelsreisende-Aufgabe).

Daneben wird natrlich permanent die Datenbasis gepflegt und erweitert, wobei
Erweiterung sowohl weitere Strecken (Bundesstraen etc.) innerhalb Deutsch-
lands als auch Fernstraen in den europischen Nachbarlndern meint.

Prinzipiell ist es mit dem Programm auch mglich, eine zeitoptimierte Strecke
zu berechnen. Allerdings halte ich hiervon wenig, da die dafr zu hinterlegen-
den Durchschnittswerte fr die einzelnen Streckenabschnitte einer viel zu
groen Schwankung unterliegen. (Im Berufsverkehr habe ich ganz andere Werte als
an einem Sonntag gegen 20.00 Uhr). Selbst wenn man dies auch noch bercksichti-
gen wrde, wren auergewhnliche Ereignisse (Groveranstaltungen, Baustellen,
Ferien etc.) immer noch nicht in das Ergebnis einbezogen. Deshalb wird es eine
solche Funktion zumindest solange nicht geben, bis mich irgendjemand vom
Gegenteil berzeugt hat.


ANREGUNGEN / KRITIK ...
-----------------------

Fr Anregungen, Kritik und Hinweise auf Fehler bin ich stets dankbar. Die
bequemste Mglichkeit mit mir Kontakt aufzunehmen, ist E-Mail.


WARENZEICHNEN
-------------

Es sei darauf hingewiesen, da fast alle Soft- und Hardwarebezeichnungen, die
ich in diesem Text erwhnt habe, eigetragene Warenzeichen sind. Sie sollten als
solche betrachtet werden.



Ratingen, den 08. April 1994

