HAMMAP Kartendaten                                             HAMMAP V10.0
==================                                             Gerhard Berg
                                                               ex DJ6FM


1. Kartendateien

   Auf den HAMMAP CD-ROM befinden sich folgende Kartendateien:

     DL         - Deutschlandkarte
     DL-ALL     - Sehr Detaillierte Deutschlandkarte

     EU         - Europakarte
     EU-ALL     - Sehr Detaillierte Europakarte

     WORLD-F    - Weltkarte geringer Genauigkeit (schnelle Ausgabe)
     WORLD      - Weltkarte mittlerer Genauigkeit
     WORLD-PL   - Detaillierte Weltkarte

   Die Dateien werden im Verzeichnis HAMMAP\MAP installiert.


2. Dateiformate

   Für die Karten-Daten unterstützt HAMMAP unterschiedliche Formate.


2.1 Allgemeine Text-Dateien

   Die Dateien bestehen aus einer beliebigen Anzahl von je einem
   Koordinatenpaar (geogr. Breite und Länge) je Zeile.
   Breite und Länge sind durch Komma getrennt. Danach können
   beliebige weitere Informationen folgen, soweit sie ebenfalls
   durch ein Komma abgetrennt sind.

   y, x     Geographische Breite (Nord) und Länge (Ost)
             in Grad als Dezimalbruch "n.nnnn" ("." als Dezimalpunkt !)
             oder in Grad, Minuten, Sekunden "gg:mm:ss".
             Südl. Breite und westl. Länge mit vorgestelltem '-' oder
             angehängtem 'S' bzw. 'W'.

   Typ, Rang und Kommentar (entsprechend wie bei HAMMAP) werden
   vom Benutzer eingegeben.



2.2 HAMMAP Textdateien

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

   Um eigene Ergänzungen zu machen, ist es allerdings nicht erforderlich,
   die Dateien zu editieren. Sie brauchen nur Ihre Ergänzungen in eine
   separate Datei schreiben und dann mit dem Konvertierungsprogramm mit
   der ursprünglichen Karte kombinieren.

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

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


2.1.1 Textdateien ab HAMMAP 10.0 (2001)

     FormatVersion = 4
     [;<comment>]
     <y>,<x>,<typ>,<rang> [; <comment>]
     <y>,<x>

     y, x     Geographische Breite (Nord) und Länge (Ost)
               in Grad als Dezimalbruch "n.nnnn" ("." als Dezimalpunkt !)
               oder in Grad, Minuten, Sekunden "gg:mm:ss".
               Südl. Breite und westl. Länge mit vorgestelltem '-' oder
               angehängtem 'S' bzw. 'W'.
               Achtung: Länge, Breite gegenüber älteren Versionen vertauscht!!
     typ      beschreibt die Art der Karteninformation
     rang     gibt die Wichtigkeit/Größe an (1=sehr wichtig/sehr groß)
     comment  für Städte und Berge der Name, sonst Kommentar


           HAMMAP         |    CBD     | description
     type   rank  internal | file rank |
     ----------------------+------------+-------------------------------------
                           |            | Coast, Islands, Lakes
     ----------------------+------------+-------------------------------------
     Coast    1       1   | CIL  01   | Coast, islands and lakes that
                           |            |       appear on all maps
     ----------------------+------------+-------------------------------------
                           |            | Islands, Lakes
     ----------------------+------------+-------------------------------------
     Lake     1       2   | CIL  02   | Additional major islands and lakes
     Lake     2       3   | CIL  03   | Intermediate islands and lakes
     Lake     3       4   | CIL  04   | Minor islands and lakes
     ----------------------+------------+-------------------------------------
                           |            | Points to colour water for Coast,
                           |            |       Islands, Lakes
     ----------------------+------------+-------------------------------------
     Water    1     -1   |            | Water for coast, islands and lakes
                           |            |       that appear on all maps
     Water    2     -2   |            | Water for additional major islands
                           |            |       and lakes
     Water    3     -3   |            | Water for intermediate islands
                           |            |       and lakes
     Water    4     -4   |            | Water for minor islands and lakes
     ----------------------+------------+-------------------------------------
                           |            | Rivers
     ----------------------+------------+-------------------------------------
                       1   | RIV  05   | Double lined rivers -> Coast 1
     River    1       8   | RIV  01   | Permanent major rivers
     River    2       9   | RIV  02   | Additional major rivers
     River    3     10   | RIV  03   | Additional rivers
     River    4     11   | RIV  04   | Minor rivers
     ----------------------+------------+-------------------------------------
                           |            | Roads
     ----------------------+------------+-------------------------------------
     Road     1     12   |            | Big roads
     Road     2     13   |            | Intermediate roads
     Road     3     14   |            | Small roads
     ----------------------+------------+-------------------------------------
                           |            | Canals
     ----------------------+------------+-------------------------------------
     Canal    1     15   | RIV  10   | Major canals
     Canal    2     16   | RIV  11   | Canals of lesser importance
     ----------------------+------------+-------------------------------------
                           |            | Boundaries
     ----------------------+------------+-------------------------------------
     Border   1     18   | BDY  01   | Demarcated or delimited boundary
     ----------------------+------------+-------------------------------------
                           |            | Towns
     ----------------------+------------+-------------------------------------
     Town     1     21   |            | Big towns
     Town     2     22   |            | Intermediate towns
     Town     3     23   |            | Small towns
     ----------------------+------------+-------------------------------------
                           |            | Mountains
     ----------------------+------------+-------------------------------------
     Mountain 1     24   |            | Big mountains
     Mountain 2     25   |            | Intermediate mountains
     Mountain 3     26   |            | Small mountains
     ----------------------+------------+-------------------------------------
                           |            | QTH-Locator Grid
     ----------------------+------------+-------------------------------------
                     27   |            | Largest Locator Square
                     28   |            | Large Locator Square
                     29   |            | Small Locator Square
     ----------------------+------------+-------------------------------------
                     30   |            | Kommentar
     ----------------------+------------+-------------------------------------



2.1.2 Textdateien HAMMAP 7.x bis 9.x (2000)

     FormatVersion = 3
     [;<comment>]
     <x>,<y>,<typ>,<rang> [; <comment>]
     <x>,<y>

     x, y in Grad als Dezimalbruch "n.nnnn" ("." als Dezimalpunkt)
           oder in Grad, Minuten, Sekunden "gg:mm:ss".
     typ  beschreibt die Art der Karteninformation
     rang gibt die Wichtigkeit/Größe an (1=sehr wichtig/sehr groß)



           HAMMAP         |    CBD     | description
     type   rank  internal | file rank |
     ----------------------+------------+-------------------------------------
                           |            | Coast, Islands, Lakes
     ----------------------+------------+-------------------------------------
     Coast    1       1   | CIL  01   | Coast, islands and lakes that
                           |            |       appear on all maps
     Coast    2       2   | CIL  02   | Additional major islands and lakes
     Coast    3       3   | CIL  03   | Intermediate islands and lakes
     Coast    4       4   | CIL  04   | Minor islands and lakes
     ---                  | CIL  05   | ---
     Coast    5       5   | CIL  06   | Intermittent major lakes
     Coast    6       6   | CIL  07   | Intermittent minor lakes
     ----------------------+------------+-------------------------------------
                           |            | Points to colour water for Coast,
                           |            |       Islands, Lakes
     ----------------------+------------+-------------------------------------
     Water    1     -1   |            | Water for coast, islands and lakes
                           |            |       that appear on all maps
     Water    2     -2   |            | Water for additional major islands
                           |            |       and lakes
     Water    3     -3   |            | Water for intermediate islands
                           |            |       and lakes
     Water    4     -4   |            | Water for minor islands and lakes
     Water    5     -5   |            | Water for intermittent major lakes
     Water    6     -6   |            | Water for intermittent minor lakes
     ----------------------+------------+-------------------------------------
                           |            | Rivers
     ----------------------+------------+-------------------------------------
     River    1     7 or 1 | RIV  05   | Double lined rivers
     River    2       8   | RIV  01   | Permanent major rivers
     River    3       9   | RIV  02   | Additional major rivers
     River    4     10   | RIV  03   | Additional rivers
     River    5     11   | RIV  04   | Minor rivers
     River    6     12   | RIV  06   | Intermittent rivers -- major
     River    7     13   | RIV  07   | Intermittent rivers -- additional
     River    8     14   | RIV  08   | Intermittent rivers -- minor
                           | RIV  09   | ---
     ----------------------+------------+-------------------------------------
                           |            | Canals
     ----------------------+------------+-------------------------------------
     Canal    1     15   | RIV  10   | Major canals
     Canal    2     16   | RIV  11   | Canals of lesser importance
     ---                  | RIV  12   | ---
     Canal    3     17   | RIV  13   | Canals -- irrigation type
     ----------------------+------------+-------------------------------------
                           |            | Boundaries
     ----------------------+------------+-------------------------------------
     Border   1     18   | BDY  01   | Demarcated or delimited boundary
     Border   2     19   | BDY  02   | Indefinite or in Dispute
     Border   3     20   | BDY  03   | Other line of separation of
                           |            |       sovreignty on land
     ----------------------+------------+-------------------------------------
                           |            | Towns
     ----------------------+------------+-------------------------------------
     Town     1     21   |            | Big towns
     Town     2     22   |            | Intermediate towns
     Town     3     23   |            | Small towns
     ----------------------+------------+-------------------------------------
                           |            | Miscellaneous
     ----------------------+------------+-------------------------------------
     Saltpan        24   | CIL  09   | Salt pans -- major
     Saltpan        25   | CIL  10   | Salt pans -- minor
     ---                  | CIL  11   | ---
     ---                  | CIL  12   | ---
     Iceshelve      26   | CIL  13   | Ice Shelves -- major
     Iceshelve      27   | CIL  14   | Ice Shelves -- minor
     Glacier        28   | CIL  15   | Glaciers
     Reef           29   | CIL  08   | Reefs
     ----------------------+------------+-------------------------------------
                     30   |            | Kommentar
     ----------------------+------------+-------------------------------------



2.1.3 Textdateien HAMMAP 4.x bis 6.x

     [FormatVersion = 2]
     [;<comment>]
     <x>,<y>,<typ>, <color>, <attribute> [; <comment>]
     <x>,<y> [;<comment>]

     x, y in Grad als Dezimalbruch ("." als Dezimalpunkt)

     Typ: (negativ = Einzelheiten)
     ----
     1 = Linie
     2 = Anmalen (Wasser)
     3 = leeres Rechteck
     4 = ausgefülltes Rechteck
     5 = leerer Kreis
     6 = ausgefüllter Kreis
     10 = Noop (nur Kommentar)

     Color:
     ------
     7 = Grenzen, Küsten
     8 = Meere, Seen
     9 = Land
     10 = Flüsse
     11 = Städte

     Attribute:   (bei Linien - wie VBWIN DrawStyle)
     ----------
     0 = solid
     1 = Dash
     2 = Dot
     3 = Dash-Dot
     4 = Dash-Dot-Dot

     Attribute:
     ----------
     bei Typ 2 (Anmalen)    = Randfarbe
     bei Typ 3, 4 (Rechteck) = halbe Kantenlänge (in 1/1000 Grad)
     bei Typ 5, 6 (Kreis)   = Radius (in 1/1000 Grad)


2.1.4 Textdateien bis HAMMAP V3.x

     FormatVersion = 1
     [#<comment>]
     <x>,<y>,<typ>, <color>, <attribute> [# <comment>]
     <x>,<y> [# <comment>]

     x, y in Grad als Dezimalbruch ("." als Dezimalpunkt)

     Typ: (negativ = Einzelheiten)
     ----
     1 = Linie
     2 = Anmalen (Wasser)
     3 = leeres Rechteck
     4 = ausgefülltes Rechteck
     5 = leerer Kreis
     6 = ausgefüllter Kreis
     10 = Noop (nur Kommentar)

     Color:
     ------
     1 = Wasser (Meere, Seen)
     2 = Land
     3 = Flüsse
     4 = Städte
     15 = Grenzen, Küsten

     Attribute:
     ----------
     FFFF = solid (default)
     FF00 = lange Striche
     F0F0 = mittlere Striche
     CCCC = kurze Striche
     AAAA = Dots

     Attribute:
     ----------
     bei Typ 2 (Anmalen)    = Randfarbe
     bei Typ 3, 4 (Rechteck) = halbe Kantenlänge (in 1/1000 Grad)
     bei Typ 5, 6 (Kreis)   = Radius (in 1/1000 Grad)


2. HAMMAP-Binärdateien

   Da die Verarbeitung von Textdateien beim Betrieb von HAMMAP zu
   lange dauern würde, werden die Textdateien einmalig mit dem
   Konvertierungsprogramm in ein Binärformat übersetzt. Diese
   Binärdateien können dann von HAMMAP sehr schnell verarbeitet
   werden. Eine Rückübersetzung des Binärformats in das Textformat
   ist ebenfalls möglich. Da die Binärdateien weniger Platz als die
   Textdateien benötigen, sind auf Diskette und Festplatte zunächst
   nur die Binärdateien gespeichert.

   Für jede Kartendatei wird ein Satz von drei Binärdateien 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.


2.4 CBD-Dateien

   Das Konvertierungsprogramm unterstützt das CBD-Format (Compressed
   Binary Data) der World-Data-Bank. Diese Daten stammen ursprünglich
   vom amerikanischen CIA wurden aber inzwischen für die Öffentlichkeit
   freigegeben (Public Domain). Die Dateien haben die Erweiterungen
   '.BDY', '.PBY', '.CIL' und '.RIV'. Die Karten ab HAMMAP 5.x
   basieren auf diesen Daten.

   Die kompletten CBD-Dateien finden Sie auf der HAMMAP CD-ROM im
   Verzeichnis \HAMMAP\MAP\SOURCE\CBD\...


2.5 World-Digitized-Dateien

   Das Konvertierungsprogramm unterstützt das MP1-Format von "World
   Digitized". Die PC-SIG Disketten #494 - 496 (3 Disketten) enthalten
   die Daten für eine Weltkarte. Die Dateien müssen die Erweiterung
   '.MP1' haben.


3. Konvertierung

   Bei der Konvertierung wird das Format der Eingabedatei(en)
   in das gewünschte Format der Ausgabedatei(en) umgesetzt.

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

   Die Ausgabe kann in eine HAMMAP-Binärdatei und/oder HAMMAP-
   Textdatei erfolgen. Eine Ausgabe in eines der anderen Formate
   ist nicht möglich.

   Zusätzlich kann eine LOG-Datei erzeugt werden. Die LOG-Datei
   hat die Erweiterung '.LOG'. Die LOG-Datei enthält eine Liste
   der verwendeten Parameter, der Dateien und evtl. Fehlermeldungen.

   Wenn die erste Eingabedatei eine Binärdatei ist, so darf die
   Ausgabe-Binärdatei mit dieser identisch sein. In diesem Fall
   wird letztere inhaltlich nur ergänzt.

   Wenn keine Ausgabedatei definiert wird, erfolgt nur eine
   Überprüfung 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 müssen Sie
   die Fehler korrigieren und dann die Konvertierung erneut
   durchführen. Binär-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, müssen
   Sie mit dem Befehl 'Karten-Datei' im Menü 'Datei' diese
   Datei auswählen.


4. Start des Konvertierungsprogramms

   Bei HAMMAP für DOS wird das Konvertierungsprogramm normaler-
   weise mit dem Befehl HAMMAP und danach der Ziffer 3 gestartet.
   Bei HAMMAP für 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 Sonderfällen kann das Konvertierungsprogramm auch direkt
   gestartet werden. Dabei ist folgendes zu beachten:

   - Bei HAMMAP für DOS befindet sich das Konvertierungsprogramm
     MAPCVT.EXE im Verzeichnis ...\DOS. Zur Ausführung wird die
     Laufzeitbibliothek HMDRT40E.EXE im HAMMAP-Verzeichnis benötigt.
     HMDRT40E.EXE muß sich im aktuellen Verzeichnis befinden
     oder in einem Verzeichnis, das in dem DOS-Befehl 'PATH'
     enthalten ist.

   - Bei HAMMAP für Windows 3.1 befindet sich das Konvertierungsprogramm
     MAPCVT.EXE im Verzeichnis ...\WIN.

   - Bei HAMMAP für Windows 95/NT befindet sich das Konvertierungsprogramm
     MAPCVT.EXE im Verzeichnis ...\WIN32.

   - 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'. Für die deutsche Version heißen die
     Dateien DEUTSCH.MSG und DEUTSCH.HLP. Die Dateien befinden sich
     im HAMMAP-Verzeichnis.

   - Die für die Konvertierung verwendeten Einstellungen sind in
     einer Parameterdatei definiert. Die Parameterdatei hat die
     Erweiterung '.INI'. Normalerweise wird die Datei HAMMAP.INI
     im HAMMAP-Verzeichnis verwendet.


   - Die Syntax für den Start-Befehl ist folgendermaßen:

     [pfad]MAPCVT [nachrichten] { /? | [parameter] [eingabe [ausgabe]] }

     pfad
       Definiert ggf. Laufwerk und Pfad für das Programm MAPCVT.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
       HAMMAP.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' zulässig. Wenn
       keine Eingabedatei angegeben ist, erfolgt die Definition
       der Dateien über eine Maske.

       Wenn mehrere Eingabedateien verwendet werden sollen, so
       werden sie mit '+' aneinandergehängt. In den Dateiangaben
       dürfen die Platzhalter '*' und '?' verwendet werden.
       Zwischen den Dateiangaben und dem '+' dürfen 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' zulässig.
       Wenn eine Eingabedatei aber keine Ausgabedatei mit der
       Erweiterung '.MAP' oder '.BMD' angegeben ist, erfolgt
       nur eine Überprüfung der Eingabedatei(en). Wenn mehrere
       Ausgabedateien erzeugt werden sollen, so werden sie mit
       Leerzeichen aneinandergehängt. Die Reihenfolge, in der die
       Ausgabedateien angegeben werden, ist beliebig.


   - Beispiele

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

     Bei HAMMAP für DOS wird weiter vorausgesetzt, daß die Datei
     HMDRT40E.EXE im aktuellen Verzeichnis steht. Ggf. muß mit dem
     DOS-Befehl CD bzw. CHDIR dorthin umgeschaltet werden.

     In den folgenden Beispielen muß für "pfad" folgendes eingegeben
     werden:
       - DOS-Version:        DOS
       - Windows 3.x-Version: WIN
       - Windows 95/NT:      WIN32

     pfad\MAPCVT /?
       Gibt die Hilfe zum Programmstart aus.

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

     pfad\MAPCVT MAP\DL.BMD MAP\DL.MAP
     pfad\MAPCVT MAP\EU.BMD MAP\EU.MAP
     pfad\MAPCVT MAP\WORLD.BMD MAP\WORLD.MAP
       Die drei Befehle konvertieren alle Binärdateien in getrennte
       Textdateien.

     pfad\MAPCVT MAP\EU.BMD+MYMAP.MAP MAP\EU1.BMD
       Kombiniert die Original-Europakarte EU.BMD mit Ihren Ergänzungen
       MYMAP.MAP und macht die Ausgabe in einer neuen Datei EU1.BMD.

     pfad\MAPCVT MAP\*.BDY+MAP\*.PBY+MAP\*.CIL+MAP\*.RIV MAP\HAMMAP.BMD
       Dieser Befehl kombiniert alle CBD-Kartendaten in eine einzige
       Binär-Datei.