User Tools

Site Tools


manual:advanced:customization:config

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
manual:advanced:customization:config [2018/10/12 10:02] mstupkamanual:advanced:customization:config [2025/10/16 16:15] (current) – [Tweaks] mstupka
Line 2: Line 2:
  
 ---- ----
-===== Experimental ===== +===== Expert settings ===== 
-FIXME TO BE CREATED YET... FIXME +<WRAP center round info> 
-===== Configuration file =====+This section is IN CONTINUOUS DEVELOPMENT</WRAP>
  
-  * Since version 2.3.Locus Map offers advanced configuration options through //config.cfg// file stored in **Locus Map root directory** in your phone **memory**+Settings that are not essential for running the app and overall user experienceSome of these settings were removed from the general settings because of weak usage, some were found redundant, and some have a purpose only for advanced Locus Map users. 
 +==== Activation ==== 
 +  long press Locus **main menu button** 
 +  tap **Expert settings** 
 +  * Expert settings appear at the bottom of the Locus Map general settings 
  
-  * This file is automatically created during Locus Map first start (if it does not exist from its previous installation). Data are loaded at start and stored back to file in the endso even if this file allows changing some settings that are also changeable in the applicationsettings will not be lost.+==== UI/UX ==== 
 +=== Confirm on exit === 
 +It displays/hides a confirmation dialog when you exit the app by double-tapping the back button. 
 +=== Full screen === 
 +This hides system panels. Originally, in the general settings, it was removed as **not all devices support this option correctly**. 
 +=== Quick map switch - online === 
 +Sets the number of last used online maps (max 20displayed in the quick map switch menu in the **[[..:..:user_guide:mainscr_lpanel|map content panel]]**. 
 +=== Quick map switch - offline === 
 +Sets the number of the closest offline maps (max 20) displayed in the quick map switch menu in the **[[..:..:user_guide:mainscr_lpanel|map content panel]]**. 
 +=== Auto screen-lock === 
 +This activates the Locus Map app's [[..:..:user_guide:maps_mainscr_ctrl#magnifier_zoom_lock_screen_lock|screen lock]] automatically when you switch the screen off. 
 +=== Panels visible at start === 
 +This displays the function and information panels on the screen after the app's startdespite their "hidden" status. 
 +=== Display tips&tricks === 
 +Displays information boxes in various parts of the apphighlighting key features and usage instructions.
  
-==== Examples of some parameters ====+==== Maps ==== 
 +=== Hold map center timeout === 
 +Defines the period of time in seconds before your location is automatically centered on the map screen in case the **[[manual:user_guide:maps_mainscr_ctrl#controlling_the_map|Hold map center]]** is active. 
 +=== Enable GPS when centering === 
 +Turns the GPS on automatically (if it is disabled) when you tap the centering button. If turned off, the app centers on your latest fixed location. 
 +=== Dual centering button === 
 +Turns on the default button controlling both map centering and rotation. If turned off, two buttons appear on the screen - one for centering and one for rotating the map:\\ {{ :manual:advanced:customization:expert01.jpg?nolink |}} 
 +=== Smooth movement === 
 +Animated movement of the cursor during track recording, resulting in a "smooth" shift of the map. Increases the battery consumption a bit due to the high refresh frequency of the screen. 
 +=== Map movement step === 
 +Defines the map shift step in pixels. Used in case the map is controlled by hardware DPAD buttons. 
 +=== Fill map gaps with other zooms === 
 +Allows the use of lower and higher map zooms to cover empty spaces in an actual map zoom. Useful for various custom raster maps. 
 +=== Crop maps by coverage === 
 +With this option, the app takes the map coverage definition into account and stops loading map tiles outside of it. Useful for maps with a non-square shape. 
 +=== Double tap zoom only === 
 +When the Google style for map controlling is on, double-tapping a place on the map zooms in one level and shifts the map slightly towards the tapped place. This option omits the map shift. 
 +=== Min zoom scale === 
 +Here, you can define the minimum allowed scale for zooming the map out. The available range is 10-100% but the values below 50% may cause the app to stop responding. 
 +=== Automatic zoom lock === 
 +This option allows zooming the map in even when no more zoom levels are available - it resizes the lowest map zoom. 
 +=== Remember last zoom lock === 
 +The app remembers the zoom level that you locked last time. When you use the [[..:..:user_guide:maps_mainscr_ctrl#magnifier_zoom_lock_screen_lock|zoom lock]] next time, the map switches to the locked zoom level you locked before. 
 +=== Map scale font size === 
 +Here, you can define the font size for the map scale label 
 +=== Show date&time in toolbar === 
 +When activated, the top information panel item "time&battery status" also shows time and date. 
 +==== Map-screen content ==== 
 +==Accuracy circle color === 
 +Defines the color for the GPS accuracy circle around the location indicator
  
-=== guiding_path_map_symbol ===+Settings of auxiliary graphics used on the map screen: 
 +=== Dynamic elevation color, background, and text size === 
 +Defines the style of [[manual:user_guide:maps_settings#dynamic_elevation|dynamic elevation]] digits displayed at the cursor position. 
 +=== Entries above/below 'Cursor to GPS' === 
 +Defines parameters displayed above and below the [[manual:user_guide:maps_settings#cursor_to_position_line|Cursor to position line]] - distance, bearing, time of arrival, elevation, time to taget and ETA&time to target. 
 +=== Cursor to GPS line color, background and text size === 
 +Definition of the style of [[manual:user_guide:maps_settings#cursor_to_position_line|Cursor to position line]]. 
 +=== Course line color/background === 
 +Definition of the style of the [[manual:user_guide:maps_settings#course_line|Course line]] 
 +=== Heading line color/background === 
 +Definition of the style of the [[manual:user_guide:maps_settings#heading_line|Heading line]] 
 +=== Time circles color, background, text size === 
 +Definition of the style of the [[manual:user_guide:maps_settings#time_circles|Time circles]] 
 +=== Distance circles color, background, text size, color/background when no GPS === 
 +Definition of the style of the [[manual:user_guide:maps_settings#distance_circles|Distance circles]] 
 +=== Entries above/below auxiliary lines === 
 +Select parameters displayed above and/or below various lines in app - route planner, two-finger measurement, etc. - distance, bearing, time of arrival, elevation, time to target, and ETA&time to target. 
 +=== Tile hunters grid === 
 +Activates the option to select a tile hunter's grid (StatsHunters) in the map content panel grid selection (referring to zoom 14). 
 +=== Heading without GPS === 
 +Enables rotating and displaying the heading line even when the GPS is off. 
 +==== Map labels ==== 
 +=== Draw popup labels by zoom === 
 +Defines the zooms in which the track/route/point popup labels are displayed. "0" is the default and shows the labels always. "1-22 'include'" defines the zoom range. 
 +=== Label style === 
 +You can set the text color, background, highlighted background, border and highlighted border of a label.
  
-This parameter allows to define very precisely the shape and size of the guiding line. Best is to explain it on the default parameter.+**An example of transparent label background:** 
 + 
 +map_items_labels_color_text=#0A0A0A\\ 
 +map_items_labels_color_bg_normal=#4CF0F0F0\\ 
 +map_items_labels_color_border_normal=#19F0F0F0\\ 
 +map_items_labels_color_bg_highlight=#4CF0F0F0\\ 
 +map_items_labels_color_border_highlight=#19F0F0F0\\ 
 + 
 +See the difference (default and customized):  
 + 
 +{{:manual:advanced:customization:cfg_item_label_default.png?nolink&150|}} {{:manual:advanced:customization:cfg_item_label_custom.png?nolink&150|}} 
 +==== Points ==== 
 +=== New point name time format === 
 +Defines the format of the time used in a new point's name. Default is yyyy-MM-dd HH:mm:ss. 
 +=== Default icons === 
 +You can set the default icon for a new [[..:..:user_guide:points:add:|point]], [[..:..:user_guide:tracks:recording#recording_is_on|waypoint]] (entered during track recording) and [[..:..:user_guide:tracks:planning#via_points|via-point]] (entered during route planning) 
 +=== Center on point === 
 +By default, the points are centered when tapped, and their detail panel appears. Here you can switch the centering off. 
 +=== Simplify visible points === 
 +Here, you can define the map zoom level from which the point icons are simplified to a dot. The default is 10; 0 means that simplification is turned off. 
 +==== Tracks & routes ==== 
 +=== Fill color of ... chart === 
 +Custom settings of track/route chart line colors - altitude, cadence, gradient, heart-rate, speed, sensor speed and temperature. The color is defined both for a **track/route [[..:..:user_guide:tracks:about#elevation_chart|detail]]** and for **[[..:..:user_guide:tools:dashboards|dashboards]]**. 
 +=== Customize altitude threshold === 
 +This allows modifying the altitude threshold of all tracks in case the phone's GPS shows deviations or the calculated elevation gain seems exaggerated. When the option is turned on, a new control appears in a track detail [[..:..:user_guide:tracks:about#editing_info|edit screen]]. 
 +=== Track previews during import === 
 +When turned off, the import is a bit faster, especially when you import multiple tracks. 
 +=== Simplify visible tracks === 
 +Defines a map zoom level from which the number of visualized track points is reduced. 22 is the default. 
 +=== Track selection highlight === 
 +When turned on, a track or route tapped on the map is highlighted with a changed color. 
 +==== Import & export ==== 
 +=== Width of exported photos === 
 +Defines the width of photos attached to points, exported to KML. 60 px is the default.  
 +==== Navigation/guidance ==== 
 +=== Auto GPS on navigation === 
 +When navigation or guidance is started, the app turns GPS on, although it is turned off. 
 +=== Guidance path symbol === 
 +This parameter allows you to define the shape and size of the guiding line very precisely. Best to explain it on the default parameter.
  
 Basic values are: **-8.0|-2.0|7.0|0.0|-8.0|2.0** Basic values are: **-8.0|-2.0|7.0|0.0|-8.0|2.0**
  
-Imagine squared paper. Each two numbers mean X and Y coordinates. So draw them. Result will be as in the picture below. The same way you may draw whatever symbol you want.+Imagine paper with a grid. Each of the two numbers means the X and Y coordinates. So draw them. The result will be as in the picture below. In the same wayyou may draw whatever symbol you want.
  
 {{ :manual:advanced:customization:config_file_guiding_arrow.png?nolink |}} {{ :manual:advanced:customization:config_file_guiding_arrow.png?nolink |}}
  
-==== Examples of some settings ==== +**Examples:**\\ 
- +
----- +
-=== guiding_path_symbol === +
 {{:manual:advanced:customization:cfg_exmpl_guideline.png?nolink|}} {{:manual:advanced:customization:cfg_exmpl_guideline.png?nolink|}}
 guiding_path_symbol=-20|0|-20|-10|0|-10|0|-20|20|0|0|20|0|10|-20|10 guiding_path_symbol=-20|0|-20|-10|0|-10|0|-20|20|0|0|20|0|10|-20|10
Line 33: Line 139:
 {{:manual:advanced:customization:cfg_exmpl_guideline2.png?nolink|}}  {{:manual:advanced:customization:cfg_exmpl_guideline2.png?nolink|}} 
 guiding_path_symbol=-11|0|-14|-5|5|0|-14|5 guiding_path_symbol=-11|0|-14|-5|5|0|-14|5
 +=== Line/text color ===
 +FIXME to be added...
 +==== Route planner ====
 +=== Route planner - interpolation saving ===
 +When turned on, interpolation steps for manual segments are saved within the planned route.
  
-\\  +=== Routeplanner - interpolation step === 
-=== # MAP ITEMS STYLES === +Definition of distance between interpolated points on route for manual route drawing - affects slope/elevation coloring of the route line. Minimum 1m, recommended 100m. 
-<html> +==== Geocaching ==== 
-<table border="1" cellpadding="0" cellspacing="0"+=== Offline logging of trackables === 
-<tbody>+Support for logging trackables offline. To log the trackable online, use the log manager in the geocaching tools. 
 +==== Hardware controlling ==== 
 +<WRAP center round todo 60%> 
 +to be continued... 
 +</WRAP>
  
-<tr> +==== Tools ==== 
-<td style="width: 285px; background-color: rgb(230230230); font-weight: bold;">keyword</td> +=== Hardware buttons when 'screen lock' === 
-<td style="width: 80px; text-align: center; background-color: rgb(230, 230230); font-weight: bold;">default</td> +When enabledhardware buttons can control the app even when the screen is locked. 
-</tr>+=== Scroll to zoom === 
 +When enabledit is possible to zoom the map by scrolling controller (e.g. mouse when run on a PC
 +=== Record sensors data === 
 +When enabledall the phone sensors data are recorded in a file in Locus/data/sensors directory. 
 +=== Enable TTS over BT SCO === 
 +When enabled, TTS audio is played over a Bluetooth SCO module. 
 +==== Tweaks ==== 
 +=== Smooth interface === 
 +Enables animations and other tweaks for more comfortable experience. We recommend to use this only on fast devices. 
 +=== Allow login over Google Play Services === 
 +When switched off, only an email login to Locus Store or Live Tracking is possible. Recommended when MicroG service is used.
  
-<tr> +===== Configuration file =====
-<td>map_items_accuracy_circle_color</td><td style="text-align: center; background-color: #D0D0E0;">#0000FF</td> +
-</tr>+
  
-<tr> +  * Since version 2.3.2 Locus Map offers advanced configuration options through //config.cfg// file stored in **Locus Map root directory** in your phone **memory**
-<td>map_items_dynamic_altitude_font_size</td><td style="text-align: center;"><b>14.0</b></td> +
-</tr> +
-<tr> +
-<td>map_items_dynamic_altitude_color</td><td style="text-align: center; background-color: #FF0000;">#FF0000</td> +
-</tr> +
-<tr> +
-<td>map_items_dynamic_altitude_color_bg</td><td style="text-align: center; background-color: #FFFFFF;">#FFFFFF</td> +
-</tr>+
  
-<tr> +  * This file is automatically created on the Locus Map first start (if it does not exist from its previous installation). Data is loaded at start and stored back to the file in the endso even if this file allows changing some settings that are also changeable in the applicationthe settings will not be lost.
-<td>map_items_time_rings_font_size</td><td style="text-align: center;"><b>14.0</b></td> +
-</tr> +
-<tr> +
-<td>map_items_time_rings_color</td><td style="text-align: center; background-color: #FF0000;">#FF0000</td> +
-</tr> +
-<tr> +
-<td>map_items_time_rings_color_bg</td><td style="text-align: center; background-color: #FFFFFF;">#FFFFFF</td> +
-</tr> +
- +
-<tr> +
-<td>map_items_distance_rings_font_size</td><td style="text-align: center;"><b>14.0</b></td> +
-</tr> +
-<tr> +
-<td>map_items_distance_rings_color</td><td style="text-align: center; background-color: #3034D0;"><font color=white>#C80000C8</font></td> +
-</tr> +
-<tr> +
-<td>map_items_distance_rings_color_bg</td><td style="text-align: center; background-color: #FFFFFF;">#FFFFFF</td> +
-</tr> +
- +
-<tr> +
-<td>map_items_distance_rings_no_gps_color</td><td style="text-align: center; background-color: #9898E8;"><font color=white>#640000C8</font></td> +
-</tr> +
-<tr> +
-<td>map_items_distance_rings_no_gps_color_bg</td><td style="text-align: center; background-color: #FFFFFF;">#FFFFFF</td> +
-</tr> +
- +
-<tr> +
-<td>map_items_heading_line_color</td><td style="text-align: center; background-color: #EC9000;">#EC9000</td> +
-</tr> +
-<tr> +
-<td>map_items_heading_line_color_bg</td><td style="text-align: center; background-color: #FFFFFF;">#FFFFFF</td> +
-</tr> +
- +
-<tr> +
-<td>map_items_course_bearing_line_color</td><td style="text-align: center; background-color: #FA3232;">#FA3232</td> +
-</tr> +
-<tr> +
-<td>map_items_course_bearing_line_color_bg</td><td style="text-align: center; background-color: #FFFFFF;">#FFFFFF</td> +
-</tr> +
- +
-<tr> +
-<td>map_items_line_to_gps_font_size</td><td style="text-align: center;"><b>14.0</b></td> +
-</tr> +
-<tr> +
-<td>map_items_line_to_gps_color</td><td style="text-align: center; background-color: #009696;">#009696</td> +
-</tr> +
-<tr> +
-<td>map_items_line_to_gps_color_bg</td><td style="text-align: center; background-color: #FFFFFF;">#FFFFFF</td> +
-</tr> +
- +
-<tr> +
-<td>map_items_guiding_font_size</td><td style="text-align: center;"><b>14.0</b></td> +
-</tr> +
-<tr> +
-<td>map_items_guiding_color</td><td style="text-align: center; background-color: #009696;">#009696</td> +
-</tr> +
-<tr> +
-<td>map_items_guiding_color_bg</td><td style="text-align: center; background-color: #FFFFFF;">#FFFFFF</td> +
-</tr> +
- +
-</tbody> +
-</table> +
-</html> +
- +
-=== # MAP ITEMS === +
-<html> +
-<table border="1" cellpadding="0" cellspacing="0"> +
-<tbody> +
-<tr> +
-<td style="width: 285px; background-color: rgb(230, 230, 230); font-weight: bold;">keyword</td> +
-<td style="width: 80px; text-align: center; background-color: rgb(230230230); font-weight: bold;">default</td> +
-</tr> +
-<tr> +
-<td>map_items_labels_color_text</td><td style="text-align: center; background-color: #0A0A0A;"><font color=white>#0A0A0A</font></td> +
-</tr> +
-<tr> +
-<td>map_items_labels_color_bg_normal</td><td style="text-align: center; background-color: #F0F0F0;">#DCF0F0F0</td> +
-</tr> +
-<tr> +
-<td>map_items_labels_color_border_normal</td><td style="text-align: center; background-color: #383838;"><font color=white>#DC0A0A0A</font></td> +
-</tr> +
-<tr> +
-<td>map_items_labels_color_bg_highlight</td><td style="text-align: center; background-color: #F0F0F0;">#DCF0F0F0</td> +
-</tr> +
-<tr> +
-<td>map_items_labels_color_border_highlight</td><td style="text-align: center; background-color: #A02420;"><font color=white>#DC960A0A</font></td> +
-</tr> +
-</tbody> +
-</table> +
-</html> +
-example of transparent label background: +
- +
-map_items_labels_color_text=#0A0A0A\\ +
-map_items_labels_color_bg_normal=#4CF0F0F0\\ +
-map_items_labels_color_border_normal=#19F0F0F0\\ +
-map_items_labels_color_bg_highlight=#4CF0F0F0\\ +
-map_items_labels_color_border_highlight=#19F0F0F0\\ +
- +
-see difference (default and customized)  +
- +
-{{:manual:advanced:customization:cfg_item_label_default.png?nolink&150|}} {{:manual:advanced:customization:cfg_item_label_custom.png?nolink&150|}} +
-----+
  
-[[http://www.w3schools.com/tags/ref_colorpicker.asp|Colorpicker]] +<WRAP center round info> 
-----+As this method has become obsolete and is quite user-unfriendly, settings included in this configuration file are moved gradually to the **Expert settings** section mentioned above. 
 +</WRAP>
manual/advanced/customization/config.1539331343.txt.gz · Last modified: (external edit)