User:Korrosa

From Navit's Wiki
Revision as of 14:02, 4 November 2010 by Korrosa (talk | contribs) (Configuration)
Jump to: navigation, search

OSM Layout

Mapnik-style rendering

Configuration

  • Tags shown in order of appearance in the navit.xml shipped with Navit.
  • Attributes appear in alphabetical order for each tag.
  • Bold values denote default values if attributes are not explicitly specified.
  • Value types:
    • int = integer
    • bool = boolean 1 or 0
    • dbl = double
Navit configuration options
Tag Attribute Units Values Notes Example
navit
center coords DD.dd or DDMM.ss Map will be centred at these coordinates on startup. Coordinates are either in decimal degrees (with sign in front to denote N/S or E/W) or decimal minutes with trailing N/S or E/W where appropriate.
Default: 53.13 11.70
center="4808 N 1134 E"
orientation 0 / -1 orientation="0": Map oriented North.
orientation="-1": Map oriented in direction of travel.
This is equivalent to selecting Settings -> Rules -> Northing in the internal gui.
orientation="-1"
tracking 0 / 1 tracking="1": Vehicle cursor will lock to the roads on the map.
This is equivalent to selecting Settings -> Rules -> Lock on road in the internal gui.
tracking="1"
zoom 1 - ∞
256
zoom="1": Most zoomed in. Upper limit is actually 2097152.
Map will be zoomed in at this level on startup.
zoom="50"
autozoom_active 0 / 1 autozoom_active="0": Autozoom disabled.
autozoom_active="1": Autozoom enabled.
autozoom_active="1"
autozoom_secs seconds 1 - ∞
10
Number of seconds of the way ahead to leave visible during autozoom.
In effect, this specifies the zoom level when autozoom is enabled.
autozoom_secs="1" is closest zoom.
This attribute has no effect without autozoom_active="1".
autozoom_secs="60"
pitch degrees 1 - 359 pitch="0": Bird's-eye view of map.
pitch="20": Map tilted by 20 degrees to give 3D view.
pitch="20"
radius percent 1 - 100
30
Percentage of screen size to offset map from centre when moving.
This causes the map to "lead" the vehicle, showing more of where you're going and less of where you've been.
radius="33"
recent_dest 1 - ∞
10
Number of entries kept in destination.txt. This text file stores the most recent destinations set by the user in Navit.
Default: ∞
recent_dest="20"
timeout gps updates 1 - ∞
10
When the user scrolls the map, it stays there. After timeout number of GPS updates the map jumps back to the current location of the active vehicle. (see #653) timeout="5"
graphics Insert inbetween <navit> ... </navit> tags
type gtk_drawing_area
qt_qpainter
sdl
opengl
Type of graphics to use for display. graphics="gtk_drawing_area"
gui Insert inbetween <navit> ... </navit> tags
type gtk
internal
qml
cegui
Type of user interface to use type="internal"
enabled yes / no Enable this user interface. This attribute enables you to define multiple user interfaces within navit.xml (i.e. multiple <gui> ... </gui> tags), and quickly switch between them by changing the enabled status. enabled="yes"
font_size Pt fractions 1 - ∞ The base text size to use for text and labels in the menus. This only applies when type="internal" font_size="350"
icon_xs pixels 1 - ∞ The size that extra-small style icons should be scaled to (e.g. country flag on town search). This only applies when type="internal" icon_xs="32"
icon_s pixels 1 - ∞ The size that small style icons should be scaled to (e.g. icons of internal GUI toolbar). This only applies when type="internal" icon_s="96"
icon_l pixels 1 - ∞ The size that large style icons should be scaled to (e.g. icons of internal GUI menu). This only applies when type="internal" icon_l="96"
fullscreen 0 / 1 fullscreen="1": Start Navit in fullscreen mode fullscreen="1"
menubar 0 / 1 Toggle display of the menu bar. This only applies when type="gtk" menubar="1"
menu_on_map_click 0 / 1 Toggles the ability to bring up the menu screen when clicking on the map. When using menu_on_map_click="0" it is recommended to use an OSD button with the command gui.menu(), or else you can't get to the menu screen! This only applies when type="internal" menu_on_map_click="0"
toolbar 0 / 1 Toggle display of the toolbar. This only applies when type="gtk" toolbar="1"
statusbar 0 / 1 Toggle display of the status bar. This only applies when type="gtk" statusbar="1"
skin
log Insert inbetween <navit> ... </navit> tags for type="textfile_debug".
Insert inbetween <vehicle> ... </vehicle> tags for all other types.
type nmea
gpx
textfile
binfile
Type of log to output.
type="nmea": outputs data as NMEA messages (the data format used by most GPS receivers).
type="gpx": outputs GPX XML files (e.g. for upload to OpenStreetMap).
type="textfile": creates a text file that can be used as a map within Navit
type="binfile": outputs a binary map file for use within Navit
type="textfile_debug": outputs a debug text file.
type="gpx"
enabled yes / no Enable logging. This attribute enables you to define multiple log types within navit.xml (i.e. multiple <log> ... </log> tags), and quickly switch between them by changing the enabled status. enabled="yes"
data filename The name for the logfile. There is support for date and time placeholders:
%Y: Current year
%m: Current month
%d: Current day
%i: Next sequential logfile number (to make the filename unique)
data="%Y%m%d-%i.gpx"
overwrite 0 / 1 Toggle to choose whether an existing tracklog of the same name gets:
overwrite="0": Appended to, or
overwrite="1": overwritten
overwrite="1"
flush_size bytes 0 - ∞ The file is kept in memory and will be committed to disk if the size reaches the flush_size limit.
flush_size="0": Writes the tracklog to disk immediately.
When used in combination with flush_time, whichever limit is reached first triggers a disk write.
flush_size="1048576"
flush_time seconds 0 - ∞ The file is kept in memory and will be committed to disk after flush_time seconds.
flush_time="0": Writes the tracklog to disk immediately.
When used in combination with flush_size, whichever limit is reached first triggers a disk write.
flush_size="90"
attr_types position_time_iso8601
position_direction
position_speed
profilename
position_radius
position_height
position_sats_used
position_hdop
Comma-separated list which determines what information will be stored in the log file (in addition to the position, and only if supported by the GPS receiver). This only applies when type="gpx"
See Configuring_Navit#Logging_Trips for descriptions of each type.
attr_types="position_height,
position_direction"
osd Insert inbetween <navit> ... </navit> tags.
See OSD for comprehensive information on on-screen display settings.