HAMMAP Kartdata                                              HAMMAP V5.0b
==============                                               Gerhard Berg
Fil: KARTOR.TXT                                              DJ6FM


1. Kartfiler

    P HAMMAP disketten finns fljande filer med kartdata:

    EU       - Europakarta med landsgrnser och geografiska detaljer.
    EU-FAST  - Europakarta med mindre detaljrikedom fr snabbare hantering.
    WORLD    - Vrldskarta (utgr om disketten r full).

    Filer installeras i katalog HM50\MAP.


2. Filformat

   HAMMAP anvnder olika format fr filer med kartdata.


2.1 Textfiler 

    Detta format anvnds fr HAMMAP 4.0 och HAMMAP 5.0.

    I detta format lagras kartdata som ASCII kod och kan redigeras med
    en texteditor. En frutsttning r dock att editorn kan hantera
    mycket stora filer ( ca. 1 MB).

    Fr att gra egna kompletteringar behver man inte editera hela filen.
    Man kan gra kompletteringarna i en separat fil och sedan kombinera denna med 
    ursprungskartan med hjlp av ett konverteringsprogram.

    Kartfiler i textformat har efternamnet  '.MAP'.


2.2 Binra kartfiler 

    D anvndandet av textfiler skulle bli alltfr lngsam verstts
    textfilen till binrformat med konverteringsprogrammet. Dessa binrfiler
    anvnds sedan i HAMMAP. Konverteringsprogrammet kan ocks verstta
    binrfiler till textfiler. Eftersom binrfiler tar mindre plats n
    textfiler finns endast binrfilerna p diskett och hrddisk.

    Fr varje kartfil finns en uppsttning av tre binrfiler:
   

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

    Fr samtliga kommandon behver endast efternamnet '.BMD' anges. 
    De vriga filerna hanteras automatiskt.

    HAMMAP 4.0 och HAMMAP 5.0 anvnder samma format fr binrfiler. 
    Man kan utan problem byta filer mellan de bda versionerna.
                                                              
2.3 HAMMAP33 textfiler

    Konverteringsprogrammet kan omvandla textfiler med kartdata frn 
    HAMMAP33. Filerna mste ges efternamnet '.OLD'. Dessutom mste de
    ges nya namn.

2.4 CBD filer

    Konverteringsprogrammet klarar  CBD formatet (Compressed
    Binary Data) frn World-Data-Bank. Dessa filer kommer ursprungligen
    frn amerikanska CIA men har uppltits fr allmnt bruk (Public Domain). 
    Filerna har efternamnen '.BDY', '.PBY', '.CIL' och '.RIV'. Kartorna
    i HAMMAP 5.0 r baserade p dessa data.
    


2.5 World Digitized filer

    Konverteringsprogrammet kan hantera  MP1 formatet frn "World
    Digitized". PC-SIG disketterna #494 - 496 (3 disketter) innehller
    filerna fr en vrldskarta. Dessa filer mste ha efternamnet '.MP1'.


3. Konvertering

   Vid konverteringen omvandlas formatet fr indatafilen/filerna till
   nskat format fr utdatafilen/filerna.

   Indata kan best av en eller flera binr- och/eller textfiler i
   valfritt format och turordning.

   Utdata genereras som en HAMMAP binrfil och/eller HAMMAP textfil.
   Andra format fr utdata r ej mjliga.

   Dessutom kan en logfil skapas. Denna har efternamnet
   '.LOG'. Logfilerna innehller en lista ver anvnda parametrar och ev
   felmeddelanden.

   Om den frsta indatafilen r en binrfil sa fr en binr utdatafil 
   ges samma namn. Utdatafilen kommer d att kompletteras.

   Om ingen utdatafil anges s kontrolleras endast indata.

   Val av in/utdatafiler kan gras antingen genom en kommandorad eller
   genom att anvnda ett speciellt fnster.

   Om fel upptrder vid konverteringen s mste dessa korrigeras och
   konverteringen upprepas. Om fel upptrtt eller konverteringen
   avbrutits kommer berrda binrfiler ej att lsas in av HAMMAP.

   Vg beakta att initieringsfilens parametrar anvnds vid konverteringen.

   Vill man anvnda en nykonverterad kartfil mste den frst lsas in
   genom kommandot 'Kartfil...' i menyn 'Arkiv'.
                                       

4. Start av konverteringsprogrammet

   I HAMMAP fr DOS startas konverteringsprogrammet normalt
   med kommandot HAMMAP och sedan siffran 3. I HAMMAP fr Windows startar
   man genom att dubbelklicka p programsymbolen 'Kartor'i HAMMAP 
   programgruppen. Efter start syns ett fnster fr att vlja filer.
   

   Undantagsvis kan konverteringsprogrammet ocks startas separat.
   Drvid br fljande beaktas:

   - I HAMMAP fr DOS finns konverteringsprogrammet MCDOS.EXE 
     i katalog HM50\DOS. Fr exekvering behvs HMDRT40E.EXE i 
     katalog HM50.
     HMDRT40E.EXE mste finnas i aktuell katalog eller i en katalog
     som angivits i 'PATH'
    

   - I HAMMAP fr Windows finns konverteringsprogrammet MCWIN.EXE 
     i katalog HM50\WIN.

   - Alla programmets meddelanden och texter ligger i separata filer
     p resp sprk. De har efternamnet '.MSG'. Hjlptexterna finns
     ocks i separata filer p resp sprk. De har efternamnet '.HLP'. 
     Fr den svenska versionen heter de SVENSKA.MSG resp SVENSKA.HLP 
     och befinner sig i katalog HM50.

   - Parametrarna som styr konverteringen finns i en parameterfil. Denna
     har efternamnet '.INI'. Normalt anvnds filen HAMMAP50.INI i katalog
     HM50.


   - Syntaxen fr startkommandot r fljande:

     HAMMAP fr DOS:
     [skvg]MCDOS [meddelanden] { /? | [parameter] [indata [utdata]] }

     HAMMAP fr Windows:
     [skvg]MCWIN [meddelanden] { /? | [parameter] [indata [utdata]] }

     skvg
       Definierar resp skivenhet och skvg fr programmet MCDOS.EXE
       resp MCWIN.EXE.

     meddelanden
       Definierar skivenhet, skvg och namn p meddelande- och 
       hjlpfilerna. Efternamnet '.MSG' mste anges. Om ingen MSG-fil 
       angivits anvnder HAMMAP det sprk som angivits i filen HM-SPEAK.INI 
       som filnamn och lgger till efternamnet  ".MSG". Hjlpfilen har 
       samma namn som MSG-filen men efternamnet ".HLP".

     /?
       Om option '/?' anges visas en hjlptext.

     parameter
       Definierar skivenhet, skvg och namn p parameterfilen.
       Efternamnet '.INI' mste anges. Om ingen parameterfil anges 
       kommer filen HAMMAP50.INI i aktuell katalog att anvndas.

     indata
       Definierar en eller flera indatafiler. Skivenhet och skvg kan anges.
       Tilltna efternamn r '.MAP', '.BMD', '.MP1', '.BDY', '.PBY', 
       '.CIL', '.RIV' och '.OLD'. Om ingen indatafil anges grs det senare 
       i ett speciellt fnster.

       Om flera indatafiler ska anvndas stts ett '+' tecken mellan 
       filnamnen. Jokrarna '*' och '?' kan anvndas. Inga mellanslag 
       fr finnas mellan filnamnen och '+' tecknen.

     utdata
       Definierar en eller flera utdatafiler. Skivenhet och skvg kan anges.
       Tilltna efternamn r '.MAP', '.BMD' und '.LOG'. Om en indatafil men
       ingen utdatafil med efternamnet '.MAP' eller '.BMD' angivits grs
       bara en kontroll av indatafilen/filerna. Om flera utdatafiler ska
       skapas anges mellanslag mellan resp filnamn. Godtycklig turordning.


   - Exempel

     Alla exempel gller HAMMAP fr DOS. I HAMMAP fr Windows erstts
     DOS\MCDOS med WIN\MCWIN.
    
     I alla exempel frutstts att filerna SVENSKA.MSG, SVENSAK.HLP 
     och HAMMAP50.INI ligger i katalog HM50 och att alla kartfilerna
     ligger i HM50\MAP.

     I HAMMAP fr DOS frutstts vidare att HM50 r aktuell katalog. 
     Filen HMDRT40E.EXE mste ligga i katalog HM50.
    
     
     DOS\MCDOS /?
       Visar en hjlptext.

     DOS\MCDOS
       Startar konverteringsprogrammet. Filerna anges i ett speciellt 
       fnster. Hjlptexter finns on line.

     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

       Dessa tre kommandon konverterar binrfilerna till textfiler.

     DOS\MCDOS MAP\EU.BMD+MYMAP.MAP MAP\EU1.BMD
       Kombinerar originalkartan EU.BMD med en egen komplettering
       MYMAP.MAP och ger utdata i form av en ny fil EU1.BMD.

     DOS\MCDOS MAP\*.BDY+MAP\*.PBY+MAP\*.CIL+MAP\*.RIV MAP\HAMMAP.BMD
       Kombinerar alla CBD data till en enda binrfil HAMMAP.BMD.


5. Parametrar fr konverteringsprogrammet

   Parametrarna som styr konverteringen ligger i parameterfilen 
   (normalt HAMMAP50.INI). De str efter raden  '[MAPCVT]'. Standardvrden
   anvnds om inget annat anges. I exemplen nedan anvnds standardvrden.
   

   MaxArea = -11,35,32,72

     Denna parameter definierar maximala storleken p kartomrdet. 
     D HAMMAP anvnds kan man icke vlja ett kartutsnitt som
     ligger utanfr max storleken.

     Om 'MaxArea' inte definierats, grs det i ett fnster efter
     konverteringen.
    
     Parametern 'MaxArea' anvnds endast om parametern
     'AutoSize = OFF'.

     Formatet fr MAXAREA-kommandot r fljande:

     MAXAREA=xsydvst,ysydvst,xnordost,ynordost

     Resp vrde tskiljs med kommatecken och har fljande betydelse:

         xsydvst: Sydvstra hrnet geografisk lngd,
         ysydvst: Sydvstra hrnet geografisk bredd,
         xnordost: Nordstra hrnet geografisk lngd,
         ynordost: Nordstra hrnet geografisk bredd

     Geografisk lngd och bredd anges decimalt i grader och inte
     i grader, minuter och sekunder. Decimalpunkt mste anvndas, icke
     decimalkomma.
     Exempel: 8 grader 30 minuter anges som  8.5 grader.


   AutoSize = OFF
     Med instllningen 'AutoSize = OFF' bestmmer parametern
     MaxArea det strsta omrdet p kartan. Med instllningen 
     'AutoSize = ON' bestms strsta kartomrdet av koordinaterna
     i indatafilen/filerna.


   Resolution = 0
     Denna parameter bestmmer upplsningen p visad karta i 1/1000 grader. 
     Koordinater i indatafilen som ligger bde horisontellt och vertikalt
     nrmare varandra n det angivna vrdet beaktas ej. Om parametern satts
     till 0 beaktas alla koordinatpunkter.


   MaxSegLen = 200
     Parametern definierar max antal koordinater per segment. Om ett segment
     i indatafilen innehller flera koordinater n grnsvrdet delas 
     det ursprungliga segmentet i flera segment.


   BdyMask = -1
    Mask fr val av landsgrnser fr CBD-filer.

   CilMask = -1
    Mask fr val av kustlinjer, ar, sjar fr CBD-filer.

   RivMask = -1
    Mask fr val av floder fr CBD-filer.


   Color = -1
     Om parametern har ett vrde mellan 0 och 15, fr alla segment
     motsvarande frg. Instllningen -1 medfr att frgen kvarstr efter
     konverteringen.


   3D = ON
     Kommandot kopplar in 3D effekt i dialogboxarna. Med Herculeskort
     r normalinstllningen '3D = OFF'.
