Difference between revisions of "User:Cs"

From Navit's Wiki
Jump to: navigation, search
m (Creating user page for new user.)
 
Line 1: Line 1:
 +
neo-cs skin documentation
 +
-------------------------
  
 +
About the skin:
 +
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.
 +
 +
Features:
 +
* Automatic activation of osd icons only needed if the device has a fix if there is one.
 +
* Automatic switching between tracking and routing mode.
 +
* Display of the routing status.
 +
* Important options are accessible directly from the osd (see skin description)
 +
 +
Screenshots:
 +
can be found in the tarball.
 +
 +
Skin description:
 +
The screen has three zones:
 +
* A top bar - where routing maneuvers are displayed. Tapping to top bar toggles between fullscreen and windowed mode
 +
* In screen displays and buttons:
 +
  - 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 (AZ/MZ) - toggle between manual zooming and speed dependant automatic zoom (1).
 +
  - Follow mode - the map is either dragged by the vehcle cursor or can be moved around manually (1).
 +
  - Map orientation - toggle between a north oriented map and a map oriented by the travel direction (1).
 +
  - Zoom in / out buttons.
 +
  - Routing Status - tapping on the Icon zooms to full route view, or to the entered destination.
 +
  - 2D / 3D toggle.
 +
  - A small scale to estimate distances
 +
* A bottom bar - where the current road (if any) is displayed, a little compass (1) and the gps quality. Furthermore there is a second line 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 at the second line.
 +
  - 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
 +
 +
Installation:
 +
For Debian 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 nevit 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/').
 +
* Some attribute under the navit tag in navit.xml should be set:
 +
  - osd_configuration = "1" - otherwise osd elements that should be not visibe by default are shown.
 +
  - tracking="1" - to snap on to roads.
 +
  - timeout="1" - to immediately resume the map draging by the vehicle, since we have a button if we really want to look something on the map.
 +
  - radius="27" - a slightly increased distance between the vehicle cursor and the display edges.
 +
* Some attribute under the vehicle in navit.xml can also be set by default:
 +
  - follow="1" - how often the map is updated, should be on a lower level for gta02 i.e. "8"
 +
  - lag="15" - a practical value I tested for the gps lag (in 1/10 sec.)
 +
  - follow_cursor="1" - to enable the map following the vehicle by default
 +
I've put my configuration files in the tarball as the 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 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:
 +
* 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.
 +
* Due to the limitations of the configuration options of the gui, the control mechanisms are more complicated than the could be.
 +
* 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 thinks 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.

Revision as of 08:29, 13 January 2013

neo-cs skin documentation


About the skin: 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.

Features:

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

Screenshots: can be found in the tarball.

Skin description: The screen has three zones:

  • A top bar - where routing maneuvers are displayed. Tapping to top bar toggles between fullscreen and windowed mode
  • In screen displays and buttons:
 - 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 (AZ/MZ) - toggle between manual zooming and speed dependant automatic zoom (1).
 - Follow mode - the map is either dragged by the vehcle cursor or can be moved around manually (1).
 - Map orientation - toggle between a north oriented map and a map oriented by the travel direction (1).
 - Zoom in / out buttons.
 - Routing Status - tapping on the Icon zooms to full route view, or to the entered destination.
 - 2D / 3D toggle.
 - A small scale to estimate distances
  • A bottom bar - where the current road (if any) is displayed, a little compass (1) and the gps quality. Furthermore there is a second line 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 at the second line.
 - 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

Installation: For Debian 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 nevit 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/').
  • Some attribute under the navit tag in navit.xml should be set:
 - osd_configuration = "1" - otherwise osd elements that should be not visibe by default are shown.
 - tracking="1" - to snap on to roads.
 - timeout="1" - to immediately resume the map draging by the vehicle, since we have a button if we really want to look something on the map.
 - radius="27" - a slightly increased distance between the vehicle cursor and the display edges.
  • Some attribute under the vehicle in navit.xml can also be set by default:
 - follow="1" - how often the map is updated, should be on a lower level for gta02 i.e. "8"
 - lag="15" - a practical value I tested for the gps lag (in 1/10 sec.)
 - follow_cursor="1" - to enable the map following the vehicle by default

I've put my configuration files in the tarball as the 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 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:

  • 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.
  • Due to the limitations of the configuration options of the gui, the control mechanisms are more complicated than the could be.
  • 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 thinks 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.