From Navit's Wiki
Jump to: navigation, search

Christian's sandox[edit]

This page was for drafting only and the info on this page may be outdated, please use OSD_Layouts#neo-cs instead.


About the skin[edit]

This skin was developed for the relatvely small screen (in comparison to todays smartphones) of the neo freerunner featuring a resolution of 480 x 640 pixel. I haven't tested the more recent version only on the gta04 hardware regarding the performance. The skin should work in portrait and landscape mode as well. Since the svg files are included, the skin is fairly easy to adjust to larger screens. Please put modified versions of the skin back on this page.


  • Automatic activation of osd icons only needed if there is a gps fix.
  • Automatic switching between tracking and routing mode.
  • Display of the routing status with five icons.
  • Important options are accessible directly from the osd (see skin description)


Error creating thumbnail: Unable to save thumbnail to destination
Error creating thumbnail: Unable to save thumbnail to destination
without gps fix with gps fix in tracking mode
Error creating thumbnail: Unable to save thumbnail to destination
Error creating thumbnail: Unable to save thumbnail to destination
in routing mode in routing mode with active odometer in the second line of the bottom bar

Skin description[edit]

The osd provides a top bar, a bottom bar and several icons within the map area:

  • The top bar
    where routing maneuvers are displayed.
    Tapping on the top bar toggles between fullscreen and windowed mode
  • The in screen buttons and displays:
    • Current speed (1)
      tapping on the speed display toggles between some routing or tracking informations and the odometer in the bottom bar (see below).
    • Current altitude (1)
    • Autozoom (1)
      a toggle between manual zooming and speed dependant automatic zoom.
    • Follow mode (1)
      the map is either dragged by the vehcle cursor or can be moved around manually.
    • Map orientation (1)
      toggle between a north oriented map and a map oriented by the travel direction.
    • Zoom in / out buttons.
    • Routing status icon
      tapping on the icon zooms to full route view, or to the entered destination.
    • 2D / 3D toggle.
    • A small scale to estimate distances.
  • The bottom bar
    where the current road (if any) is displayed, a little compass (1) and the gps quality
    Furthermore there is a second line in the bottom bar which depends on the mode we're in:
    • Tracking mode
      shows the position on the second line.
    • Routing mode
      shows the estimated time of arrival, the distance to destination and the estimated remaining travel duration on the second line.
    • Odometer
      when the odometer is active (see above), the second line is used for travel distance, travel time and average speed. Tapping on the odometer line will stop / resume the odometer, double tapping resets the odometer

1). Only visible if there is a gps fix


Until I find somewhere more suited I'll put the skin on my playground: neo-cs skin
Additionally you can find my latest arm built of navit for debian squeeze here: svn5337 debian squeeze arm

Installation and configuration[edit]

For Debian users I can provide a Debian package, other distributions or platforms have to unpack the tarball and put the skinfiles in the right place. There are some things to be mentioned:

  • The skin is designed to be placed in the navit share path $NAVIT_SHAREDIR (usually /usr/share/navit) under ./skins/neo-cs/. If this isn't the case, all the icon paths has to be adjusted to your needs (i.e. $HOME/.navit/skins/neo-cs/icons/).
  • If you have to or want to install the skin manually from the tarball, simply place neo-cs.xml in /usr/share/navit/skins/neo-cs/ and the icons (you need only the png's) in /usr/share/navit/skins/neo-cs/icons/, or to any other place you like if you modify the icon path in neo-cs.xml.
  • Include the skin somewhere in your navit.xml and make sure there are no other osd definitions:
<xi:include href="$NAVIT_SHAREDIR/skins/neo-cs/neo-cs.xml"/>
  • Some attribute under the navit tag in navit.xml should be set:
otherwise osd elements that should be not visibe by default are shown.
to snap on to roads.
to immediately resume the map draging by the vehicle, since we have a button if we really want to look something on the map.
a slightly increased distance between the vehicle cursor and the display edges.
  • Some attribute under the vehicle tag in navit.xml my also be set by default:
how often the map is updated, should be on a lower level for gta02 i.e. "8"
a practical value I tested for the gps lag (in 1/10 sec.)
to enable the map following the vehicle by default

I've put my configuration files in the tarball as they might be usefull as a starting point. The included navit.xml isn't a complete configuration, just a skeleton in which all the stuff from the original config file is included. I find it more convenient to have just a small file to modify rather than to edit everywhere in the complete configuration file. That way I have only to look for new layouts or vehicleprofiles to include in case of a navit update.

Known issues, bugs and TODO[edit]

  • In older navit versions the routing status icon will appear in the internal gui. This isn't a skin bug as it is fixed in the recent svn versions of navit.
  • There is a slight refresh delay of the seperator png's when toggling between odometer and the other display modes.
  • The scale should be not visible in 3D view, but it allways shows up.
  • I haven't found a better way to decide if there's a gps fix than to watch if there are at least three satelites in use. Therefore it's possible that, for a period of time, the gui decides there's a fix when the gps actually hasn't one. If someone knows a better (available) way, please let me know.
  • The positioning of the odometer isn't that nice, since all the values (distance, time and avg. speed) can only be placed as one object.