Post Sun Jan 18, 2009 10:10 pm

POLISH FORMAT .MP complete description/explanation

;########################################################################################
;[IMG ID]
;########################################################################################
;
;############
;ID = (required) integer number, id number of map - must be unique for each map
; may be written in decimal format or special hex format with initial letter 'I':
; DEC HEX
; 11000204 I00A7D98C
;############
;
;############
;LBLcoding = (optional, default 6) labeb coding, valid codes are:
; 6 - compressed label coding - smallest maps
; 9 - 8bit coding
; 10 - unicode (only certain GPS firmwares?)
;############
;
;############
;Codepage = (optional, default 0) - if set, 8bit character coding is used, that mean,
; national character might be used (if supported by GPS)
; IMPORTANT:
; - All labels have to be written CAPITAL
; - special codes are different for 8bit coding!
;############
;
;############
;!!! This setting is redundant and should no longer be used !!!
;BlockSize
;############
;
;############
;Datum = (optional) code name of source datum, default value is W84
; ex. Datum=NAS-A
; Please see Datum_List.txt for dataum code names
;
; CUSTOM Datum can be defined in format :
; Datum=Custom: dx,dy,dz,semiMajorAxis,invFlattening
; i.e.(for WGS84):
; Datum=Custom: 0,0,0,6378137.000, 298.257223563
;############
;
;############
;Transparent=(optional, default = N) - if set to 'Y' transparent map will be created
;############
;
;############
;MG= (optional-full version only, default = N) - if set to 'Y', lock on road and
; show next street name active
;############
;
;############
;NUMBERING= (optional-pro version only, default = N) - if set to 'Y', lock on road and
; show next street name and house numbers along street active
;############
;
;############
;ROUTING= (optional-routing version only, default = N) - if set to 'Y', lock on road and
; show next street name active, house numbers along street and routable maps active
; - for routable maps a special data format required!
;############
;
;############
;COPYRIGHT= (optional-full version only) - map copyright text
;############
;
;############
;Elevation= (optional, default = f) m,f - specifies unit used for elevation (meters, feet)
;############
;
;############
;POIOnly =(optional, default = N) Y/N - if set to 'Y' only POI and cities will be imported
; into, no RGN40/RGN80 elements in map will exist
; Same efect if swith -i is used
;############
;
;############
;POIIndex = (optional-full and shareware version only) Y/N - if set to 'Y' all RGN10 elements will
; be indexed (to activate use the 'find' button on the GPS) - without this
; option you will need to provide additional info (e.g. street/description) to
; make an index
; default is 'N'
;############
;
;############
;POINumberFirst = (optional-full version only) Y/N - if set to 'Y', then the house number
; (for POI) will be BEFORE street name
; default is 'Y'
;############
;
;############
;POIZipFirst = (optional-full version only) Y/N - if set to 'Y', then the zip-code (for POI)
; will be BEFORE street name
; default is 'Y'
;
;############
;
;############
;DefaultCityCountry = (optional-full and shareware version only) - default country name for all cities
; if set, all RGN20 elements will be indexed (to activate find for city functionality in GPS)
; used together with DefaultRegionCountry key.
; If defaults are not used, city can be indexed internally by using countries, regions and cities
; sections
;############
;
;############
;DefaultRegionCountry = (optional-full and shareware version only) (see above) - default region name for
; all cities if set, all RGN20 elements will be indexed (to activate find for city functionality in GPS)
; used together with DefaultCityCountry key.
;
;############
;!!! This setting is redundant and should no longer be used !!!
;AlignMethod
;############
;
;############
;Name = (required) map name - character string
;############
;
;############
;TreSize = (optional) maximum allowed region size - in grids. A bigger value means the
; newly created regions may be bigger, but the performance of the map might
; be worse. On the other hand, a smaller region, means that more regions
; must be created what impact final map size...
; suggested values :
; ToPo like map : 1000 - 2000
; Dense streets : 2000 - 5000
; Countryside : 6000 - 10000
;############
;
;############
;TreMargin = (optional) additional margin for newly created regions (in degree)
; recommended is to leave this parameter (or set to 0) unless it is
; necessary to make map regions larger than it is required
;############
;
;############
;!!! This setting is redundant and should no longer be used !!!
;LevelFill
;############
;
;############
;!!! This setting is redundant and should no longer be used !!!
;LevelLimit
;############
;
;############
;RgnLimit = (optional) limit for number of elements in one region
; can be any value between ~50 - 1024 (value less than 50 doesn't make sense)
; Recent experiments shows that this parameter does not impact map performance and can be set
; to maximum allowed value : 1024
; suggested value : 1024
;############
;
;############
;!!! This setting is redundant and should no longer be used !!!
;WorldMap
;############
;
;############
;PreProcess = (Optional) F,G - kind of preprocessing :
; F (or Y) - (default) - full generalization + intersection detection
; G - generalization only (faster method, but 'crossroad' nodes might be removed)
; N - no generalization and no intersection detection - should be
; used ONLY if user provides by himself data for all layers
;############
;
;############
;Levels = (required) number of layers for map, the last layer - in this example Level3
; is always empty - no objects will be imported into it
; Levels=3 means that 2 layers are for keeping map objects only!
;############
;
;############
;Level0 = (required) grid size for each layer. Layer 0 is the most detailed one.
; grid value is used to calculate level grid in layer - in degree value
; the standard value for the most detailed level is 22.
; To choose the best grid values you can use the following table :
;
; NOTE: Grid value also defines visibility in GPS!
;
; Grid Degree Grid Approximate max detail level Visibility for normal settings in GPS
; 24 2.14576721191406E-05 1.5m 0m - 120m
; 23 4.29153442382812E-05 3m 200m - 300m
; 22 8.58306884765625E-05 6m 500m
; 21 0.000171661376953125 12m 800 - 1.2km
; 20 0.00034332275390625 25m 2km
; 19 0.0006866455078125 50m 3km
; 18 0.001373291015625 100m 5 - 8km
; 17 0.00274658203125 200m 12km
; 16 0.0054931640625 400m 20 - 30km
; 15 0.010986328125 800m ...
; 14 0.02197265625 1.6km
; 13 ... ...
; 12 ... ...
;
;############
;Zoom0 = (required-used only by MapSource) zoom level at which the given layer
; should be visible in MapSource
; e.g. Zoom1 = 4 means Layer1 will be visible at zoom ranges between 30km and 12km
; WARNING! zoom values for successive layer must be ascending!
;
; Zoom Approximate visibility in MapSource
; 7 starting from 300km zoom to 120km
; 6 starting from 120km zoom to 50km
; 5 starting from 50km zoom to 30km
; 4 starting from 30km zoom to 12km
; 3 starting from 12km zoom to 8km
; 2 starting from 8km zoom to 3km
; 1 starting from 3km zoom to 1.2km
; 0 starting from 1.2km zoom
;############
;
;########################################################################################
;Valid special section types :
;
;[DEFINITIONS] - dbf tables used for street numbers and POI symbols
;[COUNTRIES] - replacement for [POI], list of countries used by map
;[REGIONS] - replacement for [POI], list of regions used by map
;[CITIES] - replacement for [POI], list of cities used by map
;[HIGHWAYS] - replacement for [POI], list of highways used by map
;[ZIPCODES] - replacement for [POI], list of zip codes used by map
;
;Valid section types :
;[RGN10] or [POI] - (points) POI
;[RGN20] or [POI] - (points) simple points, cities - to differentiate RGN10 between RGN20 a key 'CITY=Y' must be used
;[RGN40] or [POLYLINE] - (lines) streets, streams, railroads and other polylines
;[RGN80] or [POLYGON] - (polygons) oceans, lakes, riverbeds, reservations, forests,
;
;[SHP] (full version only) - declaration of shp/dbf pair to be imported
;[PLT] - declaration of ozi-PLT file to import
;[WPT] - declaration of ozi-WPT file to import
;[FILE] - list of files to be included during compilation
;[DBX] - declaration of MapDekode file to import
;
; - NOTE : ozi files can be created using oziexplorer - http://www.oziexplorer.com/
;
;############
;[DICTIONARY] - Optional section - definition of filters used during creation of different
; levels
; Basic idea of this section is to allow user to import the same set of data into all map layers,
; to prevent importing local roads into lower detailed layers it is possible to apply a filter depending of layer and type of element to import
;
;Level0RGN10=11111100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
;0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
; ^^^^^^ Types through 0x01-0x06 are to import into layer 0, all other won't - '0' at certain position defines which elements are to be discarded
; For example, when setting '0' at position 4 for key Level0RGN10, no elements 'RGN10' of type 4 will be imported into layer '0'
;
;[END-DICTIONARY]
;############
;########################################################################################
;
;
;############
;It is possible to provide additional info for RGN10 points -
;street/second name, country, region, city, zip-code and phone
;If you will do so, all POI will become 'searchable' in GPS - you will
;be able to use 'FIND' button to search them.
;You can also force POIs to be searchable by using POIIndex field in [IMG ID]
;SEARCHABLE POI is active only for the most detailed layer!!!
;
;[DEFINITIONS] section defines sources (dbf file) with additional info for city and poi indexing, street
;numbers and for routing -
;all DBF file names must be without extension here
;
;There ar two possibilities - to use [DEFINITIONS] or to use [COUNTRIES],[REGIONS],[CITIES],[HIGHWAYS],[ZIPCODES]
;sections
;
;WARNING!! [POI] section has a different meaning now!
;############

;[DEFINITIONS]
;Countries=[dbf file name without the extension]
;CountryField=[name of the field(character string) holding the country name

;Regions=[dbf file name without the extension]
;RegionField=[name of the field(character string) holding the region name]
;RegionCountryIdx=[name of the field(integer) with index (row number) to countr table]

;Cities=[dbf file name without the extension]
;CityField=[name of the field(character string) holding the city name
;CityRegionIdx=[name of the field(integer) with index (row number) to region table]

;ZipCodes=[dbf file name without the extension]
;ZipCodeField=[name of the field(character string) holding the zip-code

;Highways=[dbf file name without the extension]
;HighwayField=[name of the field(character string) holding the highway name
;HighwayRegionIdx=[name of the field(integer) with index (row number) to countr table]
;
;ExitServices=[dbf file name without the extension]
;ExitNameField=[name of the field(character string) holding the exit facility name]
;ExitTypeField=[name of the field(integer) with exit type]
;ExitDirectionField=[name of the field(character string) holding direction to facility]
;ExitFacilitiesField=[name of the field(integer) with exit facilities features]
;
;
; Section for maps with house numbers and routing information
;
;StreetNumbers=[dbf file name without the extension]
;Node=[name of the field(integer) - at each node apply following parameters]
;LeftType=[optional][name of the field(integer) - valid:0 (no numbers), 1 (even), 2 (odd), 3(both)]
;LeftStart=[name of the field(integer) - left numbering start]
;Leftend=[name of the field(integer) - left numbering end]
;RightType=[optional][name of the field(integer) - valid:0 (no numbers), 1 (even), 2 (odd), 3(both)]
;RightStart..
;RightEnd..
;LeftZip=[name of the field(integer) - index to zip table, -1 mean no change (keep value from prev node)]
;RightZip=..
;LeftCit[name of the field(integer) - index to city table, -1 mean no change (keep value from prev node)]
;RightCity=..
;[END]
;
;Optionaly the following sections can be defined
;
;List of used countries
;[Countries]
;country1=country name~[0x1d]abbreviation
;country2=
;...
;[END-Countries]
;
;List of regions, each region must refer to a country
;[Regions]
;Region1=region name~[0x1d]abbreviation
;CountryIdx1=(integer, index to country)
;Region2=
;CountryIdx2=
;..
;[END-Regions]
;
;List of cities, each city must refer to a region
;[Cities]
;City1=cityName
;RegionIdx1=(integer, index to region)
;City2=
;RegionIdx2=
;...
;[END-Cities]
;
;[ZipCodes]
;ZIPCODE1=zip-code
;ZipCode2=...
;[END-ZipCodes]
;
;List of highways, each highway must refer to a region
;[Highways]
;Highway1=highway name
;RegionIdx1=(integer, index to region)
;Highway2=highway name
;RegionIdx2=(integer, index to region)
;...
;[END-Highways]
;WARNING!!
;[DEFINITIONS],[COUNTRIES],[REGIONS],[CITIES],[HIGHWAYS],[ZIPCODES] sections must be defined BEFORE any map object

;############
;[PLT] - declaration of ozi-PLT file to import
;RgnType= Category of element, valid values are 0x40(polylines) and 0x80(polygons)
;Type= Type of element, could be written in hex or dec
; List of available element types is listed in files RGNtype.txt/csv/dbf
;Label= Element label
;DirIndicator = (optional) 1,0 - only for streets - if value is set to 1, then on crossroads
; GPS will show direction of the road (calculated internally by GPS)
;EndLevel= (optional)(number) element will be imported into all layers between
; default layer (defined by FILEx) and layer defined by this number (inclusive)
;
;FILE0= (optional) name of PLT file to import into layer 0
;FILE1= (optional) as above, into layer 1
;...
; It is possible to declare an additional text file with names for
; each separate track that is part of the PLT file - if you want to
; activate this feature, you must manually create a TXT file with
; exactly the same name as the PLT file (including extension) and
; add an additional extension .txt
; The file must be placed in the same directory as PLT file.
; as an example check out files Highway 95.plt and Highway 95.plt.txt
;
; There can be as many as 10 PLT files defined (each one for
; a different layer) - the minimum is at least one PLT file
;[END-PLT]
;############

;############
;[WPT] - declaration of ozi-WPT file to import
;RgnType= Category of element, valid values are 0x10(POI) and 0x20(simple points)
;Type= Type of element, could be written in hex or dec
; List of available element types is listed in files RGNtype.txt/csv/dbf
;EndLevel= (optional)(number) element will be imported into all layers between
; default layer (defined by FILEx) and layer defined by this number
;FILE0= (optional) name of WPT file to import into layer 0
;FILE1= (optional) as above, into layer 1
;...
; There can be as many as 10 WPT files defined (each one for
; a different layer) - the minimum is at least one PLT file
;[END-WPT]
;############

;############
;[FILE] - files to be included during compilation - any file conforming 'polish format'
;Name= Name of file to include
;[END-FILE]

;############
;
;Instead of [RGN10] alias [POI] can be used with City=N
;Instead of [RGN20] alias [POI] can be used with City=Y
;Instead of [RGN40] alias [POLYLINE] can be used
;Instead of [RGN80] alias [POLYGON] can be used
;
;
;
;[RGNxx] - (where xx could be 10, 20, 40, 80) definition of RGN10(POI)/RGN20(simple point)/RGN40(polylines)/RGN80(polygon)
;Type= Type of element, could be written in hex or dec or as name (valid names are defined in file RGNtyps.txt which can be customized by the user)
;
;City= (optional, only if [POI] alias is used, default is 'N') (1 or 0 or Y or N) if alias names are used rather than [RGN10] / [RGN20] then this key is used
; to differentiate POI objects from cities
;
;Background= (optiona, only for [RGN80] objects, default is 'N') - if set to 'Y', object defines background for the map
;
;Label= Element label
;Label2= Only RGN40 elements - secondary name of the road
;EndLevel= (optional)(number) element will be imported into all layers between
; default layer (defined by X in key DataX) and layer defined by this number
;Data0= definition (coordinate) for layer 0 - for RGN10, RGN20 only one coordinate is expected, for RGN40, RGN80 a series of coordinates is expected
;
;Data1= definition (coordinate) for layer 1
;... Coordinates can be written in any reasonable precision in format (ns1,we1),(ns2,we2)...
; Single object has to be defined in one line, each separate DataX line is a definition of a separate object
;
; Coordinates must be written in datum defined in [IMG ID] section - if datum
; is not defined there, default datum is assumed - WGS84
;
; There can be as many as 10 different coordinate levels defined (each one for
; a different layer) - the minimum is at least one
;############
; Additional parameters for Exits (RGN10 types only in range 0x20 to 0x27 ( 32 - 39 ) )
; EXIT info is automatically indexed for searching (works with free version!)
; WARNING!! - if EXIT is to be visible in more than one layer - in all layers Exit facilities list
; must be exactly the same! - or only on most detailed layer this info will be included!!
;
;StreetDesc= Additional label for EXIT (EXIT name)
;
;OvernightParking= (1 or 0 or Y or N)
;HighwayIdx= integer index to highway in [HIGHWAYS] section (additional sections must be defined :
; [COUNTRIES], [CITIES], [REGIONS], [HIGHWAYS] just after [IMG ID] section
; - look above)
;
;CityIdx= (shareware or full version only, applyes to RGN10 & RGN20 only!)
; integer index to city in [CITIES] section ([COUNTRIES], [CITIES], [REGIONS] have to
; be defined!)
;
;Exit1=(integer - hex/dec type of exit facility),(direction to facility),(integer hex/dec facilities),(label)
;Exit2=...
;Exit3=...
;
; Valid exit facility types:
; 0x00 Truck Stop / 24-hour Diesel Fuel With Restaurant
; 0x01 Truck Fuel / Diesel Fuel With Large Vehicle Clearance
; 0x02 Gas / Automobile Fuel
; 0x03 Food / Restaurant
; 0x04 Lodging / Hotel/Motel - Call 1-866-394-8768 For Reservations
; 0x05 Auto service / Vehicle Repair and Service
; 0x06 Auto service / Diesel Engine Service
; 0x07 Auto service / Commercial Vehicle Wash
; 0x08 Camp / Campground and RV Service
; 0x09 Hospital / Medical Facilities
; 0x0a Store / Automated Teller Machines
; 0x0b Park / Forest, Park, Preserve, or Lake
; 0x0c point Of Interest / Useful Services, Sites, or Attractions
; 0x0d Fast Food
;
; Directions :
; N - North of
; S - South of
; E - East of
; W - West of
; I - Inner Side of
; O - Outer Side of
; B - Both Sides of
; EMPTY
;
; Facilities (facilities can be added - i.e. facility with Car Wash + Open 24 Hours is 0x48)
; 0x01 Truck/RV Parking
; 0x02 Convenience Story
; 0x04 Diesel Fuel
; 0x08 Car Wash
; 0x10 Liquid Propane
; 0x20 Truck Scales
; 0x40 Open 24 Hours
; 0x80 not used
;
;
;############
;
;############
;[DBX] section
;
;File = MapDekode file name to be imported
;
;[END]

;############
;[SHP] section
;
;Definition for import one SHP file,
;several SHP sections may exists in single control file
;
;Name = file name WITHOUT extension, each SHP must has corresponding
; DBF file
;
;DirField = field name in DBF - show(1) or hide(0) street direction on crossroads
;
;Type = element type into which ESRI data will be imported, must be number or name:
; valid types are :
; 16 or RGN10 - POI
; 32 or RGN20 - cities
; 64 or RGN40 - polylines
; 128 or RGN80 - polygons
;
;LabelField = field name in DBF from where name for element will be get
; field must contain character data!
; * (asterix) means, no field will be used
;
;Label2Field= secondary name of the road - field name in DBF from where name for element will be get
; field must contain character data!
; * (asterix) means, no field will be used
;
;EndLevel= (optional)(number) element will be imported into all layers between
; default layer and layer defined by this number
;
;TypeField = field name in DBF for type element, must be an integer value
; * (asterix) means, no field will be used and
; default from DefaultType for all elements will be used
;
;DefaultType= default kind of element (not generic type!) - will be used if
; no TypeField is used. Must be a decimal value!
;
;Level = (number between 0 and 9)
; destination layer
;
;############
;Additional parameters for POI - only for when Type=16 or Type=32
; If additional POI info will be provided, must be included additional
; section [POI]
; with all POI specific lists
; Then additional fields in [SHP] sections may be included:
;
;CityIdx = dbf field name - integer index to city (row number)
;houseNumber= dbf field name - house number written as a string (only Type=16)
;streetDesc = dbf field name - street name or additional description (only Type=16)
;phoneNumber= dbf field name - phone number written as a string (only Type=16)
;zipIdx = dbf field name - integer index to zip-code (row number) (only Type=16)
;
;############
;
;############
;Additional parameters for Exits
;
;OvernightParking = dbf field name - integer value (1 or 0)
;HighwayIdx = dbf field name - integer index to highway (row number)
;ExitServicesStart= dbf field name - integer index to ExitServices.dbf (row number) - Services for this exit (-1 if not used)
;ExitServicesEnd = dbf field name - integer index to last entry in ExitServices.dbf (row number) - (or -1 if not used)
;############
;
;############
;Additional parameters for street numbering and zip/cities codes
;STREET PARAMETERS CAN BE PROVIDED FOR WHOLE STREET OR FOR EACH SEGMENT
;When data are provided for each segment, additional DBF file need to be used and following fields are used
;
;StreetNumbersStart= dbf field name - integer index to StreetNumbers.dbf (row number) - (-1 if not used)
;StreetNumbersEnd = dbf field name - integer index to last entry in StreetNumbers.dbf (row number) - (or -1 if not used)
;
;In other case (one data for whole street)
;/////LeftType=[optional][(integer) - valid:0 (no numbers), 1 (even), 2 (odd), 3(both)]
;LeftStart=[(integer) - left numbering start]
;Leftend=[(integer) - left numbering end]
;/////RightType=[optional][(integer) - valid:0 (no numbers), 1 (even), 2 (odd), 3(both)]
;RightStart..
;RightEnd..
;############
;
;[END]

;############
; [BACKGROUDN] section
;
; Optional section, if not provided, background will be created
; automatically
;
; ALL elements from given SHP file in this section will be treated as background
; objects
;
;Name = SHP file name without extension
;############
;
;
;##############################################################################
;##############################################################################
;##############################################################################
;##############################################################################
;
; MANUAL END