1 <?xml version="1.0" encoding="UTF-8"?>
2 <?xml-stylesheet type="text/xsl" href="../tohtml.xsl?root=maemo-mapper"?>
6 - Copyright (C) 2006 - 2008 John Costigan.
8 - This file is part of Maemo Mapper.
10 - Maemo Mapper is free software: you can redistribute it and/or modify
11 - it under the terms of the GNU General Public License as published by
12 - the Free Software Foundation, either version 3 of the License, or
13 - (at your option) any later version.
15 - Maemo Mapper is distributed in the hope that it will be useful,
16 - but WITHOUT ANY WARRANTY; without even the implied warranty of
17 - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 - GNU General Public License for more details.
20 - You should have received a copy of the GNU General Public License
21 - along with Maemo Mapper. If not, see <http://www.gnu.org/licenses/>.
27 <title>Maemo Mapper</title>
29 <topictitle>Introduction</topictitle>
30 <context contextUID="help_maemomapper_intro"/>
31 <para>Welcome to Maemo Mapper.</para>
33 Maemo Mapper is a geographical mapping tool that can be used to:
37 Download map data to your device's main memory or to an external
41 View that map data on the screen.
44 Navigate that map data by panning around the screen and zooming in
48 Display your position and other GPS information from a GPS
52 Store and display Point-of-Interest (POI) data.
55 Download directions between arbitrary points on the map.
58 Save or open track data or route data.
62 Use the <ref refid="help_maemomapper_" refdoc="index"/> to peruse the
63 various sections of this help document, or go to <ref
64 refid="help_maemomapper_getstarted" refdoc="Getting Started"/> to
65 get up and running quickly.
69 <topictitle>Getting Started</topictitle>
70 <context contextUID="help_maemomapper_getstarted"/>
72 When you first start Maemo Mapper, you will be presented with the
73 <display_text>Settings</display_text> dialog box. Most of the
74 settings have reasonable defaults, but if you have a GPS receiver,
75 you should fill in the <display_text>Bluetooth</display_text> field
76 with the MAC address of your GPS receiver. If you don't know the
77 MAC, turn on your GPS receiver and push the
78 <display_text>Search</display_text> button. Maemo Mapper will
79 attempt to automatically discover the MAC address of your receiver.
80 For more information about the <display_text>Settings</display_text>
81 dialog box, see <ref refid="help_maemomapper_settings"
85 Alternatively, you can leave the
86 <display_text>Bluetooth</display_text> field blank, and Maemo Mapper
87 will attempt to automatically search for and use any bluetooth GPS
88 receivers that it can identify. This is particularly useful if you
89 tend to use multiple different GPS receivers. This feature is not
90 guaranteed to work on all Nokia devices or with all bluetooth GPS
94 If you are using Maemo Mapper on a device with an internal GPS
95 receiver, then you should probably use the "Bluetooth" receiver type
96 and leave the field empty.
99 When you are finished setting up Maemo Mapper to your preferences,
100 pressing the <display_text>Ok</display_text> button will lead you to
101 another dialog box: the <display_text>Manage
102 Repositories</display_text> dialog.
105 To get started quickly, press the
106 <display_text>Download...</display_text> button. Maemo Mapper will
107 download a set of pre-defined repository information for you to use.
108 If you use the pre-defined repositories, you can delete the
109 <display_text>Default</display_text> repository. For more
110 information about repositories and the <display_text>Manage
111 Repositories</display_text> dialog, see
112 <ref refid="help_maemomapper_repoman"
113 refdoc="Managing Repositories"/>.
116 Certain repositories (most notably, the commercial ones) may have
117 license agreements attached with their use. It may be illegal to
118 use a certain repository with Maemo Mapper or under certain
119 conditions. This includes the repositories downloaded via the
120 <display_text>Download...</display_text> button. If you are not
121 sure if you are legally allowed to use a particular repository, you
122 should delete it from your list of repositories. The authors of
123 Maemo Mapper cannot be held responsible for your use of a particular
127 Once you have your Repositories set up the way you like, press the
128 Ok button, and you will be presented with a blank screen, because
129 you have not yet actually downloaded any map data to your device.
130 To allow Maemo Mapper to automatically download map data as it
131 becomes needed on the display, enable the
132 <display_text>Auto-Download</display_text> checkbox in the
133 <display_text>Maps</display_text> menu.
136 If you have a working internet connection, Maemo Mapper will attempt
137 to download maps and display them on the screen automatically as
138 the downloads complete. You should see a map of the world. Be
139 careful when you enable Auto-Download, because it can quickly fill
140 your available disk space. See
141 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/> for
142 details on how to manage disk space for a particular repository.
144 <heading>The Graphical User Interface</heading>
146 The main view of Maemo Mapper emphasizes simplicity. By default,
147 the map is all that is displayed. You current position (if you have
148 a GPS receiver) is indicated by a blue circle. The blue line
149 extending from the blue circle indicates your current heading and
150 speed. <i>Tracks</i> are red and represent where you have been.
151 <i>Routes</i> are green and represent where you want to go, i.e.
152 directions to a location.
155 The hardware buttons on your device provide quick access to common
160 <graphic filename="2686KEY_full_screen"/> - Toggle
164 <graphic filename="2686KEY_zoom_in"/> - Zoom In - hold down to
165 zoom multiple levels at a time
168 <graphic filename="2686KEY_zoom_out"/> - Zoom Out - hold down to
169 zoom multiple levels at a time
172 <graphic filename="2686KEY_scroll_up"/> - Pan Up - hold down to
176 <graphic filename="2686KEY_scroll_down"/> - Pan Down - hold down
180 <graphic filename="2686KEY_scroll_left"/> - Pan Left - hold down
184 <graphic filename="2686KEY_scroll_right"/> - Pan Right - hold down
188 <graphic filename="2686KEY_scroll_center"/> - Toggle Auto-Center
191 <graphic filename="2686KEY_esc"/> - Programmable; defaults
192 to: Hide/Show Tracks and Routes
196 You can also pan around the map by tapping on the screen. Maemo
197 Mapper will center the display on where you tapped. If you had
198 <display_text>Auto-Center</display_text> enabled, tapping a location
199 to center on it will automatically disable that functionality.
202 From this point, you can use the menus to manage routes, tracks, and
203 map data; to change the view; to change settings; or to see detailed
204 GPS information (if you have a GPS receiver).
207 There is also a context-sensitive menu that appears on the map when
208 you tap and hold a location on the map. From that menu, you can
209 download directions, calculate distances, or add/modify
210 Point-of-Interest (POI) data.
213 For help with any of these features, use the
214 <ref refid="help_maemomapper_" refdoc="index"/>.
218 <topictitle>Main Menu</topictitle>
219 <context contextUID="help_maemomapper_mainmenu"/>
221 This help topic describes the functionality of each of the menu
222 items in Maemo Mapper.
224 <heading>Route</heading>
226 The <display_text>Route</display_text> menu is used to manipulate
227 the current <i>route</i>. A route in Maemo Mapper is defined as a
228 set of points and waypoints describing <i>where you would like to
229 go</i>, e.g. driving directions from 123 Main Street to 456 Elm
230 Street. It can include multiple segments. The current route is
231 empty until you open or download a route.
234 The <display_text>Route</display_text> menu has the following menu
239 <display_text>Open...</display_text> - Open a route from a GPX
240 file on the file system. The opened route is <i>appended</i> to
241 the current route, so you can string together different routes
242 together to create a trip with multiple destinations.
245 <display_text>Download...</display_text> - Download a route from
246 the internet. See <ref refid="help_maemomapper_downroute"
247 refdoc="Download Route"/> for more information.
250 <display_text>Save...</display_text> - Save the current route to a
251 GPX file on the file system.
254 <display_text>Show Distance to Next Waypoint</display_text> - Show
255 the distance left to be traveled (along the current route) until
259 <display_text>Show Distance to End of Route</display_text> - Show
260 the distance left to be traveled (along the current route) until
261 the end of the current route. The calculated distance includes
262 the distance between breaks in the route (i.e. between the end of
263 one route segment and the beginning of another route segment).
266 <display_text>Reset</display_text> - Reset Maemo Mapper's tracking
267 of your progress along the current route. Use this if Maemo
268 Mapper loses track of where you are with respect to the current
272 <display_text>Reset</display_text> - Clear the current route,
273 effectively replacing it with an empty route.
276 <heading>Track</heading>
278 The <display_text>Track</display_text> menu is used to manipulate
279 your current <i>track</i>. A track in Maemo Mapper is defined as
280 a set of points along which you have been traveling, i.e. <i>where
281 you have been</i>. It can include multiple segments. Tracks are
282 most useful if you have enabled a GPS receiver. The current track
283 is empty until you get at least one valid position point from your
284 GPS receiver, and it is appendeded to whenever you stray far enough
285 from the last track point.
288 The <display_text>Track</display_text> menu has the following menu
293 <display_text>Open...</display_text> - Open a track from a GPX
294 file on the file system. In contrast to route data, the opened
295 track is <i>prepended</i> to the current track, so if you are
296 trying to rebuild previous track data, you must open the tracks
297 backward in time (most recent tracks first).
300 <display_text>Save...</display_text> - Save the current track to a
301 GPX file on the file system.
304 <display_text>Insert Break</display_text> - Artificially insert a
305 break in your current track data. This simulates the loss and
306 re-acquisition of a GPS fix, and it can be used to track, for
307 example, refueling stops.
310 <display_text>Insert Mark</display_text> - Artificially insert a
311 mark with a description in your current track data. This can be
312 used to mark important landmarks.
315 <display_text>Show Distance from Last Break</display_text> - Show
316 the distance traveled (along the current track) since the last
320 <display_text>Show Distance from Beginning</display_text> - Show
321 the distance traveled (along the current track) since the
322 beginning of the track. The calculated distance includes the
323 distance between breaks in the track (i.e. between when a GPS fix
324 is lost and later re-acquired).
327 <display_text>Clear</display_text> - Clear the current track,
328 effectively replacing it with an empty track.
331 <display_text>Enable Tracking</display_text> - This checkbox
332 controls whether or not Maemo Mapper keeps track of your location
333 as you move. If enabled, your track will be recorded to file,
334 which can be exported to GPX via the "Save..." menu item. Maemo
335 Mapper cannot draw your track on-screen if this checkbox is
339 <heading>Maps</heading>
341 The <display_text>Maps</display_text> menu is used to control your
342 map repositories. This menu will be populated with a list of all of
343 your map repositories, from which you can select to switch to a
344 particular repository.
347 The <display_text>Maps</display_text> menu has the following menu
348 items in addition to the list of available repositories:
352 <display_text>Manage Maps...</display_text> - Download or delete
353 maps for the currently selected repository. For more details, see
354 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
357 <display_text>Manage Repositories...</display_text> - Configure
358 each of your available repositories, or add new ones. You can
359 also download a pre-defined set of repositories. For more
360 details, see <ref refid="help_maemomapper_repoman"
361 refdoc="Managing Repositories"/>.
364 <display_text>Auto-Download</display_text> - Toggle Maemo Mapper's
365 ability to automatically download maps as they are needed in order
366 to fill the screen with map data. This is useful for arbitrary
367 exploration of the world while connected to the internet, or if
368 you have a constant connection to the internet (i.e. via a
369 cellular data service).
372 <heading>View</heading>
374 The <display_text>View</display_text> menu allows you to customize
375 the view by showing or hiding certain features of the display.
378 The <display_text>View</display_text> menu has the following menu
383 <display_text>Zoom In</display_text> - Zoom in by one zoom level.
384 You can also use the <graphic
385 filename="2686KEY_zoom_in"/> button.
388 <display_text>Zoom Out</display_text> - Zoom out by one zoom
389 level. You can also use the <graphic
390 filename="2686KEY_zoom_out"/> button.
393 <display_text>Full Screen</display_text> - Toggle full-screen
394 mode. You can also use the <graphic
395 filename="2686KEY_full_screen"/> button to toggle
399 <display_text>Scale</display_text> - Toggle the display of the
403 <display_text>Route</display_text> - Toggle the display of routes.
406 <display_text>Track</display_text> - Toggle the display of tracks.
409 <display_text>Velocity Vector</display_text> - Toggle the display
410 of the velocity vector (the blue line extending from the blue
411 circle that represents your current location).
414 <display_text>POIs</display_text> - Toggle the display of POIs.
417 <display_text>POI Categories...</display_text> - Define POI
418 categories and which categories are displayed on the map. For
419 more details, see <ref refid="help_maemomapper_poicat" refdoc="POI
423 <heading>Auto-Center</heading>
425 The <display_text>Auto-Center</display_text> menu is used to control
426 whether or not Maemo Mapper should re-center the display as your
427 current location changes. The sensitivity of re-centering (how
428 close you get to the edge of the display before Maemo Mapper
429 re-centers the display) can be configured in the <ref
430 refid="help_maemomapper_settings" refdoc="Settings"/> Dialog.
433 There are three different modes of Auto-Center:
437 <display_text>Lat/Lon</display_text> - Keep your location centered
441 <display_text>Lead</display_text> - Depending on your speed, keep
442 a location in front of you centered on the screen. The faster you
443 are going, the more lead distance is used.
446 <display_text>None</display_text> - Do no re-center the display
450 <heading>Go to</heading>
452 The <display_text>Go to</display_text> menu is used to center the
453 view on a particular location.
456 The <display_text>Go to</display_text> menu has the following menu
461 <display_text>Lat/Lon...</display_text> - Specify an exact
462 Latitude and Longitude on which to center the display.
465 <display_text>GPS Position</display_text> - Center the display on
466 your current GPS position. This is the manual counter-part of
467 the <display_text>Auto-Center</display_text> functionality
471 <display_text>Next Waypoint</display_text> - Center the display on
472 the next waypoint in your route. By default, the next waypoint is
473 colored a slightly darker green than normal waypoints.
476 <display_text>Nearest POI</display_text> - Center the display on
477 the enabled POI nearest to the current view center.
480 <heading>GPS</heading>
482 The <display_text>GPS</display_text> menu is used to access features
483 of the GPS receiver, including textual information not displayed on
484 the map. It is also used to control your connection to the GPS
489 <display_text>Enable GPS</display_text> - Toggle communication
490 with a GPS receiver. You must have a GPS receiver set up in order
491 to use this menu item. When on, Maemo Mapper will constantly
492 search for the GPS receiver.
495 <display_text>Show Information</display_text> - Toggle display of
496 additional information provided by the GPS receiver. This
497 information will appear in the main display as a panel on the
501 <display_text>Details...</display_text> - Show even more
502 information provided by the GPS receiver, including a polar plot
503 of all GPS satellites in view.
506 <display_text>Reset Bluetooth</display_text> - Attempt to reset
507 the bluetooth radio, in case it locks up for some reason. In
508 order for this to succeed, you <i>must</i> add the following line
509 to your /etc/sudoers file (if you don't know what that means,
510 don't try it): <b>user ALL = NOPASSWD: /usr/sbin/hciconfig hci0
514 <heading>Other</heading>
516 In addition to the above menus, there are a few other items in the
521 <display_text>Settings...</display_text> - Access and change
522 settings for using Maemo Mapper. For more information, see <ref
523 refid="help_maemomapper_settings" refdoc="Settings"/>.
526 <display_text>Help...</display_text> - Access this help file.
529 <display_text>About...</display_text> - Display version and
530 copyright information.
533 <display_text>Close</display_text> - Close Maemo Mapper.
538 <topictitle>Context Menu</topictitle>
539 <context contextUID="help_maemomapper_cmenu"/>
541 By tapping and holding on the screen, you can access the context
542 menu to execute actions on either that location, the nearest route
543 waypoint, or the nearest POI.
546 The context menu is separated into two hierarchical levels. The
547 first level (<display_text>Location</display_text>,
548 <display_text>Waypoint</display_text>, or
549 <display_text>POI</display_text>) determines what kind of data on
550 which the operation applies.
552 <heading>Location</heading>
554 The <display_text>Location</display_text> submenu performs actions
555 on the exactly latitude and longitude on which the tap-and-hold
556 operation was performed. With that location, you can do the
561 <display_text>Show Lat/Lon</display_text> - Display the latitude
562 and longitude of the selected location, in the style chosen in
563 <display_text>Settings</display_text>
566 <display_text>Copy Lat/Lon</display_text> - Copy the latitude and
567 longitude of the selected location to the clipboard, in
568 comma-separated decimal format.
571 <display_text>Show Distance to</display_text> - Display the
572 distance (in a straight line) to the selected location.
575 <display_text>Download Route to...</display_text> - Open the
576 <ref refid="help_maemomapper_downroute"
577 refdoc="Download Route"/> dialog with the selected location
578 pre-filled as the destination.
581 <display_text>Add Route Point</display_text> - Add a point to the
582 current route, based on the selected location. The point is not a
586 <display_text>Add Waypoint...</display_text> - Add a waypoint
587 to the current route, based on the selected location. You must
588 provide a description for the waypoint to be legitimate. By
589 specifying an empty description, however, you can create a break
590 in the route. The break will not be connected to the rest of the
591 route, so it can be used to start a new segment.
594 <display_text>Add POI...</display_text> - Add a POI to the POI
595 database, based on the selected location. If the category in
596 which you place the POI is disabled, it will not be visible on the
597 map after creation, but it will still be in the database.
600 <display_text>Set as GPS Position</display_text> - Force Maemo
601 Mapper to consider the selected location to be the current GPS
602 location. This will not affect the current track, but it will
603 change the location of the blue circle that represents your
604 current location, and it can be used to calculate a route from
608 <display_text>Apply Map Correction</display_text> - Enables and
609 disables the application of map correction. When enabling map
610 correction, the tap point is used as the correction reference point.
611 See the note below for more details.
615 Map Correction is a little-used feature that corrects a rare problem
616 with map data. In some locations around the world (like Brazil and
617 Québec), road data from a particular map repository may not be
618 accurate, although the error is consistent. For example, as you
619 travel, you may find that your actual track (as indicated by your
620 GPS receiver) is a few hundred meters away from the road on which
621 Maemo Mapper is drawing your current position. Map Correction fixes
622 this. When your GPS receiver has an accurate fix, and if Maemo
623 Mapper shows your current location as somewhere other than where you
624 expect to be, simply tap-and-hold on the location on the map where
625 you think your current location <i>should</i> be drawn, then select
626 this context menu item. The correction is saved as part of your
627 configuration (so it persists even if you restart Maemo Mapper or
630 <heading>Waypoint</heading>
632 The <display_text>Waypoint</display_text> submenu performs actions
633 on the waypoint nearest to the point on which the tap-and-hold
634 operation was performed. If no waypoints are nearby, an error
635 message will be displayed.
639 <display_text>Show Lat/Lon</display_text> - Show the latitude and
640 longitude of the selected waypoint, in the style chosen in
641 <display_text>Settings</display_text>.
644 <display_text>Show Description</display_text> - Show the
645 description attached to the select waypoint. When downloading
646 routes via the <ref refid="help_maemomapper_downroute"
647 refdoc="Download Route"/> dialog, the description will contain
648 the directions needed to take at that waypoint (e.g. "Turn left at
649 Main Street. Go 2.5 kilometers.").
652 <display_text>Copy Lat/Lon</display_text> - Copy the latitude and
653 longitude of the selected waypoint to the clipboard, in
654 comma-separated decimal format.
657 <display_text>Copy Description</display_text> - Copy the
658 description of the waypoint to the clipboard.
661 <display_text>Show Distance to</display_text> - Show the distance
662 left to be traveled (along the current route) until the selected
663 waypoint. The calculated distance includes the distance between
664 breaks in the route (i.e. between the end of one route segment and
665 the beginning of another route segment).
668 <display_text>Download Route to...</display_text> - Open the
669 <ref refid="help_maemomapper_downroute"
670 refdoc="Download Route"/> dialog with the selected waypoint's
671 location pre-filled as the destination.
674 <display_text>Delete...</display_text> - Delete the selected
675 waypoint from the current route. This will delete all route
676 segments surrounding the route, including (and limited to) all the
677 points from that waypoint to the next and previous waypoints.
680 <display_text>Add POI...</display_text> - Add a POI to the POI
681 database, based on the selected waypoint's location. If the
682 category in which you place the POI is disabled, it will not be
683 visible on the map after creation, but it will still be in the
687 <heading>POI</heading>
689 The <display_text>POI</display_text> submenu performs actions
690 on the POI nearest to the point on which the tap-and-hold operation
691 was performed. If no POIs are nearby, an error message will be
696 <display_text>View/Edit</display_text> - View and/or edit the
700 <display_text>Show Distance to</display_text> - Display the
701 distance (in a straight line) to the selected POI.
704 <display_text>Download Route to...</display_text> - Open the
705 <ref refid="help_maemomapper_downroute"
706 refdoc="Download Route"/> dialog with the selected POI's
707 location pre-filled as the destination.
710 <display_text>Add Route Point</display_text> - Add a point to the
711 current route, based on the selected POI's location. The point is
715 <display_text>Add Waypoint...</display_text> - Add a waypoint
716 to the current route, based on the selected location. You must
717 provide a description for the waypoint to be legitimate. By
718 specifying an empty description, however, you can create a break
719 in the route. The break will not be connected to the rest of the
720 route, so it can be used to start a new segment.
725 <topictitle>Managing Repositories</topictitle>
726 <context contextUID="help_maemomapper_repoman"/>
728 In Maemo Mapper, map data is divided into specific units called
729 <i>repositories</i>. A repository is a source of map data, each of
730 which has its own way of visualizing the Earth. For example,
731 repositories based on street maps typically draw roads as lines and
732 buildings as areas, whereas repositories based on satellite data
733 draw the Earth as it would appear from space. There are also
734 "hybrid" repositories that overlay street map data on top of
735 satellite data, as well as topographical maps that show altitude
739 Each repository is made up of maps at 16 different zoom levels.
740 Zoom Level 0 is the highest resolution (closest to the Earth, i.e.
741 "zoomed in"), and Zoom Level 15 is the lowest resolution (furthest
742 from the Earth, i.e. "zoomed out"). Not all repositories are
743 available at all zoom levels, and some repositories may even produce
744 an error (which you can usually ignore) if you try to download maps
748 Once you have set up at least one repository, you can start
749 downloading maps from that repository to your device's file system.
750 For details on how to do this, see
751 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
754 You can set up any number of repositories in Maemo Mapper, but only
755 one can be active at any given time. The <display_text>Manage
756 Repositories</display_text> dialog is accessed via the
757 <display_text>Manage Repositories...</display_text> menu item of the
758 <display_text>Maps</display_text> menu, and it allows you to add,
759 edit, and remove repositories.
762 The <display_text>Manage Repositories...</display_text> has a combo
763 box that controls which repository is being viewed and edited. When
764 a repository is selected, the controls below it display the current
765 settings, which you can change:
769 <display_text>URL Format</display_text> - A specially formatted
770 string that looks like a URL, but it needs to have at least one
771 printf-style substitution strings (like %f or %s). Normally, you
772 must either get these URL formats from the internet
773 (www.internettablettalk.com is a good source), or you can use the
774 <display_text>Download...</display_text> button in the
775 Repositories dialog box to download a sample.
778 <display_text>Cache DB</display_text> - A database file on the file
779 system (either on the device's internal memory, or an external
780 memory card) in which maps are stored. Maps are kept here
781 indefinitely (until you delete them), so pick a location with a
782 lot of free space. You can use the
783 <display_text>Browse...</display_text> button to select the
784 database file with a graphical file system browser, or you can enter
785 the filename manually. The <display_text>Compact...</display_text>
786 button can be used to compact the database if you have deleted
787 many maps from your database. (Otherwise, deleted space is reused
791 <display_text>Download Zoom Steps</display_text> - Controls which
792 zoom levels should be avoided when automatically downloading maps
793 (i.e. Auto-Download is enabled). The lowest setting (one bar)
794 means to download every zoom level. The highest setting (four
795 bars) causes Maemo Mapper to only download every fourth zoom level
799 <display_text>View Zoom Steps</display_text> - Similar to the
800 above-described <display_text>Download Zoom Steps</display_text>
801 option, except that it controls how Maemo Mapper behaves when
802 zooming. For example, at two bars, pressing
803 <graphic filename="2686KEY_zoom_in"/> causes Maemo Mapper to zoom
804 in two levels instead of just one. Setting this equal to
805 <display_text>Download Zoom Steps</display_text> ensures that you
806 see all maps at their native resolution.
809 <display_text>Double Pixels</display_text> - This forces Maemo
810 Mapper to avoid using the native resolution of any maps, instead
811 using pixel-doubling. This is useful if your repository's maps
812 contain small, hard-to-read text, and you want to double the size
813 of the images to make them more readable. This setting can also
814 affect the zoom levels that are downloaded when Auto-Download is
818 <display_text>Next-able</display_text> - This oddly-named option
819 determines whether or not the "Select Next Repository" action
820 (which can be mapped to any of the hardware keys) will be able to
821 select this repository. When unset, the "Select Next Repository"
822 action will simply skip over this repository.
825 <display_text>Downloadable Zooms</display_text> - This setting
826 governs the minimum and maximum zoom levels Maemo Mapper should
827 attempt to automatically download for this repository (when
828 Auto-Download is enabled). Some repositories support more zoom
829 levels than others, and supported zoom levels may even vary from
830 location to location.
834 In addition to the per-repository controls, there are a few buttons
835 that provide additional functionality:
839 <display_text>Rename...</display_text> - Renames the currently
843 <display_text>Delete...</display_text> - Deletes the currently
847 <display_text>New...</display_text> - Adds a new repository. See
848 <ref refid="help_maemomapper_newrepo" refdoc="New Repositories"/>.
851 <display_text>Reset...</display_text> - Resets your repository
852 list to the factory default. This will remove all of your
853 repositories and replace them with the single default repository
854 that comes with Maemo Mapper.
857 <display_text>Download...</display_text> - Downloads information
858 about several preset repositories, and adds them to your
859 repository list. They will be appended to any existing
860 repositories you already have. They are not read-only - you may
861 edit them as you wish. This is a good way to get started.
865 Certain repositories (most notably, the commercial ones) may
866 have license agreements attached with their use. It may be
867 illegal to use a certain repository with Maemo Mapper or under
868 certain conditions. This includes the repositories downloaded
869 via the <display_text>Download...</display_text> button. If you
870 are not sure if you are legally allowed to use a particular
871 repository, you should delete it from your list of repositories.
872 The authors of Maemo Mapper cannot be held responsible for your
873 use of a particular repository.
877 <topictitle>Repository Types</topictitle>
878 <context contextUID="help_maemomapper_newrepo"/>
880 Over the years, Maemo Mapper has used several different types of
881 backing databases to store downloaded maps. Currently, Maemo Mapper
882 supports two different types of backing map databases.
886 <display_text>SQLite 3 (default)</display_text> - The new default
887 backing database format since Maemo Mapper v2.6, SQLite 3 provides
888 better reliability. It also scales somewhat better than GDBM and is
889 not subject to file size limitations, making it the only choice for
890 large map databases. This is the preferred format, and should
891 generally be used for all new databases.
894 <display_text>GDBM (legacy)</display_text> - The database format
895 of versions of Maemo Mapper prior to v2.6. It is slightly less
896 reliable than SQLite, and GDBM files are limited to 2 gigabytes.
897 These limitations, however, allow it to perform slightly faster
898 than SQLite for small map databases. If you are unsatisfied with
899 SQLite's performance in Maemo Mapper, you can take your chances with
905 <topictitle>Managing Maps</topictitle>
906 <context contextUID="help_maemomapper_mapman"/>
908 In Maemo Mapper, <i>repositories</i> represent sources of map data,
909 and <i>maps</i> are just image files (e.g. PNG or JPEG) that are
910 drawn onto the screen. Once you have a repository set up (see
911 <ref refid="help_maemomapper_repoman"
912 refdoc="Managing Repositories"/>), you can download maps from a
913 repository into a Map Cache, which is just a database file on your
914 device's file system.
917 Maemo Mapper downloads maps from the current repository so that they
918 can be drawn onto the screen and later recalled from disk, instead
919 of downloading a map every time it is needed. This is called
920 <i>caching</i>, and it allows you to use Maemo Mapper even when you
921 are not connected to the internet.
924 Because Maemo Mapper downloads maps to your device's file system,
925 you must be aware of how much disk space your maps are taking up,
926 especially if you enable Auto-Download. If space is a concern, you
927 may also choose to go without a cache entirely. You can do this by
928 leaving the Map Cache DB field blank in the <display_text>Manage
929 Repositories</display_text> dialog. Note that this will cause Maemo
930 Mapper to download maps each time they are needed. If you are using
931 a cellular data plan that charges per kilobyte, you probably want to
932 use a cache. For more information about repositories and the
933 <display_text>Manage Repositories</display_text> dialog, see
934 <ref refid="help_maemomapper_repoman"
935 refdoc="Managing Repositories"/>.
938 Aside from the Auto-Download functionality, you can also download
939 maps manually using the <display_text>Manage Maps...</display_text>
940 menu item of the <display_text>Maps</display_text> menu. The
941 <display_text>Manage Maps</display_text> dialog allows you to
942 download, overwrite, or delete maps, either by area or along your
943 current route. It contains up to three tabs, all of which control
944 which and how many maps are downloaded.
946 <heading>Setup</heading>
948 The <display_text>Setup</display_text> tab controls what you what to
949 do. You can download maps (optionally overwriting
950 already-downloaded maps) from the current repository to your
951 device's file system, or you can delete maps (pertaining to the
952 current repository) from your device's file system. Both of these
953 operations can be done either over a rectangular area or along your
958 <display_text>Download Maps</display_text> - If selected, Maemo
959 Mapper will download maps from the current repository to your
960 device's file system, for the area you specify. By default, Maemo
961 Mapper only downloads the maps that you don't already have.
964 <display_text>Overwrite</display_text> - If selected, then Maemo
965 Mapper will download maps and overwrite any maps that you may have
969 <display_text>Delete Maps</display_text> - If selected, Maemo
970 Mapper will delete maps from your file system, for the area you
974 <display_text>By Area</display_text> - If selected, Maemo Mapper
975 will download or delete maps for a particular rectangular area of
976 the world, based on the latitude and longitude of an upper-left
977 and lower-right corner. See the <display_text>Area</display_text>
978 tab to specify the coordinates.
981 <display_text>Along Route</display_text> - If selected, Maemo
982 Mapper will download or delete maps along your current route.
983 This is useful if, for example, you are about to embark on a trip
984 and want to make sure that you have maps for all points along the
988 <display_text>Radius (tiles)</display_text> - If
989 <display_text>Along Route</display_text> is selected, then you can
990 specify the radius around your route for which maps will be
991 downloaded or deleted. For example, if you specify 4 (the
992 default), then Maemo Mapper will download all tiles that are
993 within 4 tiles of your route.
996 <heading>Zoom</heading>
998 The <display_text>Zoom</display_text> tab controls which zoom levels
999 at which maps are downloaded or deleted. The current zoom level is
1000 selected by default, but you can enable or disable any zoom levels
1003 <heading>Area</heading>
1005 The <display_text>Area</display_text> tab, available if the
1006 <display_text>By Area</display_text> option is selected in the
1007 <display_text>Setup</display_text> tab, defines the rectangular area
1008 of the world for which maps will be downloaded or deleted. If
1009 applicable, the fields are pre-filled to specify the area
1010 visible on-screen. This allows you to graphically change your
1011 rectangle simply by zooming in and panning to see the area you
1016 <topictitle>Downloading Routes</topictitle>
1017 <context contextUID="help_maemomapper_downroute"/>
1019 Route data can be loaded from GPX files, like the ones provided by
1020 the GPX Driving Directions web service
1021 (http://www.gnuite.com/cgi-bin/gpx.cgi). Or, route data can be
1022 downloaded directly within Maemo Mapper using the
1023 <display_text>Download Route</display_text> dialog.
1026 Downloading routes requires an active connection to the internet,
1027 but once a route is loaded into Maemo Mapper, the internet
1028 connection is no longer needed (unless
1029 <display_text>Auto-Update</display_text> is enabled). The route
1030 download functionality in Maemo Mapper actually uses the
1031 aforementioned GPX Driving Directions web service.
1034 To download a route, you must specify an
1035 <display_text>Origin</display_text> and a
1036 <display_text>Destination</display_text>. The GPX Driving
1037 Directions web service will return a route taking you from the
1038 origin to the destination.
1041 The <display_text>Download Route</display_text> dialog contains the
1046 <display_text>Source URL</display_text> - The web service from
1047 which driving directions are retrieved. The default is fine, and
1048 it is usually left unchanged.
1051 <display_text>Auto-Update</display_text> - This option, only
1052 available if <display_text>Use GPS Location</display_text> is
1053 enabled, will cause Maemo Mapper to automatically re-download a
1054 new route if you stray from the route. Note that you must have a
1055 continuous connection to the internet (i.e. cellular data service)
1056 for Auto-Update to work.
1059 <display_text>Use GPS Location</display_text> - If selected, then
1060 the current GPS location will be used as the
1061 <display_text>Origin</display_text>.
1064 <display_text>Use End of Route</display_text> - If selected, then
1065 the end of the route will be used as the
1066 <display_text>Origin</display_text>. This is useful for stringing
1067 together multiple route downloads into a single route.
1070 <display_text>Origin</display_text> - If selected, then you must
1071 enter your own origin. An origin can be specified in any format
1072 understood by Google Maps. Some examples: "25, -43" (lat/lon),
1073 "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
1074 "5th and Main, 12151". In fact, if your route download fails with
1075 a "Could not generate directions" error message, you can use
1076 Google Maps to test your origin for accuracy.
1079 <display_text>Destination</display_text> - The destination to
1080 which the directions will lead. Like the
1081 <display_text>Origin</display_text>, a destination can be
1082 specified in any format understood by Google Maps.
1087 <topictitle>Downloading POIs</topictitle>
1088 <context contextUID="help_maemomapper_downpoi"/>
1090 Points of Interest (POIs) can be loaded from GPX files, like the
1091 ones provided by the GPX POI Search web service
1092 (http://www.gnuite.com/cgi-bin/poi.cgi). Or, POI data can be
1093 downloaded directly within Maemo Mapper using the
1094 <display_text>Download POIs</display_text> dialog.
1097 Downloading POIs requires an active connection to the internet,
1098 but once a POI is loaded into Maemo Mapper, the POI is accessible in
1099 Maemo Mapper regardless of whether or not you are connected to the
1100 internet. The POI download functionality in Maemo Mapper actually
1101 uses the aforementioned GPX POI Search web service.
1104 To search for POIs, you enter an <display_text>Origin</display_text>
1105 and a <display_text>Query</display_text>. The GPX POI Search web
1106 service will return up to 10 matching POIs in the vicinity of the
1107 origin. You can access more POIs from the same query by using the
1108 <display_text>Page</display_text> modifier.
1111 Once you have downloaded POIs, they are automatically added to your
1112 POI database, and you are presented with the <display_text>POI
1113 List</display_text> dialog to to review the POIs that were
1114 downloaded and added to your database. You must manually remove any
1115 POIs that you don't want in your database. For more information
1116 about the <display_text>POI List</display_text> dialog and
1117 deleting POIs, see <ref refid="help_maemomapper_poilist"
1118 refdoc="POI List"/>.
1121 The <display_text>Download POIs</display_text> dialog contains the
1126 <display_text>Source URL</display_text> - The web service from
1127 which POIs are retrieved. The default is fine, and it is usually
1131 <display_text>Use GPS Location</display_text> - If selected, then
1132 the current GPS location will be used as the
1133 <display_text>Origin</display_text>.
1136 <display_text>Use End of Route</display_text> - If selected, then
1137 the end of the route will be used as the
1138 <display_text>Origin</display_text>. This is useful for searching
1139 for points of interests (like hotels or restaurants) near your
1140 current destination.
1143 <display_text>Origin</display_text> - If selected, then you must
1144 enter your own origin. An origin can be specified in any format
1145 understood by Google Maps. Some examples: "25, -43" (lat/lon),
1146 "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
1147 "5th and Main, 12151". In fact, if your route download fails with
1148 a "Could not generate directions" error message, you can use
1149 Google Maps to test your origin for accuracy.
1152 <display_text>Category</display_text> - Specifies the default
1153 category in which all resulting POIs will be placed. You can
1154 always change the category later. If you have not yet entered a
1155 <display_text>Query</display_text> when you select a category,
1156 then the name of the category will be entered into the
1157 <display_text>Query</display_text> field for you. This allows you
1158 to, for example, quickly search for restaurants and put them in
1159 the Restaurant category.
1162 <display_text>Page</display_text> - Specifies the page of results
1163 that you want to retrieve. Think of it as the page number in a
1164 web search. Page 1 contains the first 10 results. Page 2
1165 contains results 10-19. And so on.
1168 <display_text>Query</display_text> - A free-form text query that
1169 describes the POIs for which you are searching. This can be
1170 anything from "food" to "hairstylist" to "museum." Note that the
1171 selected <display_text>Category</display_text> is not part of the
1172 query unless you explicitly include it in the
1173 <display_text>Query</display_text> field.
1178 <topictitle>Browsing POIs</topictitle>
1179 <context contextUID="help_maemomapper_browsepoi"/>
1181 Once you have imported or downloaded POIs into your POI database,
1182 you can use the <display_text>Browse POIs</display_text> dialog to
1183 search for certain POIs in your database and to view those POIs in a
1187 To browse for POIs, you enter an <display_text>Origin</display_text>
1188 and a optional <display_text>Query</display_text>. Maemo Mapper
1189 will search the database for all POIs matching your query, and it
1190 will calculate the distance from each POI to your specified
1191 <display_text>Origin</display_text>. You may also filter your
1192 results by <display_text>Category</display_text>.
1195 Once your search is performed, you are taken to the
1196 <display_text>POI List</display_text> dialog, where you can view,
1197 edit, and delete any of the POIs that matched your query. For more
1198 information about the <display_text>POI List</display_text> dialog
1199 and editing POIs, see <ref refid="help_maemomapper_poilist"
1200 refdoc="POI List"/>.
1203 The <display_text>Browse POIs</display_text> dialog contains the
1208 <display_text>Use GPS Location</display_text> - If selected, then
1209 the current GPS location will be used as the
1210 <display_text>Origin</display_text>.
1213 <display_text>Use End of Route</display_text> - If selected, then
1214 the end of the route will be used as the
1215 <display_text>Origin</display_text>. This is useful for searching
1216 for points of interests (like hotels or restaurants) near your
1217 current destination.
1220 <display_text>Origin</display_text> - If selected, then you must
1221 enter your own origin. An origin can be specified in any format
1222 understood by Google Maps. Some examples: "25, -43" (lat/lon),
1223 "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
1224 "5th and Main, 12151". In fact, if your route download fails with
1225 a "Could not generate directions" error message, you can use
1226 Google Maps to test your origin for accuracy.
1229 <display_text>Category</display_text> - Filters the results based
1230 on the selected category.
1233 <display_text>Query</display_text> - An optional substring which
1234 must appear in either the label or description of a POI in order
1235 for the POI to match. Any spaces, commas, or other punctiation in
1236 the query must also be in the label or description. If left
1237 blank, then all POIs are matched.
1242 <topictitle>POI List</topictitle>
1243 <context contextUID="help_maemomapper_poilist"/>
1245 The <display_text>POI List</display_text> dialog is a tabular
1246 display of POIs. With this dialog, you can go to a specific POI,
1247 edit POIs, change the categories of a set of POIs, delete POIs, and
1248 export POIs to the GPX file format.
1251 The main view of the <display_text>POI List</display_text> dialog is
1252 a table with five columns, all of which (except the checkbox) can be
1253 sorted by tapping on the appropriate header:
1257 <display_text>*</display_text> - This checkbox column contains a
1258 checkbox for each POI in the table. All of the POIs that are
1259 checked will be affected by operations in the
1260 <display_text>Checked POI Actions</display_text> dialog, described
1261 later. You can tap on the column header to enable or disable
1262 all of the checkboxes at once. Note that this checkbox has no
1263 effect on whether or not the POI is visible in the map.
1266 <display_text>Category</display_text> - The category in which the
1267 POI belongs. Categories can be edited, enabled, and disabled with
1268 the <display_text>POI Categories</display_text> dialog. For more
1269 information about the <display_text>POI Categories</display_text>
1270 dialog, see <ref refid="help_maemomapper_poicat"
1271 refdoc="POI Categories"/>
1274 <display_text>Dist.</display_text> - The distance from the Origin
1278 <display_text>Bear.</display_text> - The bearing (in degrees from
1279 true north) from the Origin to the given POI. A bearing of zero
1280 or 360 means that the POI is due north of the Origin. 90 means
1281 east; 180 means south; and 270 means west.
1284 <display_text>Label</display_text> - The label of the POI.
1288 Below the table are four buttons:
1292 <display_text>Go to</display_text> - Pans the map display to the
1293 currently selected POI (i.e. the currently highlighted row).
1294 Remember that you can tap and hold on the title bar of the dialog
1295 in order to see the map behind it.
1298 <display_text>Edit...</display_text> - Opens the
1299 <display_text>Edit POI</display_text> dialog for the currently
1300 selected POI (i.e. the currently highlighted row). You can also
1301 double-tap on a row in the table to open this dialog.
1304 <display_text>Checked POI Actions...</display_text> - Opens the
1305 <display_text>Checked POI Actions</display_text> dialog, which
1306 allows you to perform actions on the currently checked POIs in the
1307 table. From that dialog, you can set the categories of the
1308 checked POIs, delete the checked POIs, and/or export the checked
1312 <display_text>Close</display_text> - Closes the <display_text>POI
1313 List</display_text> dialog.
1318 <topictitle>POI Categories</topictitle>
1319 <context contextUID="help_maemomapper_poicat"/>
1321 POI Categories are a means by which you can organize your POIs for
1322 selective display. The <display_text>POI Categories</display_text>
1323 dialog is accessed from the <display_text>View</display_text> menu
1324 and allows you to enable/disable, add, edit, or delete categories.
1327 Each row in the table represents a category. There are three
1328 columns displayed for each category:
1332 <display_text>Enabled</display_text> - Controls whether or not
1333 POIs in this category are drawn on the map.
1336 <display_text>Label</display_text> - A short label to describe the
1337 category. This is the name that will be visible when viewing a
1341 <display_text>Description</display_text> - A longer description of
1342 the category. This description is not visible anywhere except in
1343 this dialog; it is only used to get an idea of how the category is
1348 Selecting a row in the table and pressing the
1349 <display_text>Edit</display_text> button will allow you to edit the
1350 above three attributes of a category, and to delete a category. You
1351 can also add a new category by using the
1352 <display_text>Add</display_text> button.
1355 A POI may only be associated with a single category at a time.
1357 <heading>POI Icons</heading>
1359 Icons can be customized on a per-POI or per-category basis, and/or
1360 you may provide a custom default icon for all POIs. To do so, you
1361 should place icon files in the same directory as the POI database
1362 itself. Most image file formats are supported, but the files
1363 themselves <i>must</i> have the ".jpg" extension (even if the icons
1364 are not in the JPEG format).
1367 To customize the default POI icon (to be used instead of the simple
1368 square), place an icon file called "poi.jpg" in the same directory
1369 as the POI database.
1372 To customize the icon for a POI category, place an icon file with
1373 the same name as the POI category, all lower-case, plus the ".jpg"
1374 extension. For example, if your POI category is called "Gas
1375 Stations", the file should have the name "gas stations.jpg".
1378 To customize the icon for a specific POI, place an icon file with
1379 a name equal to the POI's label, all lower-case, plus the ".jpg"
1380 extension. For example, if your POI's label is "Joe's House",
1381 the file should have the name "joe's house.jpg".
1384 POI-specific icons are given priority over category-specific icons,
1385 which in turn are given priority over the default POI icon.
1389 <topictitle>Settings</topictitle>
1390 <context contextUID="help_maemomapper_settings"/>
1392 The <display_text>Settings</display_text> dialog (accessible from
1393 the main menu) provides access to a plethora of configurable options
1394 that control how Maemo Mapper appears and runs. In addition to the
1395 tabs, which are described below, there are also two buttons at the
1396 bottom of the diagram labeled <display_text>Hardware
1397 Keys...</display_text> and <display_text>Colors...</display_text>.
1400 The <display_text>Hardware Keys...</display_text> button brings up
1401 another dialog box, which allows you to customize the actions that
1402 each hardware key causes. For example, you can map the
1403 <graphic filename="2686KEY_esc"/> button to cycle through map
1404 repositories, giving you quick access to switching among them.
1407 The <display_text>Colors...</display_text> button allows you to
1408 customize the colors that are used for drawing on-map objects.
1410 <heading>GPS</heading>
1412 The <display_text>GPS</display_text> tab tells Maemo Mapper the
1413 source (if any) from which to retrieve GPS data. It is only
1414 applicable if you have access to a GPS source, such as a bluetooth
1415 GPS receiver or a GPSD server. Technically, Maemo Mapper uses GPSD
1416 for all of its GPS receiver communication, but you can instruct
1417 Maemo Mapper to use GPSD in one of three ways:
1421 <display_text>Bluetooth</display_text> - Select this option
1422 if you are using a bluetooth GPS receiver, and enter the
1423 MAC address in the field provided. If you don't know the MAC
1424 address, turn on your receiver and press the
1425 <display_text>Scan...</display_text> button to select it from a
1426 list of nearby bluetooth devices. Or, leave the field blank and
1427 Maemo Mapper will automatically try to use any bluetooth GPS
1428 receivers that it can identify. This
1429 option is also appropriate if you are running Maemo Mapper on a
1430 device with an internal GPS receiver, in which case you should
1431 leave the field blank.
1434 <display_text>File Path</display_text> - Select this option to use
1435 a device file on your file system, such as an RFCOMM device, and
1436 specify the pathname of the file in the appropriate field.
1439 <display_text>GPSD Host</display_text> - Select this option if you
1440 want to connect Maemo Mapper to any GPSD server (local or remote).
1441 Enter the hostname and port of the server in the fields provided.
1442 The default values (127.0.0.1 on port 2947) cause Maemo Mapper to
1443 use the local GPSD server, if available.
1446 <heading>Auto-Center</heading>
1448 The <display_text>Auto-Center</display_text> tab allows you to
1449 configure how Maemo Mapper automatically re-centers the display when
1450 either <display_text>Lat/Lon</display_text> or
1451 <display_text>Lead</display_text> is enabled from the
1452 <display_text>Auto-Center</display_text> menu. The Auto-Center
1453 feature is most useful in conjunction with a GPS receiver.
1457 <display_text>Lead Amount</display_text> - When Auto-Center is set
1458 to <display_text>Lead</display_text>, then Maemo Mapper will keep
1459 the center of the screen focused on an area in front of you. When
1460 driving, this allows you to view more of the road ahead of you.
1461 The distance in front of you on which the screen is centered is
1462 based on two variables: your current speed and the value of the
1463 <display_text>Lead Amount</display_text> option.
1466 <display_text>Fixed</display_text> - Controls whether or not your
1467 lead amount is affected by your speed. If checked, then your
1468 speed will not affect the lead amount.
1471 <display_text>Pan Sensitivity</display_text> - Controls how often
1472 Maemo Mapper re-centers the display, based on how close your
1473 position (or the position of your <i>lead</i>) gets to the edge of
1474 the screen. When set to a low value, Maemo Mapper will only
1475 re-center the screen when you are near the edge of the screen.
1476 When set to the maximum, Maemo Mapper will keep your position as
1477 close to the center as possible.
1480 <display_text>Min. Speed</display_text> - Controls how fast you
1481 must be moving in order for Auto-Center (and Auto-Rotate) to
1482 activate. For example, walkers may wish to set this threshold
1483 low, while drivers with inaccurate GPS receivers may wish to set
1484 this high (to avoid spurious auto-rotates when parked or waiting
1485 at a red light). The speed is specified in your chosen units.
1488 <display_text>Rotate Sensit.</display_text> - Controls how often
1489 Maemo Mapper rotates the display based on your heading, depending
1490 on how far your current rotation is from your heading rotation.
1493 <display_text>Points</display_text> - Controls which direction
1494 on the screen your heading points to when auto-rotating. The
1495 default is for your current heading to point up.
1498 <heading>Announce</heading>
1500 The <display_text>Announce</display_text> tab controls how and when
1501 Maemo Mapper displays or speaks waypoint information. When you
1502 approach a waypoint in your route (defined by the presence of a
1503 description in the GPX file), Maemo Mapper will pop up a text box
1504 with the contents of that description. When downloading routes from
1505 within Maemo Mapper, the text describes your next action, e.g. "Turn
1506 left at Main Street. Go 2.4 miles."
1509 As you approach a waypoint, Maemo Mapper will continue to display
1510 the description of that waypoint, so long as you are within the
1511 range defined by the <display_text>Advance Notice</display_text>
1512 option, or until you pass the waypoint. Because the amount of
1513 notice is dependent on your speed, it is possible to see the text,
1514 then slow down to a point where the notice disappears. This is
1515 possible, for example, if you are stopped at a red light. The text
1516 will reappear when you have picked up enough speed to again break
1517 the <display_text>Advance Notice</display_text> range.
1520 If you have installed <i>flite</i>, which is available in the same
1521 repository from which you downloaded Maemo Mapper, then Maemo Mapper
1522 can optionally also speak the same directions that appear on screen.
1523 Maemo Mapper will only speak the directions once, at the exact
1524 moment you first reach the distance from the waypoint defined by the
1525 <display_text>Advance Notice</display_text> option. The same
1526 directions are on-screen if you need to reference them.
1530 <display_text>Advance Notice</display_text> - Controls how much in
1531 advance Maemo Mapper begins to provide the waypoint description.
1532 The exact distance at which Maemo Mapper begins to announce a
1533 waypoint also depends on your speed, so the value of this option
1534 can be thought of more accurately in units of time. At the
1535 minimum value, Maemo Mapper gives you almost no notice. At the
1536 maximum value, Maemo Mapper gives you about two minutes of notice.
1537 Experiment to find your happy medium.
1540 <display_text>Enable Voice Synthesis</display_text> - If you have
1541 installed <i>flite</i>, this option will cause Maemo Mapper to
1542 speak the description of the next waypoint when you enter the
1543 range defined by the <display_text>Advance Notice</display_text>
1547 <heading>Misc.</heading>
1549 The <display_text>Misc.</display_text> and <display_text>Misc.
1550 2</display_text> tabs contain miscellaneous options.
1554 <display_text>Line Width</display_text> - Controls the thickness
1555 of all lines drawn on top of the map images. This includes your
1556 mark, all tracks and routes, and the default POI image.
1559 <display_text>Unblank Screen</display_text> - Controls when Maemo
1560 Mapper keeps the display on without user input. When set to
1561 <display_text>When Receiving Any GPS Data</display_text>, Maemo
1562 Mapper will keep the screen on whenever a GPS receiver is
1563 connected and producing data. When set to
1564 <display_text>Never</display_text>, Maemo Mapper will not attempt
1565 to keep the screen on, and the screen will go blank after a period
1566 of inactivity on the user's part. The default is
1567 <display_text>When Moving (Full Screen Only)</display_text>
1570 <display_text>Info Font Size</display_text> - Controls the font
1571 size for all information that is popped up to the user in the
1572 upper-right corner, including waypoint descriptions.
1575 <display_text>Units</display_text> - Controls the units in which
1576 distances and speeds are displayed in the user interface.
1579 <display_text>Degrees Format</display_text> - Controls how
1580 latitude and longitudes are displayed in the user interface.
1583 <display_text>Auto-Download Pre-cache</display_text> - Controls
1584 how much of the world surrounding the view Maemo Mapper should
1585 download when <display_text>Auto-Download</display_text> is
1586 enabled. When set to the minimum, Maemo Mapper will only download
1587 the maps that are required to draw the screen. As you pan around
1588 the world, you will see black areas where Maemo Mapper has not yet
1589 downloaded maps, until those maps are downloaded. If you increase
1590 the Pre-cache amount, the Maemo Mapper will download more of the
1591 surrounding areas, making it less likely that you ever actually
1592 see black areas. A general rule of thumb is to limit the
1593 Pre-cache based on the bandwidth of your internet connection, but
1594 the default setting (two bars) is usually sufficient for most
1598 <display_text>Speed Limit</display_text> - Enables notification
1599 when you have exceeded the given speed limit (specified in the
1600 units defined via the <display_text>Units</display_text> option).
1603 <display_text>Location</display_text> - Controls the location on
1604 the screen of the speed warning.
1607 <heading>POI</heading>
1609 The <display_text>POI</display_text> tab allows you to define your
1610 POI database and how POIs are drawn on the screen.
1614 <display_text>POI database</display_text> - The location on the
1615 file system where the POI database is located. The database must
1616 be in sqlite3 format. A default (empty) POI database is
1617 automatically created for you when you first run Maemo Mapper.
1620 <display_text>Show POI below zoom</display_text> - Defines the
1621 maximum zoom (furthest away from the Earth) at which POIs will be
1622 drawn. When zoomed out beyond this level, no POIs will be drawn.
1627 <topictitle>About Maemo Mapper</topictitle>
1628 <context contextUID="help_maemomapper_about"/>
1630 Current Version: 2.6.2
1633 Maemo Mapper was created and developed by John Costigan (aka
1634 <display_text>gnuite</display_text>).
1637 Copyright © 2006-2008 John Costigan.
1640 POI and GPS-Info code originally written by Cezary Jackiewicz.
1643 Default map data provided by http://www.openstreetmap.org/ - other
1644 map repositories are subject to their own licenses and may or may not
1645 be suitable for use with Maemo Mapper. It may be illegal to use a
1646 certain repository with Maemo Mapper or under certain conditions. This
1647 includes the repositories downloadable directly in Maemo Mapper. If
1648 you are not sure if you are legally allowed to use a particular
1649 repository, you should delete it from your list of repositories. The
1650 authors of Maemo Mapper cannot be held responsible for your use of a
1651 particular repository.
1654 Maemo Mapper is free software: you can redistribute it and/or modify it
1655 under the terms of the GNU General Public License as published by the
1656 Free Software Foundation, either version 3 of the License, or (at your
1657 option) any later version.
1660 Maemo Mapper is distributed in the hope that it will be useful, but
1661 WITHOUT ANY WARRANTY; without even the implied warranty of
1662 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1663 General Public License for more details.