Customization

From TrekBuddy

Contents 1 Icons 2 Sounds, Fonts etc 3 Keymap 4 Map Datums 5 CMS

[edit] Icons

You can use custom icons for waypoint (wpt.png) and POIs marks (pois.png), course (arrows.png) and navigation (naviws.png) arrows and/or crosshairs (crosshairs.png) if you put corresponding file to DataDir/resources folder. You should keep image(s) proportions.

The image format for the different custom icons should be as follows:

wpt.png

Square file, at best odd edge length like 13x13 or 15x15

pois.png

Rectangular file, at best odd height and triple that in width (which gives you space for 3 icons), for example 13x39, which provides space for three different icons. Those three icons are used for passed wpts, missed wpts and yet-to-be-reached wpts.

arrows.png and naviws.png

Rectangular file, at best odd height and ten times that in width, for example 59x590, which provides space for 10 arrows with directing from 0° to 90° (10° step).

crosshairs.png

Rectangular file, at best odd height and triple that in width (which gives you space for 3 icons), for example 81x243, which provides space for 3 different crosshairs ("plain", light white, grey).

[edit] Sounds, Fonts etc

To customize the sound played when reaching a waypoint, choose any *.wav, *amr or the like, rename it to wpt.amr and put it into the sounds sub-folder of your cell phone trekbuddy's area.

[edit] Keymap

On some devices with unusual keyboard (like M600i, Blackberry 8800, etc), user has to use ALT/SHIFT/whatever to perform some action in TB. Since now, keymap.txt file in resources can be used to remap unknown key(codes) to to those that represent numeric keys on usual devices.

Example keymap.txt for M600i:

-3=42 
-4=35 
32=48 
101=49 
114=49 
117=51 
105=51 
120=55 
99=55 
110=57 
109=57

In the example above, 101=49 remaps keycode that represents 'e' to the value of '1' key.

Example keymap.txt for SE P1i:

101=49
114=49
116=50
122=50
117=51
105=51
100=52
102=52
103=53
104=53
106=54
107=54
120=55
99=55
118=56
98=56
110=57
109=57
-3=42
32=48
-4=35

Example above in this order: 1,2,3,4,5,6,7,8,9,*,0,#

Example keymap.txt for SE P1i Russian keyboard (by vsalex):

1091=49
1082=49
1077=50
1085=50
1075=51
1096=51
1074=52
1072=52
1088=53
1087=53
1086=54
1083=54
1095=55
1089=55
1084=56
1080=56
1090=57
1100=57
-3=42
32=48
-4=35

Example above in this order: 1,2,3,4,5,6,7,8,9,*,0,#

Example for Blackberry 8800 (by lgqyqj):

113=35
119=49 
114=51 
100=53 
122=55 
99=57

Example above map (to avoid ALT-Key):

'Q'-Key to be  '#' 
'W'-Key to be  '1' 
'R'-Key to be  '3'
'D'-Key to be  '5'
'Y'-Key to be  '7' (German Keyboard should use 121=55 instead, cause Z/Y are swapped!)
'C'-Key to be  '9'

Example for Blackberry 8300 Curve (old version w/o onboard GPS, by DUS32):

119=49
101=50
114=51
115=52
100=53
102=54
121=55
120=56
99=57
97=42
48=48
113=35

Example for Blackberry 8830

119=49 -1-
101=50 -2-
114=51 -3-
115=52 -4-
100=53 -5-
102=54 -6-
122=55 -7-
120=56 -8-
99=57  -9-
97=42  -*-
48=48  -0-
113=35 -#-

Example for E61 (by haddock):

109=48 
114=49 
116=50 
122=51 
102=52 
103=53 
104=54 
118=55 
98=56 
110=57 
117=42 
106=35 

To find out keycodes for the keys, one can use midlet from http://frog-parrot.net/games.html (look for Display Key Codes). Values for keys on "standard" keyboard (KEY_xxx) can be found here: http://java.sun.com/javame/reference/apis/jsr037/javax/microedition/lcdui/Canvas.html

[edit] Map Datums

TrekBuddy has a few built-in datums. Since 0.9.63, there's more convenient way to add own datums than using Datum-N attributes in JAD file. Just put datums.txt file in %DataDir%/resources folder on your memory card.

Datum definition format:

symbolic name{reference ellipsoid name, dx, dy, dz}=map:name iz Ozi

For example see datums.txt inside the jar file in resources subdirectory (remember - jar file is a zip, so you can view it using your favourite tool).

The program's boot sequence first loads built-in file, then tries the the file on the memory card, and finally scans JAD file.

Ellipsoid names:

• Airy 1830
• Modified Airy
• Australian National
• Bessel 1841 (Namibia)
• Bessel 1841
• Clarke 1866
• Clarke 1880
• Everest (1830)
• Everest (Sarawak)
• Everest (1956)
• Everest (1969)
• Everest (Singapur)
• Everest (Pakistan)
• Fischer 1960
• Helmert 1906
• Hough 1960
• Indonesian 1974
• International 1924
• Krassovsky 1940
• GRS 67
• GRS 80
• South American 1969
• WGS 72
• WGS 84

Default built-in datums.txt contains these datums (as Ozi names):

• Australian Geodetic 1966
• CH-1903
• European 1950 (Spain and Portugal)
• Ireland 1965
• NAD27 CONUS
• NTF France
• Ord Srvy Grt Britn
• Potsdam Rauenberg DHDN
• Pulkovo 1942 (1)
• Pulkovo 1942 (2)
• Rijksdriehoeksmeting
• Rome 1940
• RT 90
• S42

[edit] CMS

See CMS