Changes between Version 19 and Version 20 of SystemFunctionalityEN


Ignore:
Timestamp:
Jan 6, 2013 2:29:29 PM (7 years ago)
Author:
Martin Kolman
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • SystemFunctionalityEN

    v19 v20  
    33[[PageOutline]]
    44
    5 == Track logging/recording ==
    6 !ModRana supports track recording, diretly to a GPX file. This file can be named and logging and saving interval can be set directly from the logging menu. Logging can be paused or split, eq old log is saved and a new one is started imediately. If you entered a new name while logging was in progress, the next log will use it. All logs are saved to the log cathegory in tracklogs menu.
    7 
    8 === In which folder are logs stored ? ===
    9 ==== Default location ====
    10 By default, newly recorded tracklogs are stored in the tracklogs folder in modRana profile:
    11 
    12 {{{
    13 ~/.modrana/tracklogs/logs/
    14 }}}
    15 
    16 ==== N900 & N9 ====
    17 Tracklogs are stored in the ''!MyDocs'' folder, that is accessible using mass storage if the device is connected to a computer with USB.
    18 
    19 {{{
    20 /home/user/MyDocs/tracklogs/logs/
    21 }}}
    22 
    23 NOTE: !ModRana can't record a tracklog while the mas storage mode is active, because the ''!MyDocs'' folder is not available for applications running on the device during this.
    24 
    25 == Map layer configuration ==
    26 
     5== GUI ==
     6=== Main menu button hiding ===
     7!ModRana supports hiding of the main buttons, so they don't obstruct parts of the map.
     8This feature can be configured in '''menu->Options->view->hide main buttons''', the default is "hide after 15 seconds".
     9
     10[[Image(wiki:SystemFunctionality:rana_normal_main_buttons.jpg, 25%)]] [[Image(wiki:SystemFunctionality:rana_hidden_main_buttons.jpg, 25%)]]
     11
     12=== Fullscreen toggle ===
     13!ModRana can be set to a fullscreen mode. Fullscreen can be toggled with the appropriate button from the map screen.
     14
     15=== New position indicator ===
     16Old position indicator from Rana was replaced by a new [http://www.tangogps.org/ TangoGPS] inspired indicator. The immediate are of the current position is now better visible and for low speed, the direction is not show, as it is unreliable when the speed is too low.
     17
     18[[Image(wiki:SystemFunctionality:new_marker_maemo5_emu_fullscreen.png, 50%)]]
     19
     20''A demonstration of the new position indicator, shown in N900 emulator''
     21
     22=== Notification support ===
     23!ModRana has a support for displaying notifications. They are used to notify about important events, that are not readily visible from the state of the user interface, such as a batch download finishing.
     24
     25The modRana notification system is GUI toolkit independent and either draws the notifications by itself of uses the platform notification method, if available.
     26
     27=== OSD information widgets ===
     28The information widgets can be configured in '''user_config.conf''' in the main modRana folder. The configuration file is heavily self documenting, so it should be easy to personalize the widgets to your liking :)
     29
     30In the future, interactive widgets configuration directly from the GUI is planed.
     31
     32== Map ==
     33
     34=== Map layer configuration ===
    2735Map layers are defined in ''''''map_config.conf''''' in the modRana main fiolder.
    2836
     
    5361 * tile storage and loading is compatible with TangoGPS
    5462
    55 == Configuring map layer path ==
    56 
     63=== Configuring map layer path ===
    5764Path for a map layer consists from the main tile folder path and a layer folder.
    5865 * the main tile folder is configured using the '''tile_folder''' variable in '''''user_config.conf'''''
     
    6774This results in this path: '''/media/card/maps/osm_mapnik/'''
    6875
    69 == Main buttons hiding ==
    70 !ModRana supports hiding of the main buttons, so they don't obstruct parts of the map.
    71 This feature can be configured in '''menu->Options->view->hide main buttons''', the default is "hide after 15 seconds".
    72 
    73 [[Image(wiki:SystemFunctionality:rana_normal_main_buttons.jpg, 25%)]] [[Image(wiki:SystemFunctionality:rana_hidden_main_buttons.jpg, 25%)]]
    74 
    75 == Fullscreen toggle ==
    76 !ModRana can be set to a fullscreen mode. Fullscreen can be toggled with the appropriate button from the map screen.
    77 
    78 == New position indicator ==
    79 Old position indicator from Rana was replaced by a new [http://www.tangogps.org/ TangoGPS] inspired indicator. The immediate are of the current position is now better visible and for low speed, the direction is not show, as it is unreliable when the speed is too low.
    80 
    81 [[Image(wiki:SystemFunctionality:new_marker_maemo5_emu_fullscreen.png, 50%)]]
    82 
    83 ''A demonstration of the new position indicator, shown in N900 emulator''
    84 
    85 == Batch tile download ==
     76=== Transparent map overlay ===
     77This feature can be activated in '''options -> map -> Map as overlay'''. Any map layer can be used as the background or overlay. Transparency can be set in the 25-100% range. 100% (fully opaque) should be used only for layers, that contain transparent areas. :)
     78
     79=== Batch tile download ===
    8680!ModRana supports advanced batch tile download with various download options:
    8781 * '''where:''' around the ''current position'', around the ''area currently visible on the map'' or around a ''tracklog''
     
    9589!ModRana can also estimate the size of the currently configured batch download. In this mode, modRana just downloads headers of all tiles in the batch to find out their size.
    9690
    97 == Notification support ==
    98 !ModRana has a support for displaying notifications. They are used to notify about important events, that are not readily visible from the state of the user interface, such as a batch download finishing.
    99 
    100 The modRana notification system is GUI toolkit independent and either draws the notifications by itself of uses the platform notification method, if available.
    101 
    102 == Optimized tracklog drawing, tracklog manager ==
     91
     92== Tracklogs ==
     93
     94=== Track logging/recording ===
     95!ModRana supports track recording, diretly to a GPX file. This file can be named and logging and saving interval can be set directly from the logging menu. Logging can be paused or split, eq old log is saved and a new one is started imediately. If you entered a new name while logging was in progress, the next log will use it. All logs are saved to the log cathegory in tracklogs menu.
     96
     97=== In which folder are tracklogs stored ? ===
     98'''Default location'''
     99By default, newly recorded tracklogs are stored in the tracklogs folder in modRana profile:
     100
     101{{{
     102~/.modrana/tracklogs/logs/
     103}}}
     104
     105'''N900 & N9'''
     106
     107Tracklogs are stored in the ''!MyDocs'' folder, that is accessible using mass storage if the device is connected to a computer with USB.
     108
     109{{{
     110/home/user/MyDocs/tracklogs/logs/
     111}}}
     112
     113NOTE: !ModRana can't record a tracklog while the mass-storage mode is active, because the ''!MyDocs'' folder is not available to store them.
     114
     115=== Optimized tracklog drawing, tracklog manager ===
    103116Tracklogs in the [http://www.topografix.com/gpx.asp GPX] format are supported. Drawing of tracklogs is highly optimized, so it is possible to show many tracklogs at once.
    104117
    105118Visible tracklogs are reopened on startup.
    106119
    107 == Adding of elevation data to tracklog == #add_elevation
     120=== Adding of elevation data to tracklog === #add_elevation
    108121!ModRana supports adding of elevation data from [http://www.geonames.org/ Geonames] to tracklogs. The new elevation data (for all points in tracklog) is also saved to the corresponding tracklog GPX file (so it can be used by other applications). The [#route_profile route profile] feature uses the elevation data to showing the graph.
    109122
    110 == Route profile drawing == #route_profile
     123== Routing & Navigation ==
     124
     125=== Online routing using Google Directions ===
     126
     127Online routing in modRana uses Google Directions. Its an '''online''' search, so it '''won't work without Internet connectivity''' While searching for a route, the current mode is respected. For "walking mode" walking directions are selected, for "car mode", directions for a motor vehicles are used. Actually, all other modes than "walking"" currently get directions for motor vehicles. In '''options->Online routing''' toll and highway avoidance can be activated.
     128
     129Start and destination for the route can be sat on the map. It is also possible to route ''to'' and ''from'' the current position. !ModRana also supports address2address routing, POI search results and saved POI can be also used as routing destinations.
     130
     131[http://www.youtube.com/watch?v=fuFGxU29ytc This video shows how routing in modRana works.][youtube]
     132
     133=== Route profile drawing === #route_profile
    111134If a tracklogs contains elevation data for its points, a route elevation profile is shown. The route profile can be also activated as an information widget.
    112135
    113136to add elevation data top a tracklog, use the feature for [#add_elevation adding elevation data to tracklog].
    114137
    115 == POI manager ==
     138== POI ==
     139=== POI manager ===
    116140
    117141Sorted POI are shown in a list. POI created from Google Local Search results contain all the additional information. A POI can be used as a target for routing.
    118142
    119 == POI search with Google Local Search ==
    120 
     143=== POI search with Google Local Search ===
    121144!ModRana supports online POI search, centered either around current position or the in the currently visible area on the map.
    122145Results contain various metadata, such as street address and telephone numbers (not for all results). They can be also saved to the modRana POI database or used as target for routing.
     
    128151Searching for a custom query is also possible using the '''custom query'' button.
    129152
    130 == Online routing using Google Directions ==
    131 
    132 Online routing in modRana uses Google Directions. Its an '''online''' search, so it '''won't work without Internet connectivity''' While searching for a route, the current mode is respected. For "walking mode" walking directions are selected, for "car mode", directions for a motor vehicles are used. Actually, all other modes than "walking"" currently get directions for motor vehicles. In '''options->Online routing''' toll and highway avoidance can be activated.
    133 
    134 Start and destination for the route can be sat on the map. It is also possible to route ''to'' and ''from'' the current position. !ModRana also supports address2address routing, POI search results and saved POI can be also used as routing destinations.
    135 
    136 [http://www.youtube.com/watch?v=fuFGxU29ytc This video shows how routing in modRana works.][youtube]
    137 
    138 == Transparent map overlay ==
    139 
    140 This feature can be activated in '''options -> map -> Map as overlay'''. Any map layer can be used as the background or overlay. Transparency can be set in the 25-100% range. 100% (fully opaque) should be used only for layers, that contain transparent areas. :)
    141 
    142 == OSD information widgets ==
    143 The information widgets can be configured in '''user_config.conf''' in the main modRana folder. The configuration file is heavily self documenting, so it should be easy to personalize the widgets to your liking :)
    144 
    145 In the future, interactive widgets configuration directly from the GUI is planed.
    146 
    147 == Configuration file ==
     153== Configuration files ==
    148154the configuration file is called '''user_config.conf''', it is present in the main modRana folder. The following can be set:
    149155 * ''path to the tile folder''