Page 2 - Contents; PFM
cGPSmapper Manual Contents http://cgpsmapper.com/ 2 of 100 1 Contents 1 CONTENTS .................................................................................................................. 2 2 INTRODUCTION ..........................................................................................
Page 5 - Introduction; Purpose of this document; There are different; Document Conventions; PFM Code
cGPSmapper Manual Introduction http://cgpsmapper.com/ 5 of 100 2 Introduction The latest version of this document can be found at http://www.cgpsmapper.com/ . Feel free to e-mail your comments / contributions to the present document to [email protected] . 2.1 Purpose of this document This manual...
Page 6 - cGPSmapper versions; Symbol cGPSmapper Version; The different; Manual Authors
cGPSmapper Manual Introduction http://cgpsmapper.com/ 6 of 100 preceded by a pair of statements with # metavariables, the whole pair should be repeated (see specific statements for examples). Text in orange colour (e.g. Name= ) are mandatory statements in the given section. Text in olive colour (e.g...
Page 7 - Overview
cGPSmapper Manual Overview http://cgpsmapper.com/ 7 of 100 3 Overview Creating a map to be uploaded to a GPS receiver may be compared to programming: you write a program (i.e. a map) in the programming language (i.e. in PFM ) and then compile it. Alternatively - just as with programming - tools exis...
Page 8 - Map Project; Map Creation; Section Type
cGPSmapper Manual Map Project http://cgpsmapper.com/ 8 of 100 4 Map Project 4.1 Map Creation You write the source file in the PFM format (the .mp file) using any text editor. All map- related information is provided in relevant statements. Then the map is compiled with the cGPSmapper compiler and th...
Page 9 - Header
cGPSmapper Manual Map Project http://cgpsmapper.com/ 9 of 100 Section Type Identifier(s) Body (Objects) [POI] [POLYLINE] [POLYGON] [PLT] [WPT] [DBX] [SHP] [FILE] [RGN10] [RGN20] [RGN40] [RGN80] The header section is mandatory and must appear as the first section in the source file. All other section...
Page 11 - DefaultRegionCountry
cGPSmapper Manual Map Project http://cgpsmapper.com/ 11 of 100 Lock=x Final IMG file will require unlock code specific for each GPS device. Y Yes N no Default = N ProductCode=x Subfamily identifier used for locked IMG files only – value between 1 and 255. Each subfamily can be unlocked with universa...
Page 12 - DefaultCityCountry
cGPSmapper Manual Map Project http://cgpsmapper.com/ 12 of 100 σ τ π DefaultRegionCountry=region_name Should be used in conjunction with DefaultCityCountry . Defines the default country name for automatic city indexing. If not defined, cities will be indexed only if city index info is explicitly pro...
Page 14 - Countries
cGPSmapper Manual Map Project http://cgpsmapper.com/ 14 of 100 Preview=x Refer to section 6.2 (Creating preview map files), on page 61, for details. N map designated for use with GPS will be created Y map designated for use as preview map for MapSource will be created Default = N AlignMethod No long...
Page 15 - CountryIdx; Cities; RegionIdx
cGPSmapper Manual Map Project http://cgpsmapper.com/ 15 of 100 CountryIdx#=country_index The country_index represents the number in the corresponding Country# statement. The first # ( CountryIdx ) must always be one. Subsequent 3 # must be in ascending order. If included, there must be at least 1 re...
Page 17 - Advanced Declarations; Background; τ π; Dictionary
cGPSmapper Manual Map Project http://cgpsmapper.com/ 17 of 100 ReferenceEllipsoid=### Reference Ellipsoid. 0 Krassovsky 1 Airy 2 Modified Airy 3 Australian National 4 Bessel 1841 5 Bessel 1841 (Namibia) 6 Clarke 1866 7 Clarke 1880 8 Everest (Brunei) 9 Everest (India 1830) 10 Everest (India 1956) 11 ...
Page 18 - nn; Highways; SubType
cGPSmapper Manual Map Project http://cgpsmapper.com/ 18 of 100 Level#RGNnn=bitmask Refer to section 4.5 (on page 44) for details. bitmask mask used to show / hide the objects. # level on which the bitmask is applied. nn type of object to which the bitmask is applied. [END] Section terminator. 4.2.3....
Page 20 - Polygon
cGPSmapper Manual Map Project http://cgpsmapper.com/ 20 of 100 σ τ π CountryName=xxx Name of country to which the object belongs. Can be used only together with keys RegionName and CityName . 80 characters maximum. σ τ π Zip=xxx Object Zip Code. 80 characters maximum. Exit#=(type_of_exit_facility),(...
Page 22 - Polyline; Type
cGPSmapper Manual Map Project http://cgpsmapper.com/ 22 of 100 4.2.4.3 Polyline [POLYLINE] Polyline section identifier. [RGN40] may also be used instead. It is used to define linear objects such as streets, streams, etc. Type=object_type Refer to section 4.2.4.1 (on page 18) for details. SubType=obj...
Page 24 - Shapes; Label
cGPSmapper Manual Map Project http://cgpsmapper.com/ 24 of 100 File#=file_name .plt file from which data will be imported to layer #. The path could be either absolute or relative to the current directory. For platform portability, it is recommended to use slashes "/" instead of backslashes ...
Page 26 - Zip
cGPSmapper Manual Map Project http://cgpsmapper.com/ 26 of 100 τ π Zip=field_name Name of the field - in the associated .dbf file - from which cGPSmapper will get the Zip for each object. Only used for polylines (i.e. when Type=RGN40 or Type=64 ) and POIs ( Type=RGN10 or Type=16 ). RoadID=field_name...
Page 28 - MapDekode file; Name of a MapDekode file (including extension) to be
cGPSmapper Manual Map Project http://cgpsmapper.com/ 28 of 100 σ τ π HeightAboveFoundation=field_name Refer to section 0 (on page 30) for details. σ τ π HeightAboveDatum=field_name Refer to section 0 (on page 30) for details. σ τ π HeightAboveFoundationUnit=field_name Refer to section 0 (on page 30)...
Page 29 - File
cGPSmapper Manual Map Project http://cgpsmapper.com/ 29 of 100 4.2.4.8 File [FILE] Lists other PFM files to be included in the current compilation. name=file_name Name of a PFM file (including extension) to be processed in the current compilation. The compiler processes all the objects (and sections...
Page 31 - Marine Charts; ordinary
cGPSmapper Manual Map Project http://cgpsmapper.com/ 31 of 100 This is equivalent of: Numbers1=0,E,1,9,O,4,20 Numbering style can be: N,E,O,B – which suits to: N one, E ven, O dd, B oth. 4.3 Marine Charts Marine charts are a special kind of cartography - similar to Garmin's BlueChart - that is used ...
Page 34 - Warning
cGPSmapper Manual Map Project http://cgpsmapper.com/ 34 of 100 Depth=##.# Point depth / height value with one decimal (e.g. 20.1). The maximum value is 65535, when value is defined as integer; and 6553, when value is defined as real. Warning : This value is not displayed if the “Spot Soundings” sett...
Page 37 - see above
cGPSmapper Manual Map Project http://cgpsmapper.com/ 37 of 100 LightType=xxx Definition of the light type. Can be a number (as decimal or hex) or a letter. If the value is a letter, then the light type is set to 0x0b (Morse code) and letter is used as a Morse code letter. Hex values: 0x00 unlit 0x01...
Page 39 - Levels
cGPSmapper Manual Map Project http://cgpsmapper.com/ 39 of 100 σ τ π DoubleLights=x Additional info shown in the properties window. Number of light bubbles. Valid values are from 1 to 7. Applies only to following marine types: Points of types 0x01XX σ τ π DoubleLightsHorizontal=x Additional info sho...
Page 40 - Concepts and Terminology
cGPSmapper Manual Map Project http://cgpsmapper.com/ 40 of 100 and the other a single point, and choosing levels for them so that the appropriate one is displayed at each zoom setting. You may also want to show only the most important objects like main roads and cities at a wide zoom level and inclu...
Page 41 - Level
cGPSmapper Manual Map Project http://cgpsmapper.com/ 41 of 100 Level no. 8 GPS Equivalent (Metric) GPS Equivalent (Imperial) 19 3km 2 miles to 3 miles 18 5km to 8km 5 miles 17 12km 8 miles to 12 miles 16 20km to 30km 20 miles to 30 miles 15 50km 50 miles 14 80km to 120km 80 miles to 120 miles 13 200...
Page 42 - Data
cGPSmapper Manual Map Project http://cgpsmapper.com/ 42 of 100 defining map objects. Map zoom level 3 is only used to dictate when our map replaces the base map. This means that you must always define one more map zoom level than you actually need for your map objects, and every map definition must ...
Page 43 - Tailoring shape according to level.; cGPSmapper
cGPSmapper Manual Map Project http://cgpsmapper.com/ 43 of 100 [RGN10] Type=3328 Label=Remenham EndLevel=3 Data0=(51.551744,-0.889936) [END] What the EndLevel= n line says is that the coordinates in the highest numbered Data n = line apply up to the specified EndLevel= n , starting with the level nu...
Page 44 - Figure 3: Map Detail
cGPSmapper Manual Map Project http://cgpsmapper.com/ 44 of 100 level. cGPSmapper automatically averages out consecutive points which are too close to be distinguishable on the GPS screen and discards unnecessary points. Nevertheless it is useful for the map author to understand how it is possible to...
Page 45 - Using Dictionary
cGPSmapper Manual Map Project http://cgpsmapper.com/ 45 of 100 Fortunately the Polish file format has a solution called 'Dictionary' which allows you to switch map objects of the same type on or off for each level. [DICTIONARY] is an optional section and follows after the [IMG ID] section. 4.5.2 Con...
Page 47 - Creating custom type file; Creating the source file
cGPSmapper Manual Creating custom type file http://cgpsmapper.com/ 47 of 100 [DICTIONARY] ; 0 1 2 ; 123456789abcdef0123456789abcdef0123456789abcdef Level1RGN10=00000000000000000000000000000000000000000100000 Level2RGN10=00000000000000000000000000000000000000000100000 Level3RGN10=00000000000000000000...
Page 50 - Custom Type Definition; All other objects will be rendered with their default imagery.
cGPSmapper Manual Creating custom type file http://cgpsmapper.com/ 50 of 100 Type=0x4e,5 ; Orchard/plantation Type=0x4f,5 ; Scrub Type=0x50,3 ; Forest Type=0x51,6 ; Wetland/swamp Type=0x52,4 ; Tundra Type=0x53,5 ; Sand/tidal/mud flat [end] 5.2 Custom Type Definition Your custom type definitions will...
Page 57 - Putting it all together; Workflow
cGPSmapper Manual Creating custom type file http://cgpsmapper.com/ 57 of 100 5.3 Putting it all together If you are serious about creating custom types, I recommend that you prepare a small Polish format test file so that you can quickly check your work. Once you have things the way you want them, t...
Page 58 - Sample screens from MapEdit of CustomDemo.mp:
cGPSmapper Manual Creating custom type file http://cgpsmapper.com/ 58 of 100 Sample screens from MapEdit of CustomDemo.mp:
Page 59 - Sample screen from MapSource of CustomDemo.img:
cGPSmapper Manual Creating custom type file http://cgpsmapper.com/ 59 of 100 Sample screen from MapSource of CustomDemo.img:
Page 60 - Sample screens from nüvi:; Standard roads and cities
cGPSmapper Manual Creating custom type file http://cgpsmapper.com/ 60 of 100 Sample screens from nüvi: Standard roads and cities Custom roads and cities Standard Scrub, camping, mountain range Custom scrub, camping, mountain range
Page 61 - MapSource; MapSource Data structure; after; Making the registry entries; EXTREME
cGPSmapper Manual MapSource http://cgpsmapper.com/ 61 of 100 6 MapSource MapSource is Garmin's Windows (and only Windows!) PC based GPS interface program. As with most similar programs, it allows upload and download of waypoints, routes and tracks. Of more interest to us, is the fact that it is also...
Page 62 - must
cGPSmapper Manual MapSource http://cgpsmapper.com/ 62 of 100 2. Create or edit a registry file, which you can simply double-click to create your entries. You can get a template for this file by doing a registry export. Note that you need double slashes in filenames. If you are distributing your maps...
Page 63 - Loading the maps into the GPS; This is done via any of the following methods:
cGPSmapper Manual MapSource http://cgpsmapper.com/ 63 of 100 6.4 Loading the maps into the GPS 1. Choose the map(s) Once in MapSource, the map(s) to be loaded in the GPS must be chosen first. This is done via any of the following methods: Under Switch to Product , in the View menu. Via the correspon...
Page 65 - FAQs; Name variables and where they show up
cGPSmapper Manual FAQs http://cgpsmapper.com/ 65 of 100 7 FAQs 7.1 Name variables and where they show up 7.1.1 Introduction There are three locations where the names of maps, map sets, and related information ("name data") are specified: • the PFM file; • the PFM Preview file; and • sendmap ...
Page 67 - Figure 4: How name variables are shown
cGPSmapper Manual FAQs http://cgpsmapper.com/ 67 of 100 Figure 4: How name variables are shown
Page 68 - Activation of maps in the GPS
cGPSmapper Manual FAQs http://cgpsmapper.com/ 68 of 100 7.2 Activation of maps in the GPS 1. Activation of the map(s) in the GPS If the map image is not shown in the GPS, check that the map is selected to be shown. The method for doing this depends on the GPS model. For example you may find it on th...
Page 70 - Filling (Gas) Stations not showing in the find function of the GPS; line with
cGPSmapper Manual FAQs http://cgpsmapper.com/ 70 of 100 Level0=18 Level1=17 Zoom0=5 Zoom1=6 (Does not overlap with detail IMG file) 7.5 Filling (Gas) Stations not showing in the find function of the GPS Use 0x2F01 (instead of 0x4400) if you want to show it in the find function of your GPS receiver. ...
Page 71 - Glossary; Term; Vector Map
cGPSmapper Manual Glossary http://cgpsmapper.com/ 71 of 100 8 Glossary This section will be further documented in a future version of this manual. Term Definition Vector Map cGPSmapper Map compiler. sendmap PFM Polish Format is a convenient, text based, format used for saving map information on a co...
Page 72 - Appendices; cGPSmapper compilation Errors and Warnings; V Code Warning / Error Text
cGPSmapper Manual Appendices http://cgpsmapper.com/ 72 of 100 9 Appendices 9.1 cGPSmapper compilation Errors and Warnings The table below contains a list of the different errors and warnings that could occur at compilation time. Codes starting with either "E" or "R" apply only to rou...
Page 76 - Exits; Valid exit facility types; Directions; Mnemonic Description
cGPSmapper Manual Appendices http://cgpsmapper.com/ 76 of 100 V Code Warning / Error Text Description / Workaround R007 Node reduction. R008 Too short road to be routable - coordinates were aligned to same place R010 No data for routing - remove 'ROUTING=Y' from [IMG ID] for non routable maps! R011 ...
Page 77 - Facilities; cGPSmapper object types list; Code
cGPSmapper Manual Appendices http://cgpsmapper.com/ 77 of 100 9.2.3 Facilities Facilities can be combined - i.e. facility with Car Wash + Open 24 Hours is 0x48 Mnemonic Description 0x01 HGV/RV Parking 0x02 Convenience Store 0x04 Diesel Fuel 0x08 Car Wash 0x10 Liquid Propane 0x20 HGV Scales 0x40 Open...
Page 92 - Custom types name substitution
cGPSmapper Manual Appendices http://cgpsmapper.com/ 92 of 100 Code (Hex) Code (Decimal) Description Y 0x0406 1030 Submarine cable area/line (invisible) Y 0x0407 1031 Dumping ground (invisible) Y 0x0408 1032 Explosive dumping ground (invisible) Y 0x0409 1033 Danger line (invisible) Y 0x040a 1034 Over...
Page 93 - How do I create XPM definitions?
cGPSmapper Manual Appendices http://cgpsmapper.com/ 93 of 100 String3=0x04,Highway ; English String4=0x08,Carretera ; Spanish LineWidth=5 BorderWidth=1 xpm="0 0 4 0" ; Define both day and night colors (4) "1 c #20c818" ; Daytime interior color "2 c #309838" ; Daytime border c...
Page 94 - Version
cGPSmapper Manual Appendices http://cgpsmapper.com/ 94 of 100 • Resize as needed to your target dimensions. • Save in PNG-24 format with transparency. IconXP steps: • Go to http://www.aha-soft.com/iconxp/index.htm to download a trial version of IconXP. (The registered version is $20US) • Open your ....
Page 96 - cGPSmapper files; Datum
cGPSmapper Manual Appendices http://cgpsmapper.com/ 96 of 100 Version Routable Fully routable maps - find fastest or shortest route, support for all kinds of restrictions and time limited restrictions Marine Version capable of compiling nautical charts only. 9.5 cGPSmapper files This section will be...
Page 97 - Index and Tables; Table of Figures; Edited by Section Changes
cGPSmapper Manual Index and Tables http://cgpsmapper.com/ 97 of 100 10 Index and Tables 10.1 Table of Figures F IGURE 1: LESS DETAIL MAP EXAMPLE ................................................................................... 40 F IGURE 2: MORE DETAIL MAP EXAMPLE ....................................
Page 98 - Index; See
cGPSmapper Manual Index and Tables http://cgpsmapper.com/ 98 of 100 10.3 Index [ [_drawOrder] ........................................ 47 [_ID] ..................................................... 46 [_line] ................................................... 52 [_point] ..............................