Customising Map Display

From MSM_Wiki
Jump to: navigation, search

The cgspmapper compiler has the ability to customise your map display on both Mapsource and GPS device. You can replace Garmin's original colour scheme and icons with your own making your map uniquely yours. The images below show the comparison between Garmin's original display and Malsingmaps with customised display.

http://www.malsingmaps.com/tutorials/MapRef/TYPGarmin.gif -- http://www.malsingmaps.com/tutorials/MapRef/TYPMalsing.gif

Customising your map display is much easier now thanks to the genTYP utility. It is recommended that you use genTYP to prepare your customisation source file.

The Basics[edit]

Chapter 7 of the cGPSmapper user manual is a very useful guide for customising map display. It is recommended that you read it to be familiar with the basics for map customisation. Here are some of the basics:

  • The custom map info is stored in a file with .typ extension. This file needs to be uploaded to your GPS receiver together with your map.
  • The TYP file can be created with the command: cgpsmapper typ sourcefile where sourcefile is a text file containing custom display info.
  • While you can use any text editor to edit the sourcefile, genTYP is the best software to use.

[_id][edit]

This section comprises two parameters:

  • Productcode
  • FID

According to the cgpsmapper manual, ProductCode has to be 1 and FID matching the FID of your maps. From our experience however, these may not always be the case. Anyway, it is safest to follow the manual's recommendation.

[_drawOrder][edit]

This section defined the drawing priority of the polygons. It is important that this section contains the definitions for all valid polygons except background.

Below is the definition syntax for this section:
Type=<hex code of polygon>,<priority>
Example:
Type=0x01,1

Priority range from 1 to 8. A polygon type with higher priority will overlap or cover another polygon type with lower priority.

[_point], [_line] and [_polygon][edit]

These are the definition headings of the customisation. It is best to refer to the cgpsmapper manual for detail explanation.

Sample TYP source file[edit]

It is useful to start with our sample TYP source file rather than starting from scratch. It contains definitions of polygon draw priority that works at least for Malsingmaps.


Using genTYP[edit]

Please read the genTYP user guide writen by its author.

Below is an image of genTYP's user interface. You can open the sample TYP source file or your own source file with File->Open. http://www.malsingmaps.com/tutorials/MapRef/genTYP-1.gif

Customising a point[edit]

  1. Under the Add/Edit frame, select point as element type.
  2. Give this point a default element name. This name will be displayed with the object label is blank.
  3. Select the language for the default name.
  4. The type list contains all the valid point types. Selecting one of the type will fill the Type and Sub Type field below.
  5. You can also fill the Type and Sub Type manually if you are familiar with the hex code for point types.
  6. Click on the Add/Edit Image button.
  7. Click on the Import button to import your bitmap icons.
  8. Once you click Open, genTYP will automatically generate the XPM info of your icon in text format. Click Apply to return to the main menu.
  9. To add the new point customisation to your source file, click Apply again under the Add/Edit frame.

Customising a polyline[edit]

  1. Follow the procedure for customising a point.
  2. The small difference for customising a polyline is you will most probably define a solid color instead of XPM. One the Solid Color field, enter the RGB value of the road color.
  3. You need to enter either a set of two colors or two sets of two colors separated by commas. The first set of two colors are for line and border color during the day. The second set of two colors are for line and border color during the night. If you omit the second set, the first set will be use for both day and night.
  4. Define also the line and border width.
  5. There is also a Use Orientation checkbox. Check this if you are defining XPM instead of solid colour and would like to adjust the XPM to follow the line vector.

Customising a polygon[edit]

  1. Follow the procedure for customising a point.
  2. You can either use solid color or XPM to customise your polygon.
  3. The diffence between definining a polyline and polygon is that there is no need to set line width, border width and use orientation.

Using the sample[edit]

  1. If you find the instructions and explanation above too hard to follow, load our sample TYP source.
  2. Click each of the items under Elements.
  3. Click Edit to load its definition.
  4. Look at the fields under the Add/Edit frame and use them as reference.

Compiling to TYP file[edit]

  1. Check the Compile TYP box
  2. Specify the folder where cgpsmapper is stored
  3. Click Start