TomTom Navigator SDK Installation And Use Manual page 18

POI type codes 9993 through 9999. External applications can, therefore, provide Navigator with up to
seven additional POI types. The data for the POI of these types has to be packaged in a file placed in the
\TomTom\ directory of the Pocket PC. The format of this external POI file is the following:
Index
POI data for type 1
...
POI data for type N
The index has the following structure:
4 bytes N = Number of POI types
4 bytes Type code for POI type 1
...
4 bytes Type code for POI type N
4 bytes File position of POI data for type 1
...
4 bytes File position of POI data for type N
4 bytes Total file size
Where file positions are byte offsets from the start of the file, and all quantities are stored as
little−endian integers.
The POI data section for an individual POI type has the same structure as the .OV2 files, with the
exception that only extended POI records and skipper records can be used, since the unique ID field, used
to identify each point of interest to the external application, is not present in a simple POI record.
Moreover, each POI type in an external POI file can optionally have a user−friendly name and an icon.
The icon must be a .BMP file in the same directory as the external POI file. It is recommended that icons
have a size of 22 by 22 pixels. For a POI type to have a user−friendly name and an icon, a special record of
type 100 must be present at the beginning of the corresponding POI data section. This type of record
consists of the following fields:
1 byte T: type (always 100)
4 bytes L: length of this record in bytes (including the T and L fields)
P bytes Name: zero−terminated ASCII string specifying the name of the POI type
L−P−5 bytes
Where the name of the POI type is subdivided into several strings corresponding to different languages:
POINAME|«dutch translation»|«english translation»|«french translation»|¬
«italian translation»|«german translation»|«spanish translation»|¬
«US english translation»|
Please keep the strings for each language shorter than 25 characters, approximately.
You can use the utilities SinglePoi.exe and ZipPoi.exe to associate a name and an icon with each POI
type and create the final external POI file from the individual files for each POI type. If we have one .OV2
file for each POI type, named poi.«nnnn», where «nnnn» is the POI type code in four decimal digits (9993
thru 9999), the following command will give it a name and an icon:
singlepoi "«name»" «icon».bmp poi.«nnnn»
Where «name» is the user−friendly name of the POI type and «icon» is the name of the .BMP file to be
used as its icon. This has to be done for each poi.«nnnn» file.
NOTE: using SinglePoi.exe is not strictly necessary. The POI type will have a generic name and icon if
this step is omitted.
4. Extending the Location−sensitive Menu
Icon: zero−terminated ASCII string specifying the name of the
.BMP file
13