View source for User:Korrosa

=OSM Layout=
[http://wiki.navit-project.org/index.php/Layouts/mapnik Mapnik-style rendering]

=OSD: Speed Camera=
Currently a patch at {{Trac|702}}.

*Provides visual and audible warnings of approaching speed cameras.
*Uses speed camera data from an external file in IGO8 format: files available from http://speedcamerapoi.com/download.php. Example IGO8 format shown below:
<pre>
X,Y,TYPE,SPEED,DIRTYPE,DIRECTION
13.74132,51.04641,2,50,0,0
8.34681,49.62934,2,50,0,0
12.11390,49.02778,3,0,0,0
8.83805,53.08262,3,0,0,0
9.14767,47.68987,3,0,0,0
6.94611,51.12167,1,30,0,0
7.82556,51.46417,1,70,0,0
14.17350,51.12366,5,50,0,0
13.89502,52.25109,5,100,0,0
</pre>
*Plans to also use speed camera data in OSM

==Configuration==

     <osd enabled="yes" type="speed_cam" w="500" h="40"  x="30" y="350" font_size="450" text_color="#FF0000" announce_on="0" label=" ${distance} | ${camera_type} | ${camera_dir} | ${direction} | ${speed_limit}" />


Most parts are self explanatory:
* '''announce_on''' is set by default to 1 (i.e. this osd item will announce upcoming cameras with a "Look out! Camera!" warning
* '''label''' can display the following variables. The values in ''${STRING}'' are replaced with the appropriate number or word when running Navit:
** distance to the camera - ''${distance}''
** type of camera - ''${camera_type}''. Possible types:
*** None
*** Fix
*** Traffic lamp
*** Red detect
*** Section
*** Mobile
*** Rail
*** Traffipax(non persistent)
** direction in which the camera operates - ''${camera_dir}''
*** all
*** single direction
*** both directions
** direction of the camera - ''${direction}'' (0-360 degrees)
** the active speed limit which the camera may be enforcing - ''${speed_limit}''


=Configuration=
*Tags shown in order of appearance in the navit.xml shipped with Navit.
*'''Bold''' values denote default values if attributes are not explicitly specified.
*Value types:
** int = integer
** bool = boolean 1 or 0
** dbl = double

{| style="border-style:solid;border-width:1px;border-color:#aaa;background: #FFFFFF;border-collapse: collapse;font-size: 95%;width:100%;" border="1" cellpadding="5"
|+ Navit configuration options
|-
! scope="col" | Tag
! scope="col" | Attribute
! scope="col" | Units
! scope="col" | Values
! scope="col" | Notes
! scope="col" | Example
|- style="background:#EEEEEE"
! scope="row" rowspan="11"| navit
|
|
|
|
|
|- style="background:#EEEEEE"
| center
| coords
| <tt>DD.dd</tt> or <tt>DDMM.ss</tt>
| 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.<br />'''Default: <tt>53.13 11.70</tt>'''
| <tt>center="4808 N 1134 E"</tt>
|- style="background:#EEEEEE"
| orientation
| 
| 0 / '''-1'''
| <tt>orientation="0"</tt>: Map oriented North.<br /><tt>orientation="-1"</tt>: Map oriented in direction of travel.<br />This is equivalent to selecting <tt>Settings -> Rules -> Northing</tt> in the internal gui.
| <tt>orientation="-1"</tt>
|- style="background:#EEEEEE"
| tracking
| 
| 0 / '''1'''
| <tt>tracking="1"</tt>: Vehicle cursor will lock to the roads on the map.<br />This is equivalent to selecting <tt>Settings -> Rules -> Lock on road</tt> in the internal gui.
| <tt>tracking="1"</tt>
|- style="background:#EEEEEE"
| zoom
| 
| 1 - &infin;<br /> '''256'''
| <tt>zoom="1"</tt>: Most zoomed in. Upper limit is actually 2097152.<br />Map will be zoomed in at this level on startup. 
| <tt>zoom="50"</tt>
|-
| autozoom_active
| 
| '''0''' / 1
| <tt>autozoom_active="0"</tt>: Autozoom disabled.<br /><tt>autozoom_active="1"</tt>: Autozoom enabled.<br /> 
| <tt>autozoom_active="1"</tt>
|-
| autozoom_secs
| seconds
| 1 - &infin;<br />'''10'''
| Number of seconds of the way ahead to leave visible during autozoom.<br /> In effect, this specifies the zoom level when autozoom is enabled.<br /><tt>autozoom_secs="1"</tt> is closest zoom.<br />This attribute has no effect without <tt>autozoom_active="1"</tt>.
| <tt>autozoom_secs="60"</tt>
|-
| pitch
| degrees
| 1 - 359
| <tt>pitch="0"</tt>: Bird's-eye view of map.<br /><tt>pitch="20"</tt>: Map tilted by 20 degrees to give 3D view.
| <tt>pitch="20"</tt>
|-
| radius
| percent
| 1 - 100<br />'''30'''
| Percentage of screen size to offset map from centre when moving.<br />This causes the map to "lead" the vehicle, showing more of where you're going and less of where you've been.
| <tt>radius="33"</tt>
|-
| recent_dest
| 
| 1 - &infin;<br />'''10'''
| Number of entries kept in destination.txt. This text file stores the most recent destinations set by the user in Navit.<br /> Default: &infin;
| <tt>recent_dest="20"</tt>
|-
| timeout
| gps updates
| 1 - &infin;<br />'''10'''
| When the user scrolls the map, it stays there. After <tt>timeout</tt> number of GPS updates the map jumps back to the current location of the active vehicle. (see {{Trac|653}})
| <tt>timeout="5"</tt>

|- style="background:#EEEEEE"
! scope="row" rowspan="2"| graphics
|
|
|
| Insert inbetween <tt><navit> ... </navit></tt> tags
|
|- style="background:#EEEEEE"
| type
| 
| <tt>gtk_drawing_area<br />qt_qpainter<br />sdl<br />opengl</tt>
| Type of graphics to use for display.
| <tt>graphics="gtk_drawing_area"</tt>

|- style="background:#EEEEEE"
! scope="row" rowspan="13"| gui
|
|
|
| Insert inbetween <tt><navit> ... </navit></tt> tags
|
|- style="background:#EEEEEE"
| type
| 
| <tt>gtk<br />internal<br />qml<br />cegui</tt>
| Type of user interface to use
| <tt>type="internal"</tt>
|- style="background:#EEEEEE"
| enabled
| 
| <tt>yes</tt> / <tt>no</tt>
| Enable this user interface. This attribute enables you to define multiple user interfaces within navit.xml (i.e. multiple <tt><gui> ... </gui></tt> tags), and quickly switch between them by changing the <tt>enabled</tt> status.
| <tt>enabled="yes"</tt>
|-
| font_size
| Pt fractions
| 1 - &infin;
| The base text size to use for text and labels in the menus. This only applies when <tt>type="internal"</tt>
| <tt>font_size="350"</tt>
|-
| icon_xs
| pixels
| 1 - &infin;
| The size that extra-small style icons should be scaled to (e.g. country flag on town search). This only applies when <tt>type="internal"</tt>
| <tt>icon_xs="32"</tt>
|-
| icon_s
| pixels
| 1 - &infin;
| The size that small style icons should be scaled to (e.g. icons of internal GUI toolbar). This only applies when <tt>type="internal"</tt>
| <tt>icon_s="96"</tt>
|-
| icon_l
| pixels
| 1 - &infin;
| The size that large style icons should be scaled to (e.g. icons of internal GUI menu). This only applies when <tt>type="internal"</tt>
| <tt>icon_l="96"</tt>
|-
| fullscreen
| 
| 0 / 1
| <tt>fullscreen="1"</tt>: Start Navit in fullscreen mode
| <tt>fullscreen="1"</tt>
|-
| menubar
| 
| 0 / 1
| Toggle display of the menu bar. This only applies when <tt>type="gtk"</tt>
| <tt>menubar="1"</tt>
|-
| menu_on_map_click
| 
| 0 / '''1'''
| Toggles the ability to bring up the menu screen when clicking on the map. When using <tt>menu_on_map_click="0"</tt> it is recommended to use an [[OSD#button|OSD button]] with the [[OSD#Navit_commands|command <tt>gui.menu()</tt>]], or else you can't get to the menu screen! This only applies when <tt>type="internal"</tt>
| <tt>menu_on_map_click="0"</tt>
|-
| toolbar
| 
| 0 / 1
| Toggle display of the toolbar. This only applies when <tt>type="gtk"</tt>
| <tt>toolbar="1"</tt>
|-
| statusbar
| 
| 0 / 1
| Toggle display of the status bar. This only applies when <tt>type="gtk"</tt>
| <tt>statusbar="1"</tt>
|-
| skin
| 
| 
| 
| 

|- style="background:#EEEEEE"
! scope="row" rowspan="8"| log
|
|
|
| Insert inbetween <tt><navit> ... </navit></tt> tags for <tt>type="textfile_debug"</tt>.<br />Insert inbetween <tt><vehicle> ... </vehicle></tt> tags for all other types.
|
|- style="background:#EEEEEE"
| type
| 
| <tt>nmea<br />gpx<br />textfile<br />binfile</tt>
| Type of log to output.<br /><tt>type="nmea"</tt>: outputs data as NMEA messages (the data format used by most GPS receivers).<br /><tt>type="gpx"</tt>: outputs GPX XML files (e.g. for upload to OpenStreetMap).<br /><tt>type="textfile"</tt>: creates a text file that can be used as a [[Navit_textfile_format|map within Navit]]<br /><tt>type="binfile"</tt>: outputs a binary map file for use within Navit<br /><tt>type="textfile_debug"</tt>: outputs a debug text file.
| <tt>type="gpx"</tt>
|- style="background:#EEEEEE"
| enabled
| 
| <tt>yes</tt> / <tt>no</tt>
| Enable logging. This attribute enables you to define multiple log types within navit.xml (i.e. multiple <tt><log> ... </log></tt> tags), and quickly switch between them by changing the <tt>enabled</tt> status.
| <tt>enabled="yes"</tt>
|- style="background:#EEEEEE"
| data
| 
| ''filename''
| The name for the logfile. There is support for date and time placeholders:<br /><tt>%Y</tt>: Current year<br /><tt>%m</tt>: Current month<br /><tt>%d</tt>: Current day<br /><tt>%i</tt>: Next sequential logfile number (to make the filename unique)
| <tt>data="%Y%m%d-%i.gpx"</tt>
|- 
| overwrite
| 
| '''0''' / 1
| Toggle to choose whether an existing tracklog of the same name gets:<br /><tt>overwrite="0"</tt>: Appended to, or<br /><tt>overwrite="1"</tt>: overwritten
| <tt>overwrite="1"</tt>
|- 
| flush_size
| bytes
| 0 - &infin;
| The file is kept in memory and will be committed to disk if the size reaches the <tt>flush_size</tt> limit.<br /><tt>flush_size="0"</tt>: Writes the tracklog to disk immediately.<br />When used in combination with <tt>flush_time</tt>, whichever limit is reached first triggers a disk write.
| <tt>flush_size="1048576"</tt>
|- 
| flush_time
| seconds
| 0 - &infin;
| The file is kept in memory and will be committed to disk after <tt>flush_time</tt> seconds.<br /><tt>flush_time="0"</tt>: Writes the tracklog to disk immediately.<br />When used in combination with <tt>flush_size</tt>, whichever limit is reached first triggers a disk write.
| <tt>flush_size="90"</tt>
|- 
| attr_types
| 
| <tt>position_time_iso8601<br />position_direction<br />position_speed <br />profilename <br />position_radius<br />position_height <br />position_sats_used <br />position_hdop </tt>
| 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 <tt>type="gpx"</tt><br />See [[Configuring_Navit#Logging_Trips]] for descriptions of each type.
| <tt>attr_types="position_height,<br />position_direction"</tt>

|-
! scope="row" rowspan="1"| osd
|
|
|
| Insert inbetween <tt><navit> ... </navit></tt> tags.<br /> See [[OSD]] for comprehensive information on on-screen display settings.
|

|-
! scope="row" rowspan="9"| vehicle
|
|
|
| Insert inbetween <tt><navit> ... </navit></tt> tags.
|
|- style="background:#EEEEEE"
| name
| 
| ''vehiclename''
| Name of the vehicle being defined. This can be any name you like, but it's usually best to provide descriptive names, perhaps depending on the gps source, or the type of vehicle.
| <tt>name="Car gpsd"</tt>
|- style="background:#EEEEEE"
| profilename
| 
| ''profilename''
| The name of the vehicle profile (see below) to use for routing and announcements for this vehicle.
| <tt>profilename="car"</tt>
|- style="background:#EEEEEE"
| source
| 
| 
| Source of GPS data. See [[Configuring_Navit#Vehicle]] for the available options.
| <tt>source="gpsd://localhost"</tt>
|-
| active
| 
| 0 / 1
| Makes the vehicle the active vehicle in Navit - i.e. all its options are used for routing, view centering and map redraws. Note that a vehicle must be <tt>enabled="yes"</tt> before it can be made <tt>active="1"</tt>.
| <tt>active="1"</tt>
|-
| baudrate
| baud rate
| 0 - &infin;
| Baudrate of the com port of a WinCE device. Required if <tt>source="wince:COMx:"</tt> (where <tt>x</tt> is the COM port of the gps device). The baud rate should be 4800 in most cases.
| <tt>baudrate="4800"</tt>
|-
| enabled
| 
| '''<tt>yes</tt>''' / <tt>no</tt>
| Enable the vehicle. This attribute enables you to define multiple vehicles within navit.xml (i.e. multiple <tt><vehicle> ... </vehicle></tt> tags), and quickly switch between them by changing the <tt>enabled</tt> status or by using the menu options within Navit.<br />If there is no <tt>enabled=</tt> tag, the vehicle is automatically enabled.
| <tt>enabled="yes"</tt>
|-
| follow
| 
| 0 - &infin;
| Specifies how many GPS updates to wait before map is refreshed. A value of zero means vehicle will leave the edge of the map before the map is refreshed.
| <tt>follow="1"</tt>
|-
| gpsd_query
| 
| ''gpsd query''
| Command to send to gpsd. Required if <tt>source="gpsd://localhost"</tt>, otherwise this is not used.<br /> The string used in the example is sufficient for use in Navit.
| <tt>gpsd_query="w+xj"</tt>

|-
! scope="row" rowspan="2"| tracking
|
|
|
| Insert inbetween <tt><navit> ... </navit></tt> tags.
|
|-
| cdf_histsize
| metres
| 0 - &infin;
| Cumulative displacement filter. '''Currently not used by Navit'''. See [http://julien.cayzac.name/code/gps/] for what it would do.
| <tt>cdf_histsize="4"</tt>

|-
! scope="row" rowspan="9"| vehicleprofile
|
|
|
| Insert inbetween <tt><navit> ... </navit></tt> tags.
|
|- style="background:#EEEEEE"
| name
| 
| ''profilename''
| The name of the vehicle profile. This name is used by the <tt>profilename</tt> attribute inside the <tt>vehicle</tt> tag.
| <tt>name="car"</tt>
|- style="background:#EEEEEE"
| flags
| 
| hex value
| The flags (as defined in AF_* in [http://navit.svn.sourceforge.net/viewvc/navit/trunk/navit/navit/attr.h?revision=3641&view=markup attr.h]) which needs to be set to be able to pass this road. See [[VehicleprofileFlags]] for a comprehensive list of bit values.
| <tt>flags="0x4000000"</tt>
|-
| flags_forward_mask
| 
| hex value
| The bits the <tt>flags_forward_mask</tt> has set in addition to <tt>flags</tt>, a way must not have set in order to be used in forward direction. More technically: the <tt>flags</tt> of a way are ANDed with this mask, if the route uses the way in forward direction. The result must match <tt>flags</tt> otherwise the way must not be used. E.g. flags_forward_mask="0x4000000" and flags_forward_mask="0x4000002" means a road may be used in forward direction if it is a ONEWAYREV (See [[VehicleprofileFlags]]).
| <tt>flags_forward_mask="0x40000000"</tt>
|-
| flags_reverse_mask
| 
| hex value
| Identical to <tt>flags_forward_mask</tt> for ways in the reverse direction.
| <tt>flags_reverse_mask="0x40000000"</tt>
|-
| maxspeed_handling
| 
| 0 - 2
| <tt>maxspeed_handling="0"</tt>: Always handle the maxspeed attribute of a street.<br /><tt>maxspeed_handling="1"</tt>: Only handle the maxspeed attribute of a street if it restricts the speed.<br /><tt>maxspeed_handling="2"</tt>: Never. Reason behind this is that a pedestrian doesn't want to travel with 30 km/h when there is a speed limit.
| <tt>maxspeed_handling="1"</tt>
|-
| route_mode
| 
| 0 - 2
| <tt>route_mode="0"</tt>: Automatically select between an on-road route and an off-road route (if the off-0road route is shorter than the distance to the next street from the current position plus the distance to the next street from the destination).<br /><tt>route_mode="1"</tt>: Always use an on-road route. <br /><tt>route_mode="2"</tt>:: Always us an off-road route
| <tt>route_mode="0"</tt>
|-
| static_speed
| km/h
| 0 - &infin;
| If the speed between positions from two gps updates is larger than <tt>static_speed</tt> Navit will accept the new position.
| <tt>static_speed="5"</tt>
|-
| static_distance
| metres
| 0 - &infin;
| If the distance between positions from two gps updates is larger than <tt>static_distance</tt> Navit will accept the new position.
| <tt>static_distance="25"</tt>

|-
! scope="row" rowspan="5"| roadprofile
|
|
|
| Insert inbetween <tt><vehicleprofile> ... </vehicleprofile></tt> tags.
|
|- style="background:#EEEEEE"
| item_types
| 
| 
| Types of ways for which this roadprofile is valid. '''Way types can be found in FIXME'''.
| <tt>item_types="steps"</tt>
|- style="background:#EEEEEE"
| route_weight
| km/h
| 0 - &infin;
| The weighting which the routing algorithm should give this road type. A large <tt>route_weight</tt> will force the routing algorithm to choose that road type over others when calculating a route. This value is also used to calculate the route time remaining IF <tt>maxspeed_handling="2"</tt>.
| <tt>route_weight="150"</tt>
|- style="background:#EEEEEE"
| speed
| km/h
| 0 - &infin;
| ns.
| <tt>speed="50"</tt>
|-
| maxspeed
| km/h
| 0 - &infin;
| When driving, Navit will use the <tt>maxspeed</tt> of the road type to inform the driver of the current speed limit using the [[OSD#speed_warner|speed_warner]]. <tt>maxspeed</tt> will only be used if there is no OSM speed data for that road. This data is '''not''' used for routing calculations.
| <tt>maxspeed="50"</tt>

|-
! scope="row" rowspan="3"| announcement
|
|
|
| Insert inbetween <tt><roadprofile> ... </roadprofile></tt> tags.
|
|- style="background:#EEEEEE"
| level
| 
| 0, 1, 2
| Type of oral announcement to make. For example, <tt>level="2"</tt> means an announcement such as "Turn left soon" will be made.
| <tt>level="0"</tt>
|- style="background:#EEEEEE"
| distance_metric
| metres
| 0 - &infin;
| Distance from the upcoming manoeuvre to perform the announcement.
| <tt>distance_metric="25"</tt>
|}