📄 manual.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>RoadMap - a street navigation system using the US Census maps andGPS</title><meta name="author" content="Pascal Martin (pascal.martin@ponts.org)"><meta name="date" content="November 2003"></head><body><h1><a id="id.toc" name="id.toc">Contents</a></h1><dl><dd><a href="#id.s1">1 INTRODUCTION</a></dd><dd><a href="#id.s2">2 ABOUT THIS DOCUMENTATION</a></dd><dd><a href="#id.s3">3 INSTALLATION</a><dl><dd><a href="#id.s3.1">3.1 DEPENDENCIES</a></dd><dd><a href="#id.s3.2">3.2 DOWNLOADING</a></dd><dd><a href="#id.s3.3">3.3 INSTALLING FROM THE BINARY TARBALL</a></dd><dd><a href="#id.s3.4">3.4 INSTALLING FROM THE FAMILIAR PACKAGE</a></dd><dd><a href="#id.s3.5">3.5 INSTALLING FROM THE SOURCE TARBALL</a></dd><dd><a href="#id.s3.6">3.6 A NOTE ABOUT THE ROADMAP ICONS</a></dd></dl></dd><dd><a href="#id.s4">4 ROADMAP APPLICATIONS</a></dd><dd><a href="#id.s5">5 USING ROADMAP</a><dl><dd><a href="#id.s5.1">5.1 COMMAND LINE OPTIONS</a></dd><dd><a href="#id.s5.2">5.2 GETTING HELP</a></dd><dd><a href="#id.s5.3">5.3 THE ROADMAP DISPLAY</a></dd><dd><a href="#id.s5.4">5.4 VOICE INTERFACE</a></dd><dd><a href="#id.s5.5">5.5 KEY BINDINGS</a></dd><dd><a href="#id.s5.6">5.6 ON-THE-FLY MAP DOWNLOAD</a></dd><dd><a href="#id.s5.7">5.7 WAYPOINTS AND ADDRESSES</a></dd><dd><a href="#id.s5.8">5.8 STREET NAME OPTIONS</a></dd><dd><a href="#id.s5.9">5.9 OTHER ADDRESS OPTIONS</a></dd><dd><a href="#id.s5.10">5.10 SELECTING AN INTERSECTION</a></dd><dd><a href="#id.s5.11">5.11 SELECTING A POSITION</a></dd><dd><a href="#id.s5.12">5.12 MANAGING TRIPS</a></dd><dd><a href="#id.s5.13">5.13 ROADMAP PREFERENCES</a></dd></dl></dd><dd><a href="#id.s6">6 USING ROADGPS</a></dd><dd><a href="#id.s7">7 CONFIGURATION</a><dl><dd><a href="#id.s7.1">7.1 FILES</a></dd><dd><a href="#id.s7.2">7.2 CONFIGURING THE TEXT AND VOICE MESSAGES</a></dd><dd><a href="#id.s7.3">7.3 A NOTE REGARDING COLORS</a></dd><dd><a href="#id.s7.4">7.4 PREFERENCE ITEMS</a></dd><dd><a href="#id.s7.5">7.5 SESSION ITEMS</a></dd><dd><a href="#id.s7.6">7.6 SCHEMA ITEMS</a></dd><dd><a href="#id.s7.7">7.7 SPRITES FILE</a></dd><dd><a href="#id.s7.8">7.8 TRIP FILES</a></dd></dl></dd><dd><a href="#id.s8">8 TOOLS</a></dd><dd><a href="#id.s9">9 CONFIGURATION EXAMPLES</a></dd><dd><a href="#id.s10">10 IMPLEMENTATION DETAILS</a><dl><dd><a href="#id.s10.1">10.1 PORTING ROADMAP</a></dd><dd><a href="#id.s10.2">10.2 PROJECTION</a></dd></dl></dd><dd><a href="#id.s11">11 MAP FORMAT</a><dl><dd><a href="#id.s11.1">11.1 MAP FILES</a></dd><dd><a href="#id.s11.2">11.2 TABLES</a></dd><dd><a href="#id.s11.3">11.3 THE STRING SECTION</a></dd><dd><a href="#id.s11.4">11.4 DIRECTORY TABLES</a></dd><dd><a href="#id.s11.5">11.5 MAP TABLES</a></dd><dd><a href="#id.s11.6">11.6 THE SQUARE SECTION</a></dd><dd><a href="#id.s11.7">11.7 THE POINT SECTION</a></dd><dd><a href="#id.s11.8">11.8 THE LINE SECTION</a></dd><dd><a href="#id.s11.9">11.9 THE SHAPE SECTION</a></dd><dd><a href="#id.s11.10">11.10 THE POLYGON SECTION</a></dd><dd><a href="#id.s11.11">11.11 THE STREET SECTION</a></dd><dd><a href="#id.s11.12">11.12 THE RANGE SECTION</a></dd></dl></dd></dl><hr><h1><a id="id.s1" name="id.s1">1</a>INTRODUCTION<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h1><p>RoadMap is an open source program for UNIX that displays street maps. Whena GPS receiver is available RoadMap can track the current location of thevehicule on the screen, continuously adjusting the position of the map; it canalso identify the name of the current street as well as the name of the nextintersection. RoadMap can be used without a GPS receiver, as a static mapviewer and address finder.</p><p>Most of the maps are provided by the USCensus Bureau, which only cover the US. RoadMap now includes a preliminarysupport for the Digital Charts of the Words (DCW), a set of world-wide mapsproduced by the US Department of Defense. The DCW contains only major highwaysand freeways, for some parts or the world (mostly Europe and japan) and theiraccuracy does not allow any reliable car navigation.</p><p>RoadMap is releasedunder the GPL (see the COPYING file). The US Census Bureau's data is publicdomain. The DCW data is mostly public domain, but some administrative boundarydata is copyright of ESRI(<a href="http://www.esri.com/">http://www.esri.com/</a>). As noadministrative data is incorporated in the RoadMap map files, all the RoadMapmap files are in the public domain.</p><p>RoadMap uses a binary file formatfor representing the maps that is compact enough to allow the storage of manymaps on a Compact Flash or MultiMedia card. The map of Los Angeles countytakes a little more than 10 Mbytes of flash space. RoadMap comes with a set oftools to convert the US Census bureau data into its own mapformat.</p><p>RoadMap has been designed to be usable on both a desktop orlaptop computer, or on a PDA such as the iPAQ from HP (formely from COMPAQ) orthe Sharp Zaurus.</p><p>In its current version, RoadMap can work with eitherthe GTK+ 1.2, GTK 2.0, GPE, QT/X11 or QT/QPE graphic environments. The QTenvironment --especially its QT/QPE version--is mostly used for the Zaurusport (but could probably be used with OPIE). RoadMap is configured for usingQT3 by default, but the QT2 compatibility headers must be installed (theQT2-style coding has been kept because of the Zaurus QPE environment). The GTK1.2 environment is being phased out (due to its old age). The most stableenvironment is the GTK 2.0 one (this is the one used for developping RoadMap).The GPE support is and optional extension of the GTK 2.0 environment and isstill very experimental (i.e. untested).</p><p>RoadMap is at an early stage ofdevelopment. At this time all the features have not been implemented yet.RoadMap can display the map around a specified street address, track a GPSposition and identify the current street and the next intersection. A basictrip support is provided (waypoints and destination). RoadMap detects what isthe next waypoint, provides a direction arrow and show the distance to thiswaypoint (and/or to the destination).</p><p>The plan for the future is toimplement some navigation features similar to those found in commercial carnavigation systems, and to port RoadMap to as many environment aspossible.</p><h1><a id="id.s2" name="id.s2">2 </a>ABOUT THISDOCUMENTATION<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h1><p>This documentation was written using vi (what else? :-) in the formatsupported by aptconvert. The aptconvert tool was used to produce the HTMLversion of this manual (file web/manual.html). The HTML file can beregenerated using the followingcommand:</p><pre> aptconvert -toc web/manual.html README</pre><p>Theaptconvert tool is available at<a href="http://www.xmlmind.com/aptconvert.html">http://www.xmlmind.com/aptconvert.html</a>.</p><h1><a id="id.s3" name="id.s3">3</a>INSTALLATION<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h1><h2><a id="id.s3.1" name="id.s3.1">3.1</a>DEPENDENCIES<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h2><p>RoadMap communicates with a GPS receiver using the NMEA 0183 protocol.RoadMap has been tested with a Garmin 38. The GPS receiver must be configuredwith the datum set to either NAD83 or WGS 84.</p><p>RoadMap communicates withthe GPS receiver through gpsd, a GPS communication daemon for UNIX. Thereforegpsd is required for RoadMap to take advantage of a GPS receiver. However gpsdis not required when building RoadMap, and RoadMap can run without gpsd as astatic map viewer or address finder. In addition, gpsd may run on a remotecomputer accessible through a TCP/IP network: in this case the remote computerwill be tacked by RoadMap, not the local one..</p><p>RoadMap uses either GTK,GTK2 or QT for its user interface. One of these toolkits must be installed.RoadMap can be built for QT/QPE, but the RoadMap makefile for QT must bemodified.</p><p>RoadMap uses the ImageMagick package to generate the PNG filesfor some icons of its toolbar. ImageMagick is only required for buildingRoadMap, it is not necessary when running RoadMap.</p><p>RoadMap uses flite(festival lite) to generate voice messages. See section "VOICEINTERFACE" for more information.</p><p>RoadMap uses aptconvert to formatthe documentation (see previous section).</p><p>Support for a "Point ofInterest" feature is in the way, where the plan is to store the points ina SQLite database. RoadMap is not at this time dependent on SQLite, even whileusing SQLite will be an option in thefuture.</p><h2><a id="id.s3.2" name="id.s3.2">3.2</a>DOWNLOADING<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h2><p>RoadMap can be downloaded from the RoadMap web site:</p><ul><li><a href="http://roadmap.digitalomaha.net/download.html">http://roadmap.digitalomaha.net/download.html</a></li></ul><p>RoadMap is distributed with the map of San Francisco as an example ofmap. The complete set of maps is available on the following web site:</p><ul><li><a href="http://roadmap.digitalomaha.net/maps.html">http://roadmap.digitalomaha.net/maps.html</a></li></ul><p>The RoadMap directory file (usdir.rdm) must be downloaded first, asRoadMap will not work without it.</p><p>Please refrain from downloading allthe US states at once, as the map files are huges and the bandwidth isexpensive.</p><p>If you do need the complete set, please drop an email to theauthor. Roadmap comes either as a set of sources, or as a set of binary files,depending on which distribution you downloaded. RoadMap comes in threedistribution formats:</p><ul><li>a binary tarball with executables for Linux/i686.</li><li>a set of .ipk packages for Linux/armv4l (Linux/Familiar).</li><li>a source tarball.</li></ul><p>The arm and i686 executables use the same map files. Please note thatthe map files are dependent on the computer's endianess: map files built on aMac (PowerPC CPU) would not be compatible with an Intel or (small endian) ARMcomputer.</p><p>Note: the main GTK RoadMap executables (roadmap and roadgps)are built as "gtkroadmap" and "gtkroadgps", while the QTequivalent are built as "qtroadmap" and qtroadgps" to avoid aclash. These executables are installed under their "standard" namesusing symbolic links, so that only one version can be installed at a time (thereason is to share one roadmap.menu file..).</p><p>A version of RoadMap forthe Sharp Zaurus is available at<a href="http://community.zaurus.com/projects/zroadmap/">http://community.zaurus.com/projects/zroadmap/</a></p><h2><a id="id.s3.3" name="id.s3.3">3.3</a>INSTALLING FROM THE BINARYTARBALL<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h2><p>The binary distribution contains three sets of files: the directory src/gtkcontains the executable files for Debian GNU/Linux (kernel 2.4) and thedirectory src contains the example map datafiles.</p><p>RoadMap can beinstalled by running the "make install" command from one of thegraphical toolkit directories (gtk2, gtk or qt). This installs the associatedset of RoadMap executables and all configuration files (but not themaps!).</p><h2><a id="id.s3.4" name="id.s3.4">3.4 </a>INSTALLING FROM THEFAMILIARPACKAGE<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h2><p>The RoadMap familiar distribution contains one .ipk package file. Thispackage contains the RoadMap executables (roadmap and roadgps) as well as theconfiguration files for a GTK 2.0 setup (such as the Familiar 0.7.2 GPEimage). This package does not contain the map files or the map indexfile.</p><p>If RoadMap is available from yourfeed:</p><pre> ipkg install roadmap</pre><p>If you downloaded the ipkfiles on theiPAQ:</p><pre> ipkg install roadmap_X.Y.Z_arm.ipk</pre><p>RoadMap isuseless without maps. The maps can be downloaded from the web site(<a href="http://roadmap.digitalomaha.net/maps.html">http://roadmap.digitalomaha.net/maps.html</a>or mirrors) or generated from the US Census Bureau's files (seelater).</p><p>It is strongly recommended you install the maps on aCompactFlash or SD/MMC card, and not on the iPAQ internal flash. The reason isthat the maps are way too big to be installed on the iPAQ flash. Asconfigured, RoadMap will look for the maps either in</p><ul><li>/mnt/hda/share/roadmap or</li><li>/mnt/card/share/roadmap.</li></ul><p>(This can be changed using the RoadMap preferences dialog.)</p><p>Theset of maps for California represents more that 100 Mbyte of data, the wholeUS about 1.6 Gbyte. Unless you are the lucky owner of a large capacityCompactFlash, you will have to install a subset. A capacity of 128 Mbyte isenough in most cases, 64 Mbyte might be enough if you do not travel far fromhome.</p><p>To build the maps yourself, you need the Linux/i686 binary or thesource tarball. See the next section for moredetails.</p><h2><a id="id.s3.5" name="id.s3.5">3.5 </a>INSTALLING FROM THESOURCETARBALL<a href="#id.toc"><img src="apt_toc.gif" border="0" width="30" height="11" alt="Contents"></a></h2><p>It is also possible to rebuild RoadMap and the map files from scratch fromthe source distribution:</p><ol style="list-style-type: decimal"><li>Install the development libraries for GTK+ 1.2, GTK+ 2.0 or Qt.</li><li>Install the RoadMap'starball:<pre> tar xzvf <tarball></pre></li>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -