HAMMAP Kartendaten                                              HAMMAP V5.0b
==================                                              Gerhard Berg
Datei: KARTEN.TXT                                               DJ6FM


1. Kartendateien

    Auf der HAMMAP-Diskette befinden sich zwei Gruppen von Kartendateien:

    EU       - Europakarte mit Grenzen und geographische Einzelheiten.
    EU-FAST  - Europakarte mit geringerer Genauigkeit fr schnellere Ausgabe.
    WORLD    - Weltkarte (entfllt, wenn nicht genug Platz auf der Diskette).

    Die Dateien werden im Verzeichnis HM50\MAP installiert.


2. Dateiformate

    Fr die Karten-Daten untersttzt HAMMAP unterschiedliche Formate.


2.1 HAMMAP-Textdateien

    Dieses Format wird fr HAMMAP 4.0 und HAMMAP 5.0 verwendet.

    In diesem Format sind die Karten-Daten im ASCII-Code gespeichert
    und knnen mit einem Texteditor bearbeitet werden. Voraussetzung
    ist, da der Editor sehr lange Dateien (bis ca. 1 MB) bearbeiten
    knnen mu.

    Um eigene Ergnzungen zu machen, ist es allerdings nicht erforderlich,
    die Dateien zu editieren. Sie brauchen nur Ihre Ergnzungen in eine
    separate Datei schreiben und dann mit dem Konvertierungsprogramm mit
    der ursprnglichen Karte kombinieren.

    Die Kartendaten im Textformat haben die Erweiterung '.MAP'.


2.2 HAMMAP-Binrdateien

    Da die Verarbeitung von Textdateien beim Betrieb von HAMMAP zu
    lange dauern wrde, werden die Textdateien einmalig mit dem
    Konvertierungsprogramm in ein Binrformat bersetzt. Diese
    Binrdateien knnen dann von HAMMAP sehr schnell verarbeitet
    werden. Eine Rckbersetzung des Binrformats in das Textformat
    ist ebenfalls mglich. Da die Binrdateien weniger Platz als die
    Textdateien bentigen, sind auf Diskette und Festplatte zunchst
    nur die Binrdateien gespeichert.

    Fr jede Kartendatei wird ein Satz von drei Binrdateien mit
    folgenden Erweiterungen erzeugt:

    .BMD  =  Binary Map Data
    .BMC  =  Binary Map Coordinates
    .BMT  =  Binary Map Text

    In allen Befehlen braucht nur die Erweiterung '.BMD' angegeben
    werden. Die anderen Dateien werden automatisch mit verwendet.

    HAMMAP 4.0 und HAMMAP 5.0 benutzen das gleiche Format fr
    Binrdateien. Sie knnen die Dateien ohne Probleme zwischen
    beiden Versionen austauschen.


2.3 HAMMAP33-Textdateien

    Das Konvertierungsprogramm erlaubt auch die Umwandlung von
    Textdateien mit Kartendaten von HAMMAP33. Die Dateien mssen
    die Erweiterung '.OLD' haben. Dazu mssen Sie die Dateien
    entsprechend umbenennen.


2.4 CBD-Dateien

    Das Konvertierungsprogramm untersttzt das CBD-Format (Compressed
    Binary Data) der World-Data-Bank. Diese Daten stammen ursprnglich
    vom amerikanischen CIA wurden aber inzwischen fr die ffentlichkeit
    freigegeben (Public Domain). Die Dateien haben die Erweiterungen
    '.BDY', '.PBY', '.CIL' und '.RIV'. Die Karten von HAMMAP 5.0
    basieren auf diesen Daten.


2.5 World-Digitized-Dateien

    Das Konvertierungsprogramm untersttzt das MP1-Format von "World
    Digitized". Die PC-SIG Disketten #494 - 496 (3 Disketten) enthalten
    die Daten fr eine Weltkarte. Die Dateien mssen die Erweiterung
    '.MP1' haben.


3. Konvertierung

   Bei der Konvertierung wird das Format der Eingabedatei(en)
   in das gewnschte Format der Ausgabedatei(en) umgesetzt.

   Die Eingabe kann aus einer oder mehreren Binr- und/oder
   Textdateien in beliebigem Format und in beliebiger Reihenfolge
   bestehen.

   Die Ausgabe kann in eine HAMMAP-Binrdatei und/oder HAMMAP-
   Textdatei erfolgen. Eine Ausgabe in eines der anderen Formate
   ist nicht mglich.

   Zustzlich kann eine LOG-Datei erzeugt werden. Die LOG-Datei
   hat die Erweiterung '.LOG'. Die LOG-Datei enthlt eine Liste
   der verwendeten Parameter, der Dateien und evtl. Fehlermeldungen.

   Wenn die erste Eingabedatei eine Binrdatei ist, so darf die
   Ausgabe-Binrdatei mit dieser identisch sein. In diesem Fall
   wird letztere inhaltlich nur ergnzt.

   Wenn keine Ausgabedatei definiert wird, erfolgt nur eine
   berprfung der Eingabedaten.

   Die Definition der Ein-/Ausgabedatei(en) kann wahlweise in
   der Kommandozeile oder ber eine Eingabemaske erfolgen.

   Wenn bei der Konvertierung Fehler auftreten, so mssen Sie
   die Fehler korrigieren und dann die Konvertierung erneut
   durchfhren. Binr-Dateien, bei deren Konvertierung Fehler
   aufgetreten sind oder bei denen die Konvertierung abgebrochen
   wurde, werden von HAMMAP nicht akzeptiert.

   Beachten Sie, da bei der Konvertierung die in der Initiali-
   sierungsdatei definierten Einstellungen verwendet werden.
   Um eine neu konvertierte Datei in HAMMAP zu verwenden, mssen
   Sie mit dem Befehl 'Karten-Datei' im Men 'Datei' diese
   Datei auswhlen.


4. Start des Konvertierungsprogramms

   Bei HAMMAP fr DOS wird das Konvertierungsprogramm normaler-
   weise mit dem Befehl HAMMAP und danach der Ziffer 3 gestartet.
   Bei HAMMAP fr Windows erfolgt der Start normalerweise durch
   Doppelklick auf das Programmsymbol 'KARTEN' in der HAMMAP-
   Programmgruppe. Nach dem Start erscheint dann eine Maske zur
   Definition der Ein- und Ausgabedateien.

   In Sonderfllen kann das Konvertierungsprogramm auch direkt
   gestartet werden. Dabei ist folgendes zu beachten:

   - Bei HAMMAP fr DOS befindet sich das Konvertierungsprogramm
     MCDOS.EXE im Verzeichnis HM50\DOS. Zur Ausfhrung wird die
     Laufzeitbibliothek HMDRT40E.EXE im Verzeichnis HM50 bentigt.
     HMDRT40E.EXE mu sich im aktuellen Verzeichnis befinden
     oder in einem Verzeichnis, das in dem DOS-Befehl 'PATH'
     enthalten ist.

   - Bei HAMMAP fr Windows befindet sich das Konvertierungsprogramm
     MCWIN.EXE im Verzeichnis HM50\WIN.

   - Alle im Programm verwendeten Nachrichten und Texte sind nicht
     im Programm enthalten, sondern in einer getrennten Nachrichten-
     datei der jeweiligen Landessprache mit der Erweiterung '.MSG'.
     Die Hilfetexte befinden sich in einer getrennten Datei mit
     der Erweiterung '.HLP'. Fr die deutsche Version heien die
     Dateien DEUTSCH.MSG und DEUTSCH.HLP. Die Dateien befinden sich
     im Verzeichnis HM50.

   - Die fr die Konvertierung verwendeten Einstellungen sind in
     einer Parameterdatei definiert. Die Parameterdatei hat die
     Erweiterung '.INI'. Normalerweise wird die Datei HAMMAP50.INI
     im Verzeichnis HM50 verwendet.


   - Die Syntax fr den Start-Befehl ist folgendermaen:

     HAMMAP fr DOS:
     [pfad]MCDOS [nachrichten] { /? | [parameter] [eingabe [ausgabe]] }

     HAMMAP fr Windows:
     [pfad]MCWIN [nachrichten] { /? | [parameter] [eingabe [ausgabe]] }

     pfad
       Definiert ggf. Laufwerk und Pfad fr das Programm MCDOS.EXE
       bzw. MCWIN.EXE.

     nachrichten
       Definiert Laufwerk, Pfad und Name der Nachrichten- und
       Hilfe-Datei. Die Erweiterung '.MSG' mu mit angegeben
       werden. Wenn keine MSG-Datei angegeben ist, benutzt HAMMAP
       die in der Datei HM-SPEAK.INI angegeben Sprache als Dateiname
       und die Erweiterung ".MSG". Die Hilfedatei hat den gleichen
       Dateinamen wie die MSG-Datei, jedoch die Erweiterung ".HLP".

     /?
       Bei Angabe der Option '/?' wird eine Hilfe zum Programmstart
       ausgegeben.

     parameter
       Definiert Laufwerk, Pfad und Name der Parameter-Datei.
       Die Erweiterung '.INI' mu mit angegeben werden. Wenn
       keine Parameterdatei definiert ist, wird die Datei
       HAMMAP50.INI im aktuellen Verzeichnis verwendet.

     eingabe
       Definiert eine oder mehrere Eingabedateien. Jede Datei-
       Definition kann eine Angabe des Laufwerks und Pfads ent-
       halten. Als Erweiterungen sind '.MAP', '.BMD', '.MP1',
       '.BDY', '.PBY', '.CIL', '.RIV' und '.OLD' zulssig. Wenn
       keine Eingabedatei angegeben ist, erfolgt die Definition
       der Dateien ber eine Maske.

       Wenn mehrere Eingabedateien verwendet werden sollen, so
       werden sie mit '+' aneinandergehngt. In den Dateiangaben
       drfen die Platzhalter '*' und '?' verwendet werden.
       Zwischen den Dateiangaben und dem '+' drfen keine
       Leerzeichen stehen. Die Dateien werden in der Reihenfolge
       verarbeitet, in der sie in der Kommandozeile stehen.

     ausgabe
       Definiert ein oder mehrere Ausgabedateien. Die Definition
       kann eine Angabe des Laufwerks und Pfads enthalten. Als
       Erweiterungen sind '.MAP', '.BMD' und '.LOG' zulssig.
       Wenn eine Eingabedatei aber keine Ausgabedatei mit der
       Erweiterung '.MAP' oder '.BMD' angegeben ist, erfolgt
       nur eine berprfung der Eingabedatei(en). Wenn mehrere
       Ausgabedateien erzeugt werden sollen, so werden sie mit
       Leerzeichen aneinandergehngt. Die Reihenfolge, in der die
       Ausgabedateien angegeben werden, ist beliebig.


   - Beispiele

     Alle Beispiele gelten fr HAMMAP fr DOS. Bei HAMMAP fr
     Windows mu nur der Programmaufruf DOS\MCDOS durch WIN\MCWIN
     ersetzt werden.

     Bei allen Beispielen wird vorausgesetzt, da die Dateien
     DEUTSCH.MSG, DEUTSCH.HLP und HAMMAP50.INI im Verzeichnis
     HM50 und alle Karten-Dateien in Verzeichnis HM50\MAP stehen.

     Bei HAMMAP fr DOS wird weiter vorausgesetzt, da HM50 das
     aktuelle Verzeichnis ist. Ggf. mu mit dem DOS-Befehl CD bzw.
     CHDIR dorthin umgeschaltet werden. Die Datei HMDRT40E.EXE
     mu im Verzeichnis HM50 stehen.


     DOS\MCDOS /?
       Gibt die Hilfe zum Programmstart aus.

     DOS\MCDOS
       Startet das Konvertierungsprogramm. Die Dateien werden ber eine
       Maske definiert. Informationen zur Bedienung der Maske erhalten
       Sie ber die On-Line Hilfe.

     DOS\MCDOS MAP\EU.BMD MAP\EU.MAP
     DOS\MCDOS MAP\EU-FAST.BMD MAP\EU-FAST.MAP
     DOS\MCDOS MAP\WORLD.BMD MAP\WORLD.MAP
       Die drei Befehle konvertieren alle Binrdateien in getrennte
       Textdateien.

     DOS\MCDOS MAP\EU.BMD+MYMAP.MAP MAP\EU1.BMD
       Kombiniert die Original-Europakarte EU.BMD mit Ihren Ergnzungen
       MYMAP.MAP und macht die Ausgabe in einer neuen Datei EU1.BMD.

     DOS\MCDOS MAP\*.BDY+MAP\*.PBY+MAP\*.CIL+MAP\*.RIV MAP\HAMMAP.BMD
       Dieser Befehl kombiniert alle CBD-Kartendaten in eine einzige
       Binr-Datei.


5. Einstellungen des Konvertierungsprogramms

   Die fr die Konvertierung benutzten Einstellungen sind in der
   Parameterdatei (normalerweise HAMMAP50.INI) definiert. Sie stehen
   nach der Zeile '[MAPCVT]'. Fr Parameter, die nicht angegeben sind,
   verwendet das Programm Standard-Werte. In den folgenden Erluterungen
   sind die Standardwerte als Beispiel angegeben.


   MaxArea = -11,35,32,72

     Dieser Parameter definiert die maximale Gre der Kartenausschnitte.
     Linien, die vollstndig auerhalb des angegebenen Bereichs liegen,
     werden nicht in die Ausgabedatei bernommen. Beim Betrieb in HAMMAP
     knnen keine Ausschnitte angewhlt werden, die ber die definierte
     maximale Gre hinausgehen.

     Wenn der Parameter MaxArea in der Parameterdatei nicht definiert ist,
     erfolgt die Definition des maximalen Kartenbereichs ber eine
     Maske am Ende der Konvertierung.

     Der Parameter 'MaxArea' wird nur verwendet, wenn der Parameter
     'AutoSize = OFF' gesetzt ist.

     Das Format des MAXAREA-Befehls ist wie folgt:

     MAXAREA=xsdwest,ysdwest,xnordost,ynordost

     Die einzelnen Werte sind mit Komma voneinander zu trennen und
     haben folgende Bedeutung:

         xsdwest: Sdwestecke geographische Lnge,
         ysdwest: Sdwestecke geographische Breite,
         xnordost: Nordostecke geographische Lnge,
         ynordost: Nordostecke geographische Breite

     Geographische Lnge und Breite werden in Grad als Dezimalbruch
     angegeben und NICHT in Grad, Minuten und Sekunden. Als
     Dezimalzeichen wird der Punkt und NICHT das Komma verwendet.
     Beispiel: 8 Grad 30 Minuten wird als 8.5 Grad angegeben.


   AutoSize = OFF
     Bei der Einstellung 'AutoSize = OFF' bestimmt der Parameter
     MaxArea die maximale Kartengre. Bei der Einstellung
     'AutoSize = ON' wird die maximale Kartengre aus den
     Koordinaten der Eingabedatei(en) ermittelt.


   Resolution = 0
     Dieser Parameter legt die Genauigkeit der ausgegebenen Karte
     in 1/1000 Grad fest. Wenn eine Koordinate in der Eingabedatei
     sowohl horizontal als auch vertikal einen geringeren Abstand
     als den definierten Grenzwert vom zuletzt ausgegeben Wert hat,
     wird die Koordinate nicht ausgegeben. Anfangs- und Endpunkt
     einer Linie werden immer ausgegeben. Wenn der Parameter den
     Wert 0 hat, werden alle Koordinaten ausgegeben.


   MaxSegLen = 200
     Dieser Parameter definiert die maximale Anzahl von Koordinaten
     pro Segment. Wenn ein Segment in einer Eingabedatei mehr
     Koordinaten als die angegebene Grenze enthlt, dann wird in
     der Ausgabedatei das ursprngliche Segment in mehrere Segmente
     unterteilt.


   BdyMask = -1
    Maske zur Auswahl von Grenzen fr CBD-Dateien.

   CilMask = -1
    Maske zur Auswahl von Ksten, Inseln, Seen fr CBD-Dateien.

   RivMask = -1
    Maske zur Auswahl von Flssen fr CBD-Dateien.


   Color = -1
     Wenn der Parameter einen Wert zwischen 0 und 15 hat, erhalten
     alle Segmente den angegebenen Farbwert. Die Einstellung -1
     bewirkt, da der Farbwert bei der Konvertierung bernommen
     wird. (Beim Einlesen von HAMMAP33-Textdateien erfolgt eine
     Umsetzung der Farbwerte.)


   3D = ON
     Der Befehl schaltet den 3D-Effekt bei Dialogfeldern ein.
     Bei Verwendung eines Hercules-Adapters ist der Standard-
     Wert '3D = OFF'.
