manual.html

A car navigation system for Unix and PocketPC.

can be enabled later using the File / Enable Voice item.</p><p>Please note
that it is possible to rebuild flite with a better voice than the default one.
The flite source is available at the CMU web
site:</p><p><a href="http://www.speech.cs.cmu.edu/flite/">http://www.speech.cs.cmu.edu/flite/</a></p><p>The
flite README file describes how to regenerate flite using another voice. Here
is an example, courtesy of Scot Wilcoxon:</p><pre>     cd flite
     make clean    # to remove old executable files
     ./configure --with-vox=cmu_us_kal16
     make</pre><h2><a id="id.s5.5" name="id.s5.5">5.5
</a><a id="key" name="key">KEY</a>
BINDINGS<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h2>
<p>Most of the RoadMap commands are available from the keyboard (so to answer
requests from my loyal Zaurus fans :). In fact, the button and key bindings
are common to all ports, but some buttons might not exist on some
platforms.</p><p>Please note that all the button and key bindings are case
insensitive, i.e. the same binding applies to 'A' and 'a' (as well as to
&quot;Button-Left&quot; and &quot;button-left&quot;--whatever it
means).</p><p>On a desktop or laptop (or on the Zaurus), the keyboard keys are
mapped as follow:</p><center><table border="0">
<tr valign="top">
<td align="left"><b>Button-Left</b></td>
<td align="left">Move the map view to the left.</td>
</tr>
<tr valign="top">
<td align="left"><b>Button-Right</b></td>
<td align="left">Move the map view to the right.</td>
</tr>
<tr valign="top">
<td align="left"><b>Button-Up</b></td>
<td align="left">Move the map view up.</td>
</tr>
<tr valign="top">
<td align="left"><b>Button-Down</b></td>
<td align="left">Move the map view down.</td>
</tr>
<tr valign="top">
<td align="left">+</td>
<td align="left">Zoom in: enlarge the central part of the map.</td>
</tr>
<tr valign="top">
<td align="left">-</td>
<td align="left">Zoom out: show a larger area.</td>
</tr>
<tr valign="top">
<td align="left">A</td>
<td align="left">Show a specified address.</td>
</tr>
<tr valign="top">
<td align="left">B</td>
<td align="left">Start the trip back to the departure point.</td>
</tr>
<tr valign="top">
<td align="left">D</td>
<td align="left">Show the destination point.</td>
</tr>
<tr valign="top">
<td align="left">E</td>
<td align="left">Erase maps among those currently visible.</td>
</tr>
<tr valign="top">
<td align="left">F</td>
<td align="left">Toggle the full screen mode.</td>
</tr>
<tr valign="top">
<td align="left">G</td>
<td align="left">Show the GPS position.</td>
</tr>
<tr valign="top">
<td align="left">H</td>
<td align="left">Hold the map view in its current position.</td>
</tr>
<tr valign="top">
<td align="left">I</td>
<td align="left">Show a specified street intersection.</td>
</tr>
<tr valign="top">
<td align="left">L</td>
<td align="left">Show the last selected location.</td>
</tr>
<tr valign="top">
<td align="left">M</td>
<td align="left">Enable/Disable map download.</td>
</tr>
<tr valign="top">
<td align="left">N</td>
<td align="left">Create a new trip.</td>
</tr>
<tr valign="top">
<td align="left">O</td>
<td align="left">Open an existing trip.</td>
</tr>
<tr valign="top">
<td align="left">P</td>
<td align="left">Stop tracking the current trip.</td>
</tr>
<tr valign="top">
<td align="left">Q</td>
<td align="left">Quit RoadMap.</td>
</tr>
<tr valign="top">
<td align="left">R</td>
<td align="left">Set the map back to the default zoom level.</td>
</tr>
<tr valign="top">
<td align="left">S</td>
<td align="left">Start tracking the current trip.</td>
</tr>
<tr valign="top">
<td align="left">U</td>
<td align="left">Center the map on the GPS position (north up).</td>
</tr>
<tr valign="top">
<td align="left">W</td>
<td align="left">Set the selected street block as waypoint.</td>
</tr>
</table></center><p>The current bindings that are used by the application are
printed after the options help information when the --help option is
used.</p><p>Note for Familiar 0.7.1 GPE users: the GPE environment has defined
the buttons bindings In a way that makes it impossible for RoadMap to use them
(the button are mapped to the GPE applications). In this environment it is
recommended to enable the toolbar to replace the buttons. the joypad is still
available.</p><h2><a id="id.s5.6" name="id.s5.6">5.6 </a>ON-THE-FLY MAP
DOWNLOAD<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h2>
<p>Today's PDA have a limited storage space, which must be shared with MP3 and
other files. As the RoadMap maps can take up to 1.6 GB, most PDA users will
want to install only the few maps they need. The on-the-fly download feature
of RoadMap helps the user to select visually which maps to download or remove.
RoadMap is capable of downloading compressed maps: gzip, bzip2 or lzop
compressed files are automatically recognized and uncompressed after
transfer.</p><p>The map download is available in a special RoadMap mode, which
can be activated and deactivated using the Find / Map Download menu entry. On
startup the download mode is always deactivated. RoadMap shows a red
&quot;download&quot; icone on the right top corner of the map screen to
indicate that the download mode has been activated.</p><p>In the download
mode, if a map is not found by the display engine, the user will be asked for
the permission to download the file from the configured source (as defined in
the preference item &quot;Download.Source&quot;). The destination directory
can also be configured (using the preferences item
&quot;Download.Destination&quot;). Both the source and the destination file
name can be edited manually before each download.</p><p>RoadMap is designed to
support multiple download protocols. The protocol is selected depending on the
source string, as much as possible using the well-known URL syntax. Two
protocols are available: a local file copy (the source is either a full path
or a &quot;file://*&quot; URL) and the HTTP protocol (the source is a
&quot;http://*&quot; URL). The local file copy protocol can be useful in some
cases, for example when mounting the map server's disk using nfs or
smbfs.</p><p>If the suffix of the downloaded file matches a well-known
compressed files suffix, RoadMap will invoke the appropriate tool to
uncompress the file. The compression tools supported are gzip (.gz suffix),
bzip2 (.bz2 suffix) and lzop (.lzo suffix). This feature makes it possible to
store compressed maps on the server side. Using compressed files may reduce by
a factor of two the time it takes to download the map, depending on the
compression tool used, the specific map's content, etc.. Note that maps are
always stored uncompressed: because RoadMap maps the file in memory,
compressed file cannot be used by RoadMap.</p><p>If the user cancels the
download of a specific map, RoadMap will not request the same download again
for the remainder of the session. This means that RoadMap will request the
same maps again if stopped and then restarted. This was done because there is
at this time no way for the user to change his mind and re-request the
download of a cancelled map. This is a part of the user interface that is
likely to change in the future.</p><p>RoadMap also provides a dialog for
deleting maps, activated through the Find / Delete Maps.. menu entry. The
dialog shows the number of map files stored locally, the total size of the
local maps and the list of maps currently visible on the RoadMap screen. The
proper way for selecting maps to delete is to view an area you do not need
anymore, hit the Find / Delete Maps.. entry, then select a specific county and
hit the Delete button. The county will immediately disappear from the map
screen and the dialog gets updated (i.e. the map statistics and the map list
will reflect the latest delete action). Several counties can be deleted this
way before the dialog is closed (button &quot;Done&quot;).</p><p>Note that a
deleted map is automatically added to the &quot;cancel download&quot; list, so
that RoadMap will not request for this map again. As such, it is not a problem
to delete maps while the download mode is active. If you need to download
again a map that was deleted, just restart RoadMap.</p><p>A typical use of the
download feature is to preload the maps you need before you go on a trip.
Activate the download mode and select the destination address: RoadMap will
request the download on the map that covers this destination. Zoom out the
display to force the download of adjacent counties, if required. Repeat for
each place you are likely to go to. Use the arrow keys or buttons to &quot;fly
over&quot; the roads you are going to travel on. If you missed a map, and you
did set a public map web server, it should be possible to download maps from
an hotel's Internet access. Of course, if you are (rich and) lucky enough to
have an Internet connection while on the road, the download feature can also
be used at any time.</p><p>Here is a typical setup using the HTTP
protocol:</p><p>1- Install the individual map files, gzip-compressed, in a
&quot;maps&quot; subdirectory of the web server directory tree. Say the web
server is named &quot;desktop&quot;.</p><p>2- Set the preference
Download.Source to
<a href="http://desktop/maps/usc%2505d.rdm.gz">http://desktop/maps/usc%05d.rdm.gz</a></p><p>3-
Set the preference Download.Destination to /var/lib/roadmap</p><p>4- Make sure
the preference Map.Path does include the directory
/var/lib/roadmap.</p><h2><a id="id.s5.7" name="id.s5.7">5.7 </a>WAYPOINTS AND
ADDRESSES<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h2>
<p>RoadMap manages four types of points: a location point (selected using a
street address or the mouse), the GPS position (updated automatically if a GPS
fix is available), a destination point, and an arbitrary number of
user-defined waypoints.</p><p>One can select which one of these locations
serves as the center of the map. The GPS and waypoints positions are special
cases: see the section on trip management.</p><p>The location point is really
a buffer for the selection of a street block. Once selected, the point can be
defined as a (new) waypoint or as the destination. Thus the definition of a
destination or waypoint is a two step procedure: (1) select a location, and
(2) set the selected point as a waypoint or the destination point (in the Trip
menu).</p><p>The location point can be entered in one of three ways: - by
clicking on a location on the map, - by entering a valid USPS address (street
number, name, city and state names) in the dialog launched by the &quot;View /
Show Location..&quot; menu entry, - by specifying the intersection of two
streets in the dialog launched by the &quot;View / Show intersection..&quot;
menu entry.</p><p>More details are provided in the following
sections.</p><h2><a id="id.s5.8" name="id.s5.8">5.8
</a><a id="street" name="street">STREET</a> NAME
OPTIONS<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h2>
<p>Street names are used in the two dialogs used to select a specific
location: the address and intersection dialogs. These dialogs follow the same
rules regarding the format of the names.</p><p>When entering a street name,
the street prefix, suffix and type, if provided, must be among the