3 - Copyright (C) 2006, 2007 John Costigan.
5 - This file is part of Maemo Mapper.
7 - Maemo Mapper is free software: you can redistribute it and/or modify
8 - it under the terms of the GNU General Public License as published by
9 - the Free Software Foundation, either version 3 of the License, or
10 - (at your option) any later version.
12 - Maemo Mapper is distributed in the hope that it will be useful,
13 - but WITHOUT ANY WARRANTY; without even the implied warranty of
14 - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 - GNU General Public License for more details.
17 - You should have received a copy of the GNU General Public License
18 - along with Maemo Mapper. If not, see <http://www.gnu.org/licenses/>.
22 <?xml version="1.0" encoding="UTF-8"?>
23 <?xml-stylesheet type="text/xsl" href="../tohtml.xsl?root=maemo-mapper"?>
26 <title>Maemo Mapper</title>
28 <topictitle>Introduction</topictitle>
29 <context contextUID="help_maemomapper_intro"/>
30 <para>Welcome to Maemo Mapper.</para>
32 Maemo Mapper is a geographical mapping tool that can be used to:
36 Download map data to your device's main memory or to an external
40 View that map data on the screen.
43 Navigate that map data by panning around the screen and zooming in
47 Display your position and other GPS information from a GPS
51 Store and display Point-of-Interest (POI) data.
54 Download directions between arbitrary points on the map.
57 Save or open track data or route data.
61 Use the <ref refid="help_maemomapper_" refdoc="index"/> to peruse the
62 various sections of this help document, or go to <ref
63 refid="help_maemomapper_getstarted" refdoc="Getting Started"/> to
64 get up and running quickly.
68 <topictitle>Getting Started</topictitle>
69 <context contextUID="help_maemomapper_getstarted"/>
71 When you first start Maemo Mapper, you will be presented with the
72 <display_text>Settings</display_text> dialog box. Most of the
73 settings have reasonable defaults, but if you have a GPS receiver,
74 you should fill in the <display_text>Bluetooth</display_text> field
75 with the MAC address of your GPS receiver. If you don't know the
76 MAC, turn on your GPS receiver and push the
77 <display_text>Search</display_text> button. Maemo Mapper will
78 attempt to automatically discover the MAC address of your receiver.
79 For more information about the <display_text>Settings</display_text>
80 dialog box, see <ref refid="help_maemomapper_settings"
84 Alternatively, you can leave the
85 <display_text>Bluetooth</display_text> field blank, and Maemo Mapper
86 will attempt to automatically search for and use any bluetooth GPS
87 receivers that it can identify. This is particularly useful if you
88 tend to use multiple different GPS receivers. This feature is not
89 guaranteed to work on all Nokia devices or with all bluetooth GPS
93 If you are using Maemo Mapper on a device with an internal GPS
94 receiver, then you should probably use the "Bluetooth" receiver type
95 and leave the field empty.
98 When you are finished setting up Maemo Mapper to your preferences,
99 pressing the <display_text>Ok</display_text> button will lead you to
100 another dialog box: the <display_text>Manage
101 Repositories</display_text> dialog.
104 To get started quickly, press the
105 <display_text>Download...</display_text> button. Maemo Mapper will
106 download a set of pre-defined repository information for you to use.
107 If you use the pre-defined repositories, you can delete the
108 <display_text>Default</display_text> repository. For more
109 information about repositories and the <display_text>Manage
110 Repositories</display_text> dialog, see
111 <ref refid="help_maemomapper_repoman"
112 refdoc="Managing Repositories"/>.
115 Certain repositories (most notably, the commercial ones) may have
116 license agreements attached with their use. It may be illegal to
117 use a certain repository with Maemo Mapper or under certain
118 conditions. This includes the repositories downloaded via the
119 <display_text>Download...</display_text> button. If you are not
120 sure if you are legally allowed to use a particular repository, you
121 should delete it from your list of repositories. The authors of
122 Maemo Mapper cannot be held responsible for your use of a particular
126 Once you have your Repositories set up the way you like, press the
127 Ok button, and you will be presented with a blank screen, because
128 you have not yet actually downloaded any map data to your device.
129 To allow Maemo Mapper to automatically download map data as it
130 becomes needed on the display, enable the
131 <display_text>Auto-Download</display_text> checkbox in the
132 <display_text>Maps</display_text> menu.
135 If you have a working internet connection, Maemo Mapper will attempt
136 to download maps and display them on the screen automatically as
137 the downloads complete. You should see a map of the world. Be
138 careful when you enable Auto-Download, because it can quickly fill
139 your available disk space. See
140 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/> for
141 details on how to manage disk space for a particular repository.
143 <heading>The Graphical User Interface</heading>
145 The main view of Maemo Mapper emphasizes simplicity. By default,
146 the map is all that is displayed. You current position (if you have
147 a GPS receiver) is indicated by a blue circle. The blue line
148 extending from the blue circle indicates your current heading and
149 speed. <i>Tracks</i> are red and represent where you have been.
150 <i>Routes</i> are green and represent where you want to go, i.e.
151 directions to a location.
154 The hardware buttons on your device provide quick access to common
159 <graphic filename="2686KEY_full_screen"/> - Toggle
163 <graphic filename="2686KEY_zoom_in"/> - Zoom In - hold down to
164 zoom multiple levels at a time
167 <graphic filename="2686KEY_zoom_out"/> - Zoom Out - hold down to
168 zoom multiple levels at a time
171 <graphic filename="2686KEY_scroll_up"/> - Pan Up - hold down to
175 <graphic filename="2686KEY_scroll_down"/> - Pan Down - hold down
179 <graphic filename="2686KEY_scroll_left"/> - Pan Left - hold down
183 <graphic filename="2686KEY_scroll_right"/> - Pan Right - hold down
187 <graphic filename="2686KEY_scroll_center"/> - Toggle Auto-Center
190 <graphic filename="2686KEY_esc"/> - Programmable; defaults
191 to: Hide/Show Tracks and Routes
195 You can also pan around the map by tapping on the screen. Maemo
196 Mapper will center the display on where you tapped. If you had
197 <display_text>Auto-Center</display_text> enabled, tapping a location
198 to center on it will automatically disable that functionality.
201 From this point, you can use the menus to manage routes, tracks, and
202 map data; to change the view; to change settings; or to see detailed
203 GPS information (if you have a GPS receiver).
206 There is also a context-sensitive menu that appears on the map when
207 you tap and hold a location on the map. From that menu, you can
208 download directions, calculate distances, or add/modify
209 Point-of-Interest (POI) data.
212 For help with any of these features, use the
213 <ref refid="help_maemomapper_" refdoc="index"/>.
217 <topictitle>Main Menu</topictitle>
218 <context contextUID="help_maemomapper_mainmenu"/>
220 This help topic describes the functionality of each of the menu
221 items in Maemo Mapper.
223 <heading>Route</heading>
225 The <display_text>Route</display_text> menu is used to manipulate
226 the current <i>route</i>. A route in Maemo Mapper is defined as a
227 set of points and waypoints describing <i>where you would like to
228 go</i>, e.g. driving directions from 123 Main Street to 456 Elm
229 Street. It can include multiple segments. The current route is
230 empty until you open or download a route.
233 The <display_text>Route</display_text> menu has the following menu
238 <display_text>Open...</display_text> - Open a route from a GPX
239 file on the file system. The opened route is <i>appended</i> to
240 the current route, so you can string together different routes
241 together to create a trip with multiple destinations.
244 <display_text>Download...</display_text> - Download a route from
245 the internet. See <ref refid="help_maemomapper_downroute"
246 refdoc="Download Route"/> for more information.
249 <display_text>Save...</display_text> - Save the current route to a
250 GPX file on the file system.
253 <display_text>Show Distance to Next Waypoint</display_text> - Show
254 the distance left to be traveled (along the current route) until
258 <display_text>Show Distance to End of Route</display_text> - Show
259 the distance left to be traveled (along the current route) until
260 the end of the current route. The calculated distance includes
261 the distance between breaks in the route (i.e. between the end of
262 one route segment and the beginning of another route segment).
265 <display_text>Reset</display_text> - Reset Maemo Mapper's tracking
266 of your progress along the current route. Use this if Maemo
267 Mapper loses track of where you are with respect to the current
271 <display_text>Reset</display_text> - Clear the current route,
272 effectively replacing it with an empty route.
275 <heading>Track</heading>
277 The <display_text>Track</display_text> menu is used to manipulate
278 your current <i>track</i>. A track in Maemo Mapper is defined as
279 a set of points along which you have been traveling, i.e. <i>where
280 you have been</i>. It can include multiple segments. Tracks are
281 most useful if you have enabled a GPS receiver. The current track
282 is empty until you get at least one valid position point from your
283 GPS receiver, and it is appendeded to whenever you stray far enough
284 from the last track point.
287 The <display_text>Track</display_text> menu has the following menu
292 <display_text>Open...</display_text> - Open a track from a GPX
293 file on the file system. In contrast to route data, the opened
294 track is <i>prepended</i> to the current track, so if you are
295 trying to rebuild previous track data, you must open the tracks
296 backward in time (most recent tracks first).
299 <display_text>Save...</display_text> - Save the current track to a
300 GPX file on the file system.
303 <display_text>Insert Break</display_text> - Artificially insert a
304 break in your current track data. This simulates the loss and
305 re-acquisition of a GPS fix, and it can be used to track, for
306 example, refueling stops.
309 <display_text>Insert Mark</display_text> - Artificially insert a
310 mark with a description in your current track data. This can be
311 used to mark important landmarks.
314 <display_text>Show Distance from Last Break</display_text> - Show
315 the distance traveled (along the current track) since the last
319 <display_text>Show Distance from Beginning</display_text> - Show
320 the distance traveled (along the current track) since the
321 beginning of the track. The calculated distance includes the
322 distance between breaks in the track (i.e. between when a GPS fix
323 is lost and later re-acquired).
326 <display_text>Clear</display_text> - Clear the current track,
327 effectively replacing it with an empty track.
330 <heading>Maps</heading>
332 The <display_text>Maps</display_text> menu is used to control your
333 map repositories. This menu will be populated with a list of all of
334 your map repositories, from which you can select to switch to a
335 particular repository.
338 The <display_text>Maps</display_text> menu has the following menu
339 items in addition to the list of available repositories:
343 <display_text>Manage Maps...</display_text> - Download or delete
344 maps for the currently selected repository. For more details, see
345 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
348 <display_text>Manage Repositories...</display_text> - Configure
349 each of your available repositories, or add new ones. You can
350 also download a pre-defined set of repositories. For more
351 details, see <ref refid="help_maemomapper_repoman"
352 refdoc="Managing Repositories"/>.
355 <display_text>Auto-Download</display_text> - Toggle Maemo Mapper's
356 ability to automatically download maps as they are needed in order
357 to fill the screen with map data. This is useful for arbitrary
358 exploration of the world while connected to the internet, or if
359 you have a constant connection to the internet (i.e. via a
360 cellular data service).
363 <heading>View</heading>
365 The <display_text>View</display_text> menu allows you to customize
366 the view by showing or hiding certain features of the display.
369 The <display_text>View</display_text> menu has the following menu
374 <display_text>Zoom In</display_text> - Zoom in by one zoom level.
375 You can also use the <graphic
376 filename="2686KEY_zoom_in"/> button.
379 <display_text>Zoom Out</display_text> - Zoom out by one zoom
380 level. You can also use the <graphic
381 filename="2686KEY_zoom_out"/> button.
384 <display_text>Full Screen</display_text> - Toggle full-screen
385 mode. You can also use the <graphic
386 filename="2686KEY_full_screen"/> button to toggle
390 <display_text>Scale</display_text> - Toggle the display of the
394 <display_text>Route</display_text> - Toggle the display of routes.
397 <display_text>Track</display_text> - Toggle the display of tracks.
400 <display_text>Velocity Vector</display_text> - Toggle the display
401 of the velocity vector (the blue line extending from the blue
402 circle that represents your current location).
405 <display_text>POIs</display_text> - Toggle the display of POIs.
408 <display_text>POI Categories...</display_text> - Define POI
409 categories and which categories are displayed on the map. For
410 more details, see <ref refid="help_maemomapper_poicat" refdoc="POI
414 <heading>Auto-Center</heading>
416 The <display_text>Auto-Center</display_text> menu is used to control
417 whether or not Maemo Mapper should re-center the display as your
418 current location changes. The sensitivity of re-centering (how
419 close you get to the edge of the display before Maemo Mapper
420 re-centers the display) can be configured in the <ref
421 refid="help_maemomapper_settings" refdoc="Settings"/> Dialog.
424 There are three different modes of Auto-Center:
428 <display_text>Lat/Lon</display_text> - Keep your location centered
432 <display_text>Lead</display_text> - Depending on your speed, keep
433 a location in front of you centered on the screen. The faster you
434 are going, the more lead distance is used.
437 <display_text>None</display_text> - Do no re-center the display
441 <heading>Go to</heading>
443 The <display_text>Go to</display_text> menu is used to center the
444 view on a particular location.
447 The <display_text>Go to</display_text> menu has the following menu
452 <display_text>Lat/Lon...</display_text> - Specify an exact
453 Latitude and Longitude on which to center the display.
456 <display_text>GPS Position</display_text> - Center the display on
457 your current GPS position. This is the manual counter-part of
458 the <display_text>Auto-Center</display_text> functionality
462 <display_text>Next Waypoint</display_text> - Center the display on
463 the next waypoint in your route. By default, the next waypoint is
464 colored a slightly darker green than normal waypoints.
467 <display_text>Nearest POI</display_text> - Center the display on
468 the enabled POI nearest to the current view center.
471 <heading>GPS</heading>
473 The <display_text>GPS</display_text> menu is used to access features
474 of the GPS receiver, including textual information not displayed on
475 the map. It is also used to control your connection to the GPS
480 <display_text>Enable GPS</display_text> - Toggle communication
481 with a GPS receiver. You must have a GPS receiver set up in order
482 to use this menu item. When on, Maemo Mapper will constantly
483 search for the GPS receiver.
486 <display_text>Show Information</display_text> - Toggle display of
487 additional information provided by the GPS receiver. This
488 information will appear in the main display as a panel on the
492 <display_text>Details...</display_text> - Show even more
493 information provided by the GPS receiver, including a polar plot
494 of all GPS satellites in view.
497 <display_text>Reset Bluetooth</display_text> - Attempt to reset
498 the bluetooth radio, in case it locks up for some reason. In
499 order for this to succeed, you <i>must</i> add the following line
500 to your /etc/sudoers file (if you don't know what that means,
501 don't try it): <b>user ALL = NOPASSWD: /usr/sbin/hciconfig hci0
505 <heading>Other</heading>
507 In addition to the above menus, there are a few other items in the
512 <display_text>Settings...</display_text> - Access and change
513 settings for using Maemo Mapper. For more information, see <ref
514 refid="help_maemomapper_settings" refdoc="Settings"/>.
517 <display_text>Help...</display_text> - Access this help file.
520 <display_text>About...</display_text> - Display version and
521 copyright information.
524 <display_text>Close</display_text> - Close Maemo Mapper.
529 <topictitle>Context Menu</topictitle>
530 <context contextUID="help_maemomapper_cmenu"/>
532 By tapping and holding on the screen, you can access the context
533 menu to execute actions on either that location, the nearest route
534 waypoint, or the nearest POI.
537 The context menu is separated into two hierarchical levels. The
538 first level (<display_text>Location</display_text>,
539 <display_text>Waypoint</display_text>, or
540 <display_text>POI</display_text>) determines what kind of data on
541 which the operation applies.
543 <heading>Location</heading>
545 The <display_text>Location</display_text> submenu performs actions
546 on the exactly latitude and longitude on which the tap-and-hold
547 operation was performed. With that location, you can do the
552 <display_text>Show Lat/Lon</display_text> - Display the latitude
553 and longitude of the selected location, in the style chosen in
554 <display_text>Settings</display_text>
557 <display_text>Copy Lat/Lon</display_text> - Copy the latitude and
558 longitude of the selected location to the clipboard, in
559 comma-separated decimal format.
562 <display_text>Show Distance to</display_text> - Display the
563 distance (in a straight line) to the selected location.
566 <display_text>Download Route to...</display_text> - Open the
567 <ref refid="help_maemomapper_downroute"
568 refdoc="Download Route"/> dialog with the selected location
569 pre-filled as the destination.
572 <display_text>Add Route Point</display_text> - Add a point to the
573 current route, based on the selected location. The point is not a
577 <display_text>Add Waypoint...</display_text> - Add a waypoint
578 to the current route, based on the selected location. You must
579 provide a description for the waypoint to be legitimate. By
580 specifying an empty description, however, you can create a break
581 in the route. The break will not be connected to the rest of the
582 route, so it can be used to start a new segment.
585 <display_text>Add POI...</display_text> - Add a POI to the POI
586 database, based on the selected location. If the category in
587 which you place the POI is disabled, it will not be visible on the
588 map after creation, but it will still be in the database.
591 <display_text>Set as GPS Position</display_text> - Force Maemo
592 Mapper to consider the selected location to be the current GPS
593 location. This will not affect the current track, but it will
594 change the location of the blue circle that represents your
595 current location, and it can be used to calculate a route from
599 <display_text>Apply Map Correction</display_text> - Enables and
600 disables the application of map correction. When enabling map
601 correction, the tap point is used as the correction reference point.
602 See the note below for more details.
606 Map Correction is a little-used feature that corrects a rare problem
607 with map data. In some locations around the world (like Brazil and
608 Québec), road data from a particular map repository may not be
609 accurate, although the error is consistent. For example, as you
610 travel, you may find that your actual track (as indicated by your
611 GPS receiver) is a few hundred meters away from the road on which
612 Maemo Mapper is drawing your current position. Map Correction fixes
613 this. When your GPS receiver has an accurate fix, and if Maemo
614 Mapper shows your current location as somewhere other than where you
615 expect to be, simply tap-and-hold on the location on the map where
616 you think your current location <i>should</i> be drawn, then select
617 this context menu item. The correction is saved as part of your
618 configuration (so it persists even if you restart Maemo Mapper or
621 <heading>Waypoint</heading>
623 The <display_text>Waypoint</display_text> submenu performs actions
624 on the waypoint nearest to the point on which the tap-and-hold
625 operation was performed. If no waypoints are nearby, an error
626 message will be displayed.
630 <display_text>Show Lat/Lon</display_text> - Show the latitude and
631 longitude of the selected waypoint, in the style chosen in
632 <display_text>Settings</display_text>.
635 <display_text>Show Description</display_text> - Show the
636 description attached to the select waypoint. When downloading
637 routes via the <ref refid="help_maemomapper_downroute"
638 refdoc="Download Route"/> dialog, the description will contain
639 the directions needed to take at that waypoint (e.g. "Turn left at
640 Main Street. Go 2.5 kilometers.").
643 <display_text>Copy Lat/Lon</display_text> - Copy the latitude and
644 longitude of the selected waypoint to the clipboard, in
645 comma-separated decimal format.
648 <display_text>Copy Description</display_text> - Copy the
649 description of the waypoint to the clipboard.
652 <display_text>Show Distance to</display_text> - Show the distance
653 left to be traveled (along the current route) until the selected
654 waypoint. The calculated distance includes the distance between
655 breaks in the route (i.e. between the end of one route segment and
656 the beginning of another route segment).
659 <display_text>Download Route to...</display_text> - Open the
660 <ref refid="help_maemomapper_downroute"
661 refdoc="Download Route"/> dialog with the selected waypoint's
662 location pre-filled as the destination.
665 <display_text>Delete...</display_text> - Delete the selected
666 waypoint from the current route. This will delete all route
667 segments surrounding the route, including (and limited to) all the
668 points from that waypoint to the next and previous waypoints.
671 <display_text>Add POI...</display_text> - Add a POI to the POI
672 database, based on the selected waypoint's location. If the
673 category in which you place the POI is disabled, it will not be
674 visible on the map after creation, but it will still be in the
678 <heading>POI</heading>
680 The <display_text>POI</display_text> submenu performs actions
681 on the POI nearest to the point on which the tap-and-hold operation
682 was performed. If no POIs are nearby, an error message will be
687 <display_text>View/Edit</display_text> - View and/or edit the
691 <display_text>Show Distance to</display_text> - Display the
692 distance (in a straight line) to the selected POI.
695 <display_text>Download Route to...</display_text> - Open the
696 <ref refid="help_maemomapper_downroute"
697 refdoc="Download Route"/> dialog with the selected POI's
698 location pre-filled as the destination.
701 <display_text>Add Route Point</display_text> - Add a point to the
702 current route, based on the selected POI's location. The point is
706 <display_text>Add Waypoint...</display_text> - Add a waypoint
707 to the current route, based on the selected location. You must
708 provide a description for the waypoint to be legitimate. By
709 specifying an empty description, however, you can create a break
710 in the route. The break will not be connected to the rest of the
711 route, so it can be used to start a new segment.
716 <topictitle>Managing Repositories</topictitle>
717 <context contextUID="help_maemomapper_repoman"/>
719 In Maemo Mapper, map data is divided into specific units called
720 <i>repositories</i>. A repository is a source of map data, each of
721 which has its own way of visualizing the Earth. For example,
722 repositories based on street maps typically draw roads as lines and
723 buildings as areas, whereas repositories based on satellite data
724 draw the Earth as it would appear from space. There are also
725 "hybrid" repositories that overlay street map data on top of
726 satellite data, as well as topographical maps that show altitude
730 Each repository is made up of maps at 16 different zoom levels.
731 Zoom Level 0 is the highest resolution (closest to the Earth, i.e.
732 "zoomed in"), and Zoom Level 15 is the lowest resolution (furthest
733 from the Earth, i.e. "zoomed out"). Not all repositories are
734 available at all zoom levels, and some repositories may even produce
735 an error (which you can usually ignore) if you try to download maps
739 Once you have set up at least one repository, you can start
740 downloading maps from that repository to your device's file system.
741 For details on how to do this, see
742 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
745 You can set up any number of repositories in Maemo Mapper, but only
746 one can be active at any given time. The <display_text>Manage
747 Repositories</display_text> dialog is accessed via the
748 <display_text>Manage Repositories...</display_text> menu item of the
749 <display_text>Maps</display_text> menu, and it allows you to add,
750 edit, and remove repositories.
753 The <display_text>Manage Repositories...</display_text> has a combo
754 box that controls which repository is being viewed and edited. When
755 a repository is selected, the controls below it display the current
756 settings, which you can change:
760 <display_text>URL Format</display_text> - A specially formatted
761 string that looks like a URL, but it needs to have at least one
762 printf-style substitution strings (like %f or %s). Normally, you
763 must either get these URL formats from the internet
764 (www.internettablettalk.com is a good source), or you can use the
765 <display_text>Download...</display_text> button in the
766 Repositories dialog box to download a sample.
769 <display_text>Cache DB</display_text> - A database file on the file
770 system (either on the device's internal memory, or an external
771 memory card) in which maps are stored. Maps are kept here
772 indefinitely (until you delete them), so pick a location with a
773 lot of free space. You can use the
774 <display_text>Browse...</display_text> button to select the
775 database file with a graphical file system browser, or you can enter
776 the filename manually. The <display_text>Compact...</display_text>
777 button can be used to compact the database if you have deleted
778 many maps from your database. (Otherwise, deleted space is reused
782 <display_text>Download Zoom Steps</display_text> - Controls which
783 zoom levels should be avoided when automatically downloading maps
784 (i.e. Auto-Download is enabled). The lowest setting (one bar)
785 means to download every zoom level. The highest setting (four
786 bars) causes Maemo Mapper to only download every fourth zoom level
790 <display_text>View Zoom Steps</display_text> - Similar to the
791 above-described <display_text>Download Zoom Steps</display_text>
792 option, except that it controls how Maemo Mapper behaves when
793 zooming. For example, at two bars, pressing
794 <graphic filename="2686KEY_zoom_in"/> causes Maemo Mapper to zoom
795 in two levels instead of just one. Setting this equal to
796 <display_text>Download Zoom Steps</display_text> ensures that you
797 see all maps at their native resolution.
800 <display_text>Double Pixels</display_text> - This forces Maemo
801 Mapper to avoid using the native resolution of any maps, instead
802 using pixel-doubling. This is useful if your repository's maps
803 contain small, hard-to-read text, and you want to double the size
804 of the images to make them more readable. This setting can also
805 affect the zoom levels that are downloaded when Auto-Download is
809 <display_text>Next-able</display_text> - This oddly-named option
810 determines whether or not the "Select Next Repository" action
811 (which can be mapped to any of the hardware keys) will be able to
812 select this repository. When unset, the "Select Next Repository"
813 action will simply skip over this repository.
816 <display_text>Downloadable Zooms</display_text> - This setting
817 governs the minimum and maximum zoom levels Maemo Mapper should
818 attempt to automatically download for this repository (when
819 Auto-Download is enabled). Some repositories support more zoom
820 levels than others, and supported zoom levels may even vary from
821 location to location.
825 In addition to the per-repository controls, there are a few buttons
826 that provide additional functionality:
830 <display_text>Rename...</display_text> - Renames the currently
834 <display_text>Delete...</display_text> - Deletes the currently
838 <display_text>New...</display_text> - Adds a new repository.
841 <display_text>Reset...</display_text> - Resets your repository
842 list to the factory default. This will remove all of your
843 repositories and replace them with the single default repository
844 that comes with Maemo Mapper.
847 <display_text>Download...</display_text> - Downloads information
848 about several preset repositories, and adds them to your
849 repository list. They will be appended to any existing
850 repositories you already have. They are not read-only - you may
851 edit them as you wish. This is a good way to get started.
855 Certain repositories (most notably, the commercial ones) may
856 have license agreements attached with their use. It may be
857 illegal to use a certain repository with Maemo Mapper or under
858 certain conditions. This includes the repositories downloaded
859 via the <display_text>Download...</display_text> button. If you
860 are not sure if you are legally allowed to use a particular
861 repository, you should delete it from your list of repositories.
862 The authors of Maemo Mapper cannot be held responsible for your
863 use of a particular repository.
867 <topictitle>Managing Maps</topictitle>
868 <context contextUID="help_maemomapper_mapman"/>
870 In Maemo Mapper, <i>repositories</i> represent sources of map data,
871 and <i>maps</i> are just image files (e.g. PNG or JPEG) that are
872 drawn onto the screen. Once you have a repository set up (see
873 <ref refid="help_maemomapper_repoman"
874 refdoc="Managing Repositories"/>), you can download maps from a
875 repository into a Map Cache, which is just a database file on your
876 device's file system.
879 Maemo Mapper downloads maps from the current repository so that they
880 can be drawn onto the screen and later recalled from disk, instead
881 of downloading a map every time it is needed. This is called
882 <i>caching</i>, and it allows you to use Maemo Mapper even when you
883 are not connected to the internet.
886 Because Maemo Mapper downloads maps to your device's file system,
887 you must be aware of how much disk space your maps are taking up,
888 especially if you enable Auto-Download. If space is a concern, you
889 may also choose to go without a cache entirely. You can do this by
890 leaving the Map Cache DB field blank in the <display_text>Manage
891 Repositories</display_text> dialog. Note that this will cause Maemo
892 Mapper to download maps each time they are needed. If you are using
893 a cellular data plan that charges per kilobyte, you probably want to
894 use a cache. For more information about repositories and the
895 <display_text>Manage Repositories</display_text> dialog, see
896 <ref refid="help_maemomapper_repoman"
897 refdoc="Managing Repositories"/>.
900 Aside from the Auto-Download functionality, you can also download
901 maps manually using the <display_text>Manage Maps...</display_text>
902 menu item of the <display_text>Maps</display_text> menu. The
903 <display_text>Manage Maps</display_text> dialog allows you to
904 download, overwrite, or delete maps, either by area or along your
905 current route. It contains up to three tabs, all of which control
906 which and how many maps are downloaded.
908 <heading>Setup</heading>
910 The <display_text>Setup</display_text> tab controls what you what to
911 do. You can download maps (optionally overwriting
912 already-downloaded maps) from the current repository to your
913 device's file system, or you can delete maps (pertaining to the
914 current repository) from your device's file system. Both of these
915 operations can be done either over a rectangular area or along your
920 <display_text>Download Maps</display_text> - If selected, Maemo
921 Mapper will download maps from the current repository to your
922 device's file system, for the area you specify. By default, Maemo
923 Mapper only downloads the maps that you don't already have.
926 <display_text>Overwrite</display_text> - If selected, then Maemo
927 Mapper will download maps and overwrite any maps that you may have
931 <display_text>Delete Maps</display_text> - If selected, Maemo
932 Mapper will delete maps from your file system, for the area you
936 <display_text>By Area</display_text> - If selected, Maemo Mapper
937 will download or delete maps for a particular rectangular area of
938 the world, based on the latitude and longitude of an upper-left
939 and lower-right corner. See the <display_text>Area</display_text>
940 tab to specify the coordinates.
943 <display_text>Along Route</display_text> - If selected, Maemo
944 Mapper will download or delete maps along your current route.
945 This is useful if, for example, you are about to embark on a trip
946 and want to make sure that you have maps for all points along the
950 <display_text>Radius (tiles)</display_text> - If
951 <display_text>Along Route</display_text> is selected, then you can
952 specify the radius around your route for which maps will be
953 downloaded or deleted. For example, if you specify 4 (the
954 default), then Maemo Mapper will download all tiles that are
955 within 4 tiles of your route.
958 <heading>Zoom</heading>
960 The <display_text>Zoom</display_text> tab controls which zoom levels
961 at which maps are downloaded or deleted. The current zoom level is
962 selected by default, but you can enable or disable any zoom levels
965 <heading>Area</heading>
967 The <display_text>Area</display_text> tab, available if the
968 <display_text>By Area</display_text> option is selected in the
969 <display_text>Setup</display_text> tab, defines the rectangular area
970 of the world for which maps will be downloaded or deleted. If
971 applicable, the fields are pre-filled with your current and previous
972 view center coordinates. This allows you to graphically choose your
973 rectangle by first centering on one corner of the rectangle, then
974 centering on the opposite corner, by tapping the screen or by using
975 the <display_text>Lat/Lon</display_text> menu item of the
976 <display_text>Go to</display_text> menu.
980 <topictitle>Downloading Routes</topictitle>
981 <context contextUID="help_maemomapper_downroute"/>
983 Route data can be loaded from GPX files, like the ones provided by
984 the GPX Driving Directions web service
985 (http://www.gnuite.com/cgi-bin/gpx.cgi). Or, route data can be
986 downloaded directly within Maemo Mapper using the
987 <display_text>Download Route</display_text> dialog.
990 Downloading routes requires an active connection to the internet,
991 but once a route is loaded into Maemo Mapper, the internet
992 connection is no longer needed (unless
993 <display_text>Auto-Update</display_text> is enabled). The route
994 download functionality in Maemo Mapper actually uses the
995 aforementioned GPX Driving Directions web service.
998 To download a route, you must specify an
999 <display_text>Origin</display_text> and a
1000 <display_text>Destination</display_text>. The GPX Driving
1001 Directions web service will return a route taking you from the
1002 origin to the destination.
1005 The <display_text>Download Route</display_text> dialog contains the
1010 <display_text>Source URL</display_text> - The web service from
1011 which driving directions are retrieved. The default is fine, and
1012 it is usually left unchanged.
1015 <display_text>Auto-Update</display_text> - This option, only
1016 available if <display_text>Use GPS Location</display_text> is
1017 enabled, will cause Maemo Mapper to automatically re-download a
1018 new route if you stray from the route. Note that you must have a
1019 continuous connection to the internet (i.e. cellular data service)
1020 for Auto-Update to work.
1023 <display_text>Use GPS Location</display_text> - If selected, then
1024 the current GPS location will be used as the
1025 <display_text>Origin</display_text>.
1028 <display_text>Use End of Route</display_text> - If selected, then
1029 the end of the route will be used as the
1030 <display_text>Origin</display_text>. This is useful for stringing
1031 together multiple route downloads into a single route.
1034 <display_text>Origin</display_text> - If selected, then you must
1035 enter your own origin. An origin can be specified in any format
1036 understood by Google Maps. Some examples: "25, -43" (lat/lon),
1037 "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
1038 "5th and Main, 12151". In fact, if your route download fails with
1039 a "Could not generate directions" error message, you can use
1040 Google Maps to test your origin for accuracy.
1043 <display_text>Destination</display_text> - The destination to
1044 which the directions will lead. Like the
1045 <display_text>Origin</display_text>, a destination can be
1046 specified in any format understood by Google Maps.
1051 <topictitle>Downloading POIs</topictitle>
1052 <context contextUID="help_maemomapper_downpoi"/>
1054 Points of Interest (POIs) can be loaded from GPX files, like the
1055 ones provided by the GPX POI Search web service
1056 (http://www.gnuite.com/cgi-bin/poi.cgi). Or, POI data can be
1057 downloaded directly within Maemo Mapper using the
1058 <display_text>Download POIs</display_text> dialog.
1061 Downloading POIs requires an active connection to the internet,
1062 but once a POI is loaded into Maemo Mapper, the POI is accessible in
1063 Maemo Mapper regardless of whether or not you are connected to the
1064 internet. The POI download functionality in Maemo Mapper actually
1065 uses the aforementioned GPX POI Search web service.
1068 To search for POIs, you enter an <display_text>Origin</display_text>
1069 and a <display_text>Query</display_text>. The GPX POI Search web
1070 service will return up to 10 matching POIs in the vicinity of the
1071 origin. You can access more POIs from the same query by using the
1072 <display_text>Page</display_text> modifier.
1075 Once you have downloaded POIs, they are automatically added to your
1076 POI database, and you are presented with the <display_text>POI
1077 List</display_text> dialog to to review the POIs that were
1078 downloaded and added to your database. You must manually remove any
1079 POIs that you don't want in your database. For more information
1080 about the <display_text>POI List</display_text> dialog and
1081 deleting POIs, see <ref refid="help_maemomapper_poilist"
1082 refdoc="POI List"/>.
1085 The <display_text>Download POIs</display_text> dialog contains the
1090 <display_text>Source URL</display_text> - The web service from
1091 which POIs are retrieved. The default is fine, and it is usually
1095 <display_text>Use GPS Location</display_text> - If selected, then
1096 the current GPS location will be used as the
1097 <display_text>Origin</display_text>.
1100 <display_text>Use End of Route</display_text> - If selected, then
1101 the end of the route will be used as the
1102 <display_text>Origin</display_text>. This is useful for searching
1103 for points of interests (like hotels or restaurants) near your
1104 current destination.
1107 <display_text>Origin</display_text> - If selected, then you must
1108 enter your own origin. An origin can be specified in any format
1109 understood by Google Maps. Some examples: "25, -43" (lat/lon),
1110 "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
1111 "5th and Main, 12151". In fact, if your route download fails with
1112 a "Could not generate directions" error message, you can use
1113 Google Maps to test your origin for accuracy.
1116 <display_text>Category</display_text> - Specifies the default
1117 category in which all resulting POIs will be placed. You can
1118 always change the category later. If you have not yet entered a
1119 <display_text>Query</display_text> when you select a category,
1120 then the name of the category will be entered into the
1121 <display_text>Query</display_text> field for you. This allows you
1122 to, for example, quickly search for restaurants and put them in
1123 the Restaurant category.
1126 <display_text>Page</display_text> - Specifies the page of results
1127 that you want to retrieve. Think of it as the page number in a
1128 web search. Page 1 contains the first 10 results. Page 2
1129 contains results 10-19. And so on.
1132 <display_text>Query</display_text> - A free-form text query that
1133 describes the POIs for which you are searching. This can be
1134 anything from "food" to "hairstylist" to "museum." Note that the
1135 selected <display_text>Category</display_text> is not part of the
1136 query unless you explicitly include it in the
1137 <display_text>Query</display_text> field.
1142 <topictitle>Browsing POIs</topictitle>
1143 <context contextUID="help_maemomapper_browsepoi"/>
1145 Once you have imported or downloaded POIs into your POI database,
1146 you can use the <display_text>Browse POIs</display_text> dialog to
1147 search for certain POIs in your database and to view those POIs in a
1151 To browse for POIs, you enter an <display_text>Origin</display_text>
1152 and a optional <display_text>Query</display_text>. Maemo Mapper
1153 will search the database for all POIs matching your query, and it
1154 will calculate the distance from each POI to your specified
1155 <display_text>Origin</display_text>. You may also filter your
1156 results by <display_text>Category</display_text>.
1159 Once your search is performed, you are taken to the
1160 <display_text>POI List</display_text> dialog, where you can view,
1161 edit, and delete any of the POIs that matched your query. For more
1162 information about the <display_text>POI List</display_text> dialog
1163 and editing POIs, see <ref refid="help_maemomapper_poilist"
1164 refdoc="POI List"/>.
1167 The <display_text>Browse POIs</display_text> dialog contains the
1172 <display_text>Use GPS Location</display_text> - If selected, then
1173 the current GPS location will be used as the
1174 <display_text>Origin</display_text>.
1177 <display_text>Use End of Route</display_text> - If selected, then
1178 the end of the route will be used as the
1179 <display_text>Origin</display_text>. This is useful for searching
1180 for points of interests (like hotels or restaurants) near your
1181 current destination.
1184 <display_text>Origin</display_text> - If selected, then you must
1185 enter your own origin. An origin can be specified in any format
1186 understood by Google Maps. Some examples: "25, -43" (lat/lon),
1187 "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
1188 "5th and Main, 12151". In fact, if your route download fails with
1189 a "Could not generate directions" error message, you can use
1190 Google Maps to test your origin for accuracy.
1193 <display_text>Category</display_text> - Filters the results based
1194 on the selected category.
1197 <display_text>Query</display_text> - An optional substring which
1198 must appear in either the label or description of a POI in order
1199 for the POI to match. Any spaces, commas, or other punctiation in
1200 the query must also be in the label or description. If left
1201 blank, then all POIs are matched.
1206 <topictitle>POI List</topictitle>
1207 <context contextUID="help_maemomapper_poilist"/>
1209 The <display_text>POI List</display_text> dialog is a tabular
1210 display of POIs. With this dialog, you can go to a specific POI,
1211 edit POIs, change the categories of a set of POIs, delete POIs, and
1212 export POIs to the GPX file format.
1215 The main view of the <display_text>POI List</display_text> dialog is
1216 a table with five columns, all of which (except the checkbox) can be
1217 sorted by tapping on the appropriate header:
1221 <display_text>*</display_text> - This checkbox column contains a
1222 checkbox for each POI in the table. All of the POIs that are
1223 checked will be affected by operations in the
1224 <display_text>Checked POI Actions</display_text> dialog, described
1225 later. You can tap on the column header to enable or disable
1226 all of the checkboxes at once. Note that this checkbox has no
1227 effect on whether or not the POI is visible in the map.
1230 <display_text>Category</display_text> - The category in which the
1231 POI belongs. Categories can be edited, enabled, and disabled with
1232 the <display_text>POI Categories</display_text> dialog. For more
1233 information about the <display_text>POI Categories</display_text>
1234 dialog, see <ref refid="help_maemomapper_poicat"
1235 refdoc="POI Categories"/>
1238 <display_text>Dist.</display_text> - The distance from the Origin
1242 <display_text>Bear.</display_text> - The bearing (in degrees from
1243 true north) from the Origin to the given POI. A bearing of zero
1244 or 360 means that the POI is due north of the Origin. 90 means
1245 east; 180 means south; and 270 means west.
1248 <display_text>Label</display_text> - The label of the POI.
1252 Below the table are four buttons:
1256 <display_text>Go to</display_text> - Pans the map display to the
1257 currently selected POI (i.e. the currently highlighted row).
1258 Remember that you can tap and hold on the title bar of the dialog
1259 in order to see the map behind it.
1262 <display_text>Edit...</display_text> - Opens the
1263 <display_text>Edit POI</display_text> dialog for the currently
1264 selected POI (i.e. the currently highlighted row). You can also
1265 double-tap on a row in the table to open this dialog.
1268 <display_text>Checked POI Actions...</display_text> - Opens the
1269 <display_text>Checked POI Actions</display_text> dialog, which
1270 allows you to perform actions on the currently checked POIs in the
1271 table. From that dialog, you can set the categories of the
1272 checked POIs, delete the checked POIs, and/or export the checked
1276 <display_text>Close</display_text> - Closes the <display_text>POI
1277 List</display_text> dialog.
1282 <topictitle>POI Categories</topictitle>
1283 <context contextUID="help_maemomapper_poicat"/>
1285 POI Categories are a means by which you can organize your POIs for
1286 selective display. The <display_text>POI Categories</display_text>
1287 dialog is accessed from the <display_text>View</display_text> menu
1288 and allows you to enable/disable, add, edit, or delete categories.
1291 Each row in the table represents a category. There are three
1292 columns displayed for each category:
1296 <display_text>Enabled</display_text> - Controls whether or not
1297 POIs in this category are drawn on the map.
1300 <display_text>Label</display_text> - A short label to describe the
1301 category. This is the name that will be visible when viewing a
1305 <display_text>Description</display_text> - A longer description of
1306 the category. This description is not visible anywhere except in
1307 this dialog; it is only used to get an idea of how the category is
1312 Selecting a row in the table and pressing the
1313 <display_text>Edit</display_text> button will allow you to edit the
1314 above three attributes of a category, and to delete a category. You
1315 can also add a new category by using the
1316 <display_text>Add</display_text> button.
1319 A POI may only be associated with a single category at a time.
1321 <heading>POI Icons</heading>
1323 Icons can be customized on a per-POI or per-category basis, and/or
1324 you may provide a custom default icon for all POIs. To do so, you
1325 should place icon files in the same directory as the POI database
1326 itself. Most image file formats are supported, but the files
1327 themselves <i>must</i> have the ".jpg" extension (even if the icons
1328 are not in the JPEG format).
1331 To customize the default POI icon (to be used instead of the simple
1332 square), place an icon file called "poi.jpg" in the same directory
1333 as the POI database.
1336 To customize the icon for a POI category, place an icon file with
1337 the same name as the POI category, all lower-case, plus the ".jpg"
1338 extension. For example, if your POI category is called "Gas
1339 Stations", the file should have the name "gas stations.jpg".
1342 To customize the icon for a specific POI, place an icon file with
1343 a name equal to the POI's label, all lower-case, plus the ".jpg"
1344 extension. For example, if your POI's label is "Joe's House",
1345 the file should have the name "joe's house.jpg".
1348 POI-specific icons are given priority over category-specific icons,
1349 which in turn are given priority over the default POI icon.
1353 <topictitle>Settings</topictitle>
1354 <context contextUID="help_maemomapper_settings"/>
1356 The <display_text>Settings</display_text> dialog (accessible from
1357 the main menu) provides access to a plethora of configurable options
1358 that control how Maemo Mapper appears and runs. In addition to the
1359 tabs, which are described below, there are also two buttons at the
1360 bottom of the diagram labeled <display_text>Hardware
1361 Keys...</display_text> and <display_text>Colors...</display_text>.
1364 The <display_text>Hardware Keys...</display_text> button brings up
1365 another dialog box, which allows you to customize the actions that
1366 each hardware key causes. For example, you can map the
1367 <graphic filename="2686KEY_esc"/> button to cycle through map
1368 repositories, giving you quick access to switching among them.
1371 The <display_text>Colors...</display_text> button allows you to
1372 customize the colors that are used for drawing on-map objects.
1374 <heading>GPS</heading>
1376 The <display_text>GPS</display_text> tab tells Maemo Mapper the
1377 source (if any) from which to retrieve GPS data. It is only
1378 applicable if you have access to a GPS source, such as a bluetooth
1379 GPS receiver or a GPSD server. Technically, Maemo Mapper uses GPSD
1380 for all of its GPS receiver communication, but you can instruct
1381 Maemo Mapper to use GPSD in one of three ways:
1385 <display_text>Bluetooth</display_text> - Select this option
1386 if you are using a bluetooth GPS receiver, and enter the
1387 MAC address in the field provided. If you don't know the MAC
1388 address, turn on your receiver and press the
1389 <display_text>Scan...</display_text> button to select it from a
1390 list of nearby bluetooth devices. Or, leave the field blank and
1391 Maemo Mapper will automatically try to use any bluetooth GPS
1392 receivers that it can identify. This
1393 option is also appropriate if you are running Maemo Mapper on a
1394 device with an internal GPS receiver, in which case you should
1395 leave the field blank.
1398 <display_text>File Path</display_text> - Select this option to use
1399 a device file on your file system, such as an RFCOMM device, and
1400 specify the pathname of the file in the appropriate field.
1403 <display_text>GPSD Host</display_text> - Select this option if you
1404 want to connect Maemo Mapper to any GPSD server (local or remote).
1405 Enter the hostname and port of the server in the fields provided.
1406 The default values (127.0.0.1 on port 2947) cause Maemo Mapper to
1407 use the local GPSD server, if available.
1410 <heading>Auto-Center</heading>
1412 The <display_text>Auto-Center</display_text> tab allows you to
1413 configure how Maemo Mapper automatically re-centers the display when
1414 either <display_text>Lat/Lon</display_text> or
1415 <display_text>Lead</display_text> is enabled from the
1416 <display_text>Auto-Center</display_text> menu. The Auto-Center
1417 feature is most useful in conjunction with a GPS receiver.
1421 <display_text>Lead Amount</display_text> - When Auto-Center is set
1422 to <display_text>Lead</display_text>, then Maemo Mapper will keep
1423 the center of the screen focused on an area in front of you. When
1424 driving, this allows you to view more of the road ahead of you.
1425 The distance in front of you on which the screen is centered is
1426 based on two variables: your current speed and the value of the
1427 <display_text>Lead Amount</display_text> option.
1430 <display_text>Fixed</display_text> - Controls whether or not your
1431 lead amount is affected by your speed. If checked, then your
1432 speed will not affect the lead amount.
1435 <display_text>Pan Sensitivity</display_text> - Controls how often
1436 Maemo Mapper re-centers the display, based on how close your
1437 position (or the position of your <i>lead</i>) gets to the edge of
1438 the screen. When set to a low value, Maemo Mapper will only
1439 re-center the screen when you are near the edge of the screen.
1440 When set to the maximum, Maemo Mapper will keep your position as
1441 close to the center as possible.
1444 <display_text>Min. Speed</display_text> - Controls how fast you
1445 must be moving in order for Auto-Center (and Auto-Rotate) to
1446 activate. For example, walkers may wish to set this threshold
1447 low, while drivers with inaccurate GPS receivers may wish to set
1448 this high (to avoid spurious auto-rotates when parked or waiting
1449 at a red light). The speed is specified in your chosen units.
1452 <display_text>Rotate Sensit.</display_text> - Controls how often
1453 Maemo Mapper rotates the display based on your heading, depending
1454 on how far your current rotation is from your heading rotation.
1457 <display_text>Points</display_text> - Controls which direction
1458 on the screen your heading points to when auto-rotating. The
1459 default is for your current heading to point up.
1462 <heading>Announce</heading>
1464 The <display_text>Announce</display_text> tab controls how and when
1465 Maemo Mapper displays or speaks waypoint information. When you
1466 approach a waypoint in your route (defined by the presence of a
1467 description in the GPX file), Maemo Mapper will pop up a text box
1468 with the contents of that description. When downloading routes from
1469 within Maemo Mapper, the text describes your next action, e.g. "Turn
1470 left at Main Street. Go 2.4 miles."
1473 As you approach a waypoint, Maemo Mapper will continue to display
1474 the description of that waypoint, so long as you are within the
1475 range defined by the <display_text>Advance Notice</display_text>
1476 option, or until you pass the waypoint. Because the amount of
1477 notice is dependent on your speed, it is possible to see the text,
1478 then slow down to a point where the notice disappears. This is
1479 possible, for example, if you are stopped at a red light. The text
1480 will reappear when you have picked up enough speed to again break
1481 the <display_text>Advance Notice</display_text> range.
1484 If you have installed <i>flite</i>, which is available in the same
1485 repository from which you downloaded Maemo Mapper, then Maemo Mapper
1486 can optionally also speak the same directions that appear on screen.
1487 Maemo Mapper will only speak the directions once, at the exact
1488 moment you first reach the distance from the waypoint defined by the
1489 <display_text>Advance Notice</display_text> option. The same
1490 directions are on-screen if you need to reference them.
1494 <display_text>Advance Notice</display_text> - Controls how much in
1495 advance Maemo Mapper begins to provide the waypoint description.
1496 The exact distance at which Maemo Mapper begins to announce a
1497 waypoint also depends on your speed, so the value of this option
1498 can be thought of more accurately in units of time. At the
1499 minimum value, Maemo Mapper gives you almost no notice. At the
1500 maximum value, Maemo Mapper gives you about two minutes of notice.
1501 Experiment to find your happy medium.
1504 <display_text>Enable Voice Synthesis</display_text> - If you have
1505 installed <i>flite</i>, this option will cause Maemo Mapper to
1506 speak the description of the next waypoint when you enter the
1507 range defined by the <display_text>Advance Notice</display_text>
1511 <heading>Misc.</heading>
1513 The <display_text>Misc.</display_text> and <display_text>Misc.
1514 2</display_text> tabs contain miscellaneous options.
1518 <display_text>Line Width</display_text> - Controls the thickness
1519 of all lines drawn on top of the map images. This includes your
1520 mark, all tracks and routes, and the default POI image.
1523 <display_text>Unblank Screen</display_text> - Controls when Maemo
1524 Mapper keeps the display on without user input. When set to
1525 <display_text>When Receiving Any GPS Data</display_text>, Maemo
1526 Mapper will keep the screen on whenever a GPS receiver is
1527 connected and producing data. When set to
1528 <display_text>Never</display_text>, Maemo Mapper will not attempt
1529 to keep the screen on, and the screen will go blank after a period
1530 of inactivity on the user's part. The default is
1531 <display_text>When Moving (Full Screen Only)</display_text>
1534 <display_text>Info Font Size</display_text> - Controls the font
1535 size for all information that is popped up to the user in the
1536 upper-right corner, including waypoint descriptions.
1539 <display_text>Units</display_text> - Controls the units in which
1540 distances and speeds are displayed in the user interface.
1543 <display_text>Degrees Format</display_text> - Controls how
1544 latitude and longitudes are displayed in the user interface.
1547 <display_text>Auto-Download Pre-cache</display_text> - Controls
1548 how much of the world surrounding the view Maemo Mapper should
1549 download when <display_text>Auto-Download</display_text> is
1550 enabled. When set to the minimum, Maemo Mapper will only download
1551 the maps that are required to draw the screen. As you pan around
1552 the world, you will see black areas where Maemo Mapper has not yet
1553 downloaded maps, until those maps are downloaded. If you increase
1554 the Pre-cache amount, the Maemo Mapper will download more of the
1555 surrounding areas, making it less likely that you ever actually
1556 see black areas. A general rule of thumb is to limit the
1557 Pre-cache based on the bandwidth of your internet connection, but
1558 the default setting (two bars) is usually sufficient for most
1562 <display_text>Speed Limit</display_text> - Enables notification
1563 when you have exceeded the given speed limit (specified in the
1564 units defined via the <display_text>Units</display_text> option).
1567 <display_text>Location</display_text> - Controls the location on
1568 the screen of the speed warning.
1571 <heading>POI</heading>
1573 The <display_text>POI</display_text> tab allows you to define your
1574 POI database and how POIs are drawn on the screen.
1578 <display_text>POI database</display_text> - The location on the
1579 file system where the POI database is located. The database must
1580 be in sqlite3 format. A default (empty) POI database is
1581 automatically created for you when you first run Maemo Mapper.
1584 <display_text>Show POI below zoom</display_text> - Defines the
1585 maximum zoom (furthest away from the Earth) at which POIs will be
1586 drawn. When zoomed out beyond this level, no POIs will be drawn.
1591 <topictitle>About Maemo Mapper</topictitle>
1592 <context contextUID="help_maemomapper_about"/>
1594 Current Version: 2.4
1597 Maemo Mapper was created and developed by John Costigan (aka
1598 <display_text>gnuite</display_text>).
1601 Copyright © 2006-2007 John Costigan.
1604 POI and GPS-Info code originally written by Cezary Jackiewicz.
1607 Default map data provided by http://www.openstreetmap.org/ - other
1608 map repositories are subject to their own licenses and may or may not
1609 be suitable for use with Maemo Mapper. It may be illegal to use a
1610 certain repository with Maemo Mapper or under certain conditions. This
1611 includes the repositories downloadable directly in Maemo Mapper. If
1612 you are not sure if you are legally allowed to use a particular
1613 repository, you should delete it from your list of repositories. The
1614 authors of Maemo Mapper cannot be held responsible for your use of a
1615 particular repository.
1618 Maemo Mapper is free software: you can redistribute it and/or modify it
1619 under the terms of the GNU General Public License as published by the
1620 Free Software Foundation, either version 3 of the License, or (at your
1621 option) any later version.
1624 Maemo Mapper is distributed in the hope that it will be useful, but
1625 WITHOUT ANY WARRANTY; without even the implied warranty of
1626 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1627 General Public License for more details.