

Dieses Dokument beschreibt den Umgang mit `Amiga Route' 1.00.  `Amiga
Route' ist ein ShareWare Streckenplanungs-Progamm für den Amiga.

Einleitung
**********

`Amiga Route' ist ein ShareWare Streckenplanungs-Programm für den
Amiga.  Es richtet sich an alle Auto- und Motorradfahrer und an die,
die es noch werden wollen.

`Amiga Route' sucht die kürzeste und schnellste Straßenverbindung
zwischen zwei Städten.

Die Strecken beruhen zu einem grossen Teil auf den Daten des Programms
`RoadRoute' von Jim Butterfield u. Günther Kirrbach.

Features
========

   * `Amiga Route' berechnet die kürzeste und die schnellste Route.

   * `Amiga Route' zeigt die Route sowohl tabellarisch als auch
     grafisch an.

   * Die Durchschnittsgeschwindigkeiten können für jeden Straßentyp
     eingestellt werden.

   * Verschiedene Detailstufen in der Karte.

   * Anzeige von Informationen zu Orten in der Karte.

   * `Amiga Route' besitzt eine Style-Guide konforme
     Benutzeroberfläche.

   * Online-Dokumentation im AmigaGuide Format.

   * Umlenkung des `Amiga Route' Screens auf Grafikkarten möglich.
     Die Karte passt sich automatisch der Auflösung des Screens an.

Folgende Features sind nur in der Vollversion enthalten

   * Ausdruck der Strecke als Tabelle oder als Karte.

   * Orts- und Straßendaten können bearbeitet und ergänzt werden.

   * Voreinstellungen können abgespeichert werden.

   * Ausführlicheres Handbuch :^).

Disclaimer
**********

Das Programm `Amiga Route' unterliegt dem Urheberrechts-Schutz.  Der
Autor übernimmt keine Haftung fuer Schäden die durch das Programm
entstehen. Die frei kopierbare Version des Programms darf nur in Form
des Orginal-Archivs weitergegeben werden. Sämtliche Dateien müssen
unverändert bleiben.  Das Programm darf nicht auf FD-Disketten
veröffentlicht werden, die für mehr als DM 8,- vertrieben werden.
Falls Sie `Amiga Route' auf ihrer FD-Serie veröffentlichen, bitte ich
sie mir eine Kopie der Disk zu senden.

Die Vollversion von `Amiga Route' ist nicht frei kopierbar.  Jede
Vervielfältigung, die nicht dem Anlegen einer persöhnlichen
Sicherheitskopie dient, wird strafrechtlich verfolgt.

Anforderungen
*************

`Amiga Route' lauft auf allen Amigas mit OS 2.04 aufwärts mit
mindestens 1MB *freiem* Speicher.  Eine Festplatte ist nicht unbedingt
erforderlich, aber ein Prozessor >= 68020 ist *sehr* zu empfehlen.

Die mathieeedoubtrans.library muß sich im LIBS: Ordner befinden.
Weiterhin benötigt `Amiga Route' den Font Helvetica.

Das Programm wurde auf folgenden Konfigurationen getestet:

   * Amiga 2000 ohne Turbokarte mit 3MB RAM (langsam)

   * Amiga 2000 mit A2630 und 5MB RAM (gutes Arbeiten)

   * Amiga 2000 mit A2630 und PicassoII-Grafikkarte

   * Amiga 3000 mit Retina-Grafikkarte

   * Amiga 4000/030

   * Amiga 4000/040

Installation
************

Einfach das Programm mit den zugehörigen Dateien in ein Verzeichnis
entpacken, fertig.

Die Registrierung
*****************

Bei dem Programm `Amiga Route' handelt es sich um ShareWare, Sie
können die FD-Version beliebig verwenden oder kopieren und weitergeben,
solange Sie den Disclaimer beachten (siehe Disclaimer).  Sollte Ihnen
dieses Programm gefallen, so können Sie sich für 40 DM beim Autor
registrieren lassen.  Füllen Sie dazu bitte das Registrierungsformular
aus. Sie können das Formular im Programm ausfüllen und ausdrucken
(siehe Registrierung) oder die Datei *Register.form* benutzen. Auf dem
Formular finden sie auch meine Kontonummer.

Senden Sie das Formular bitte an meine Adresse (siehe Der
Programmierer).  Sie erhalten dann umgehend die neuste Vollversion von
`Amiga Route' zugesandt. Sehen Sie bitte davon ab, mir Geld oder
Schecks direkt per Post zu senden, denn das ist leider eine unsichere
Methode.

Die Weiterentwicklung von `Amiga Route' hängt auch von der
Registrierungsbereitschaft der Anwender ab.

Programmstart
*************

`Amiga Route' läßt sich von der Workbench und vom Cli starten. Beim
Start öffnet `Amiga Route' einen eigenen Screen.  Beim Start von der
Workbench kann das Programm auch NONINTERLACED gestartet werden.
Dafür ist im Programm-Icon das Tooltype INTERLACE=ON in INTERLACE=OFF
zu ändern.

Nach dem Start dauert es einen Moment, bis die Orte und Routen geladen
worden sind. Sie befinden sich nun im Hauptfenster.

Fenster und Requester
*********************

Das Hauptfenster
================

Nach dem Start befinden Sie sich im Hauptfenster von `Amiga Route' Im
Listview in der Mitte des Hauptfensters wird die aktuelle Route
tabellarisch dargestellt. Darunter werden Start- und Zielort, sowie die
Entfernung in Kilometern und die Zeit in Minuten angezeigt. Oberhalb
der Routen-Liste befinden sich die die Schalter (Gadgets) zur
Programmbedienung.  Mit der rechten Maustaste können Sie das Menü des
Hauptfensters bedienen.

Neue Route
----------

Im erscheinenden Requester können Start- und End-Ort sowie ein Wegpunkt
("Über"-Ort) eingegeben werden. Start- und End-Ort müssen eingegeben
werden, der Wegpunkt kann weggelassen werden. Falls die Schreibweise des
Ortsnamens nicht genau bekannt ist, kann auch nur der Anfang des Namens
eingegeben werden. Es erscheint dann ein Auswahlrequester mit der Liste
aller Ortsnamen mit diesem Präfix.

Druck
-----

Die Route wird tabellarisch als Text ausgedruckt.  (Der Druck erfolgt
über den Workbench - Druckertreiber)

Nur in der Vollversion möglich!

Karte
-----

Es öffnet sich das Fenster mit der Übersichtskarte (siehe Die Karte).

Registrierung
-------------

Es erscheint ein Requester, in dem Name und Adresse eingegeben werden
können. Durch Anklicken von Druck wird dann ein Registrierungsformular
ausgedruckt(siehe Die Registrierung).

Art der Route
-------------

Hiermit können sie zwischen der kürzesten und der schnellsten Strecke
umschalten.

Ende
----

Programmende

Daten freigeben
---------------

Alle Orte und Straßen werden aus dem Speicher entfernt.  Danach
können Sie neue Daten laden.

Nur in der Vollversion möglich!

Daten laden
-----------

Hiermit können Sie neue Daten laden.

Nur in der Vollversion möglich!

Daten speichern
---------------

Mit diesem Menüpunkt ist es möglich, geänderte Orts- und
Straßendaten abzuspeichern. Die alten Dateien erhalten die Endung .bak,
sodaß diese durch Umbennen in .txt wieder verfügbar sind.

Nur in der Vollversion möglich!

Voreinstellung
--------------

Über diesen Menüpunkt können Sie verschiedene Dinge konfigurieren.
In der frei kopierbaren Version von `Amiga Route' können Sie die
Durchschnittsgeschwindigkeiten für die einzelnen Straßentypen
festlegen.

In der Vollversion können Sie auch einstellen, wie gern Sie einen
bestimmten Straßentyp fahren. Außerdem können die Details der Karte
individuell ein- und ausgeschaltet werden.

Ueber
-----

Es erscheint ein Requester mit Informationen über das Programm.

Neuer Ort
---------

Sie können Über diesen Menüpunkt neue Orte in die Datei von `Amiga
Route' aufnehmen. Es erscheint der Ort Ändern Requester, als Ortsname
ist *Default* eingestellt(siehe Ort Aendern-Requester).

Nur in der Vollversion möglich!

Ort aendern
-----------

Nach Auswahl dieses Menüpunkts werden Sie nach dem Namen des zu
ändernden Ortes gefragt. Sobald Sie den Namen eingegeben haben,
erscheint der Ort Ändern-Requester.

Nur in der Vollversion möglich!

Ort loeschen
------------

Hiermit können Sie Orte aus den Daten von `Amiga Route' löschen.
Geben sie bitte den Namen des zu löschenden Ortes ein.

Nur in der Vollversion möglich!

Die Karte
=========

In diesem Fenster wird das Straßennetz und die aktuelle Route (falls
berechnet) grafisch dargestellt.  Folgende Farben finden zur
Kennzeichnung der Straßen Verwendung:

Autobahnen: rot
Europastraßen: rot
Bundesstraßen: gelb
Landstraßen: grau
Kreisstraßen: grau
Sonstige: grau
Küstenlinien und Flüsse: blau
Staatsgrenzen: grün

Der Name des Startorts wird grün, der des Zielort wird rot gezeichnet.
Falls Wegpunkte angegeben worden sind, werden diese in blau
eingezeichnet.  Die Route wird in schwarz dargestellt.

Über die Cursortasten kann die Karte gescrollt werden.  Klick in die
Karte zeigt einen Requester mit Informationen über den dem Mauszeiger
nächsten Ort.

Die Bedienung erfolgt über die Gadgets in der Toolbox und über das
Menü:

Zoom In
-------

Mit diesem Gadget kann man einen Ausschnitt der Karte vergrössern.
Klicken Sie bitte mit der linken Maustaste in die Karte und halten Sie
die Maustaste gedrückt. Jetzt können Sie einen Rahmen aufziehen. Wenn
Sie die Maustaste loslassen, wird dieser Ausschnitt angezeigt.

Zoom Out
--------

Der Ausschnitt wird um den Faktor 2 verkleinert.

Route
-----

Zeigt die gewählte Route bildschirmfüllend an. Falls keine Route
berechnet ist, ist dieses Gadget nicht aktiviert.

Uebersicht
----------

Zeigt die Übersichtskarte an.

Detail +|-
----------

Erhöhung und Verringerung der Details in der Karte. Es existieren 6
verschiedene Detailstufen. Die Anzahl der angzeigten Orte ist abhängig
von deren Grösse.

Druck der Karte
---------------

Der gezeigte Ausschnitt wird ausgedruckt.  (Der Druck erfolgt über den
Workbench - Druckertreiber)

Nur in der Vollversion möglich!

Zurueck
-------

Rückkehr ins Hauptfenster.

Startort setzen
---------------

Sie werden aufgefordert, einen Ort in der Karte anzuklicken.  Dieser
Ort ist dann der neue Startort der Route.  Er erscheint grün in der
Karte.

Zielort setzen
--------------

Sie werden aufgefordert, einen Ort in der Karte anzuklicken.  Dieser
Ort ist dann der neue Zielort der Route.  Er erscheint rot in der Karte.

Wegpunkt setzen
---------------

Sie werden aufgefordert, einen Ort in der Karte anzuklicken.  Dieser
Ort ist dann der neue Wegpukt der Route.  Er erscheint blau in der
Karte.

Wegpunkt loeschen
-----------------

Der Wegpunkt wird gelöscht.

Route berechnen
---------------

Falls die alte Route nicht mehr gültig ist, sich also Startort,
Zielort oder Wegpunkt geändert haben, wird die neue Route berechnet.

Ort Aendern-Requester
=====================

In diesem Requester können sie alle Daten eines Ortes ändern.  Oben
links erscheint der Ortsname, bei einem neuen Ort erscheint als Name
"Default". Ändern Sie ihn in den gewünschten Ortsnamen.  Bitte achten
Sie auch auf die korrekte Schreibweise bei den Ortsnamen.

Darunter können Sie die geographische Lage des Ortes eingeben.  Dieses
sollte immer gemacht werden, da der Ort sonst nicht in der Karte
erscheint. Die Koordinaten entnehmen Sie am besten aus einem guten
Atlas.  Etwas darunter haben sie die Möglichkeit, den Ortstyp zu
spezifizieren.  Oben rechts wird das Bundesland ausgewählt.

Darunter erscheinen die Straßen, die von diesem Ort ausgehen.  Hier
können Sie neue Straßen hinzufügen oder bestehende Straßen ändern
oder löschen. Beim Hinzufügen oder Ändern von Straßen erscheint der
Straße Aendern Requester.

Wenn Sie die Straßen der bestehenden Orte ändern wollen, dann wählen
Sie Ort ändern.

Nur in der Vollversion möglich.

Straße Aendern-Requester
========================

In diesem Requester können sie alle Daten einer Straße ändern.  Oben
erscheinen die Namen der Orte zwischen denen die Straße besteht.
Falls sie eine Straße hinzufügen wollen, müssen sie den zweiten Ort
natürlich noch eintragen. Darunter können Art der Straße und die
Länge in Kilometern angegeben werden. Das Feld Minuten ist momentan ohne
Bedeutung.

Nur in der Vollversion möglich.

Bekannte Fehler
***************

Zoom In: Es kann vorkommen, das beim Anklicken der Karte schon gezoomt
wird, obwohl noch kein Rahmen aufgezogen wurde.

Weitere Fehler sind mir momentan nicht bekannt, aber es kann sich trotz
intensiven Testens immer noch irgendwo ein Fehler eingeschlichen haben.

Falls Ihnen ein Fehler am Programm auffallen sollte, so scheuen Sie
sich bitte nicht, mir diesen mitzuteilen (siehe Adresse).

Die Daten des Programms sind leider noch nicht ganz vollständig (We're
working on it :).

Ausblick
********

An dieser Stelle möchte ich einen Ausblick geben, was für die
nächsten Versionen von `Amiga Route' geplant ist:

An erster Stelle steht die Vervollständigung der Orts- und
Straßendaten.  Weiterhin soll es möglich werden, einzelne
Straßenabschnitte zu sperren, sodaß Ausweichrouten für Staus oder
Baustellen möglich werden.

Ab OS2.1 sollen ein Screenmode-Requester für die Bildschirmauflösung
sowie Lokalisation dazukommen.

Denkbar ist auch eine Ortsdatenbank, die für jeden Ort relevante Daten
wie z.B. Hotels oder Sehenswürdigkeiten bereitstellt.

Ich würde auch gerne eine Europaversion von `Amiga Route'
herausbringen.  Leider fehlen mir aber die Koordinaten der Städte und
Autobahnabfahrten sowie Informationen über die Straßen der anderen
Europäischen Länder.  Für die Beschaffung dieser Daten gewähre ich
gerne einen Rabatt auf die Registrierung.  (siehe Die Registrierung)

In wie weit `Amiga Route' weiterentwickelt wird, hängt allerdings auch
von der Registrierungsbereitschaft der Anwender ab.

Der Programmierer
*****************

Wie die meisten warscheinlich schon gemerkt haben, ist mein Name Ludger
Solbach.  Ich studiere momentan Informatik an der Gesamthochschule
Paderborn.

Das Programm `Amiga Route' entstand in meiner Freizeit aus dem Intresse,
das im Studium Erlernte auch mal praktisch einzusetzen.  Außerdem war
ich es leid, immer zu hören: Das kann meine DOSe aber besser! :^)

Programmiert wurde es auf einem Amiga 2000 mit A2630 und 5 Mb Ram in der
Programmiersprache C (ANSI :). Als Compiler benutze ich Dice C (Thanks
Matt).

Adresse
=======

Ludger Solbach
Grimmestraße 5
33098 Paderborn
email: soulman@uni-paderborn.de
Bankverbindung:
Volksbank Sundern, BLZ 464 623 70, Kontonr. 15 416 500

Die Windows-Version von `Amiga Route' heißt `WinMap', sie ist
erhältlich bei:
Torsten Schubert
Karlstraße 49
33098 Paderborn

Danksagungen
************

Ein großes Dankeschön geht an Jim Butterfield und Günther Kirrbach,
durch ihr Programm `RoadRoute' bin ich erst auf die Idee gekommen,
`Amiga Route' zu schreiben.

Ein weiteres Dankeschön geht auch an Joachim Astel, seine
Koordinaten-Datei deutscher Städte hat mir sehr geholfen sowie an
meinen Ko-Autor Torsten 'Schubi' Schubert.

Danke natürlich auch an meine Beta-Tester:
Marc Beyrich, Thomas Globisch, Jürgen Weinelt, Mario 'magick' Kemper,
Dirk Böhmer, Markus 'corwin' Stipp, David Berens, Markus Eickhoff,
Matthias 'tron' Scheler und Markus 'ill' Illenseer.

Concept Index
*************



 Adresse                                Adresse
 Anforderungen                          Anforderungen
 Das Hauptfenster                       Hauptfenster
 Die Karte                              Die Karte
 Die Registrierung                      Die Registrierung
 Disclaimer                             Disclaimer
 Einleitung                             Einleitung
 Farben                                 Die Karte
 Features                               Features
 Fehler                                 Fehler
 Fenster und Requester                  Fenster und Requester
 Hardware                               Anforderungen
 Legende                                Die Karte
 Rabatt                                 Ausblick
 Start                                  Programmstart
 WinMap                                 Adresse

