Differences

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

--- manual:advanced:customization:config [2015/05/15 07:13] – created mstupka
+++ manual:advanced:customization:config [2023/05/05 14:14] (current) – [Examples of some settings] mstupka
@@ Line 1: / Line 1: @@
-====== Configuration File ======
+====== Custom settings ======
 ----
-<WRAP todo round center 60%>This page is obsolete and will be reworked soon</WRAP>
+===== Expert settings =====
-<WRAP box left>
+<WRAP center round info>
-  * Locus type: <html><b><a href="https://play.google.com/store/apps/details?id=menion.android.locus&amp;referrer=utm_source%3Ddocs%26utm_medium%3Dheader%26utm_content%3Dconfiguration_file" target="_blank">Free</a>/<a href="https://play.google.com/store/apps/details?id=menion.android.locus.pro&amp;referrer=utm_source%3Ddocs%26utm_medium%3Dheader%26utm_content%3Dconfiguration_file" target="_blank">Pro</a></b></html>, **2.3.2+**
+This section is still IN DEVELOPMENT - settings from the Config.cfg file are being moved to a special part of the settings within the app
-  * Last updated manual: **2.3.2**
 </WRAP>
-===== Description =====
+----
-  * Since version 2.3.2, Locus offer advanced configuration possibilities through //config.cfg// file placed into **root directory of Locus** on your **card/memory**
+Settings that are not essential for running the app and overall user experience. Some of these settings were removed from the main settings because of weak usage, some were found redundant and some have a purpose only for advanced Locus users.
+==== Activation ====
+  * long press Locus **main menu button**
+  * tap **Expert settings**
+  * Expert settings appear in Locus Map settings
-  * This file is manually created when Locus starts for first (if not exist). Data are loaded at start and flushed in the end back to file, so if this file allow changing some settings that are also changeable in the application, settings will not be lost.
+==== UI/UX ====
+=== Open main menu by dragging ===
+Turning this on enables you to open Locus main menu by swiping your device screen left edge to right.
+=== Confirm on exit ===
+Turn this on if you need confirmation of Locus terminantion after double tapping hardware **back** button.
+=== Default search/sort location ===
+Set your favorite location to search around:
+  * GPS fixed position
+  * Map screen center - cursor
-===== Explanations of some parameters =====
+=== Quick map switch, online maps ===
+Define number of displayed online maps in the Quick map switch selection of last used maps (max 20)
+=== Quick map switch, offline maps ===
+Define the number of displayed maps in the Quick map switch selection of the closest offline maps (max 20)
+==== Maps ====
+=== Hold map center timeout ===
+Define the period of time before your position is automatically centered on the map screen in case **[[manual:user_guide:maps_mainscr_ctrl#controlling_the_map|Hold map center]]** is active.
+=== Map hardware acceleration ===
+When enabled, map rendering is processed faster but with more battery consumption.
+=== Map movement step ===
+Defined in pixels, used in case the map is controlled by hardware DPAD buttons.
+=== Fill map gaps with other zooms ===
+Allows to use lower and higher map zooms to cover empty spaces in an actual map zoom.
+==== Map content ====
+Settings of auxuliary graphics used on the map screen.
+=== Dynamic elevation, text size, color and background color ===
+Defines style of [[manual:user_guide:maps_settings#dynamic_elevation|dynamic elevation]] digits displayed at the cusor position.
+=== Values 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 bearing 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 rings color, background, text size ===
+Definition of the style of the [[manual:user_guide:maps_settings#time_circles|Time circles]]
+=== Distance rings color, background, text size ===
+Definition of the style of the [[manual:user_guide:maps_settings#distance_circles|Distance circles]]
+=== Values above/below map lines ===
+Select parameters displayed above an/or below various lines in app - route planner, two-finger measurement etc. - distance, bearing, time of arrival, elevation, time to taget and ETA&time to target.
+==== Tracks ====
+=== Fill color of chart with... ===
+Custom settings of track/route chart line colors.
+==== Route planner ====
+=== Route, interpolation step ===
+Definition of distance between interpolated points on route for manual route drawing - affects slope/elevation coloring of the route line. Minimum 1m.
-==== guiding_path_map_symbol ====
+==== Tools ====
+=== Hardware buttons when 'screen lock' ===
+When enabled, hardware buttons can control the app even when the screen is locked.
+=== Scroll to zoom ===
+When enabled, it is possible to zoom the map by scrolling controller (e.g. mouse when run on a PC)
+=== Record sensors data ===
+When enabled, all 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 e-mail login to Locus Store or Live Tracking is possible. Recommended when MicroG service is used.
-This parameter allows to define very precisely, shape and size of guiding line. Best is to explain it on default parameter.
+FIXME TO BE CONTINUED... FIXME
-Baisc values are: **-8.0|-2.0|7.0|0.0|-8.0|2.0**
+===== Configuration file =====
-Imagine squared paper. Every two numbers, means X and Y coordinates. So draw them. Result will be as on screen below. With same way, you may draw whatever symbol you want.
+  * 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**
-{{ :manual:customization:config_file_guiding_arrow.png |}}
+  * 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 end, so even if this file allows changing some settings that are also changeable in the application, settings will not be lost.
-===== Examples of some settings =====
+<WRAP center round info>
+As this method has become obsolete and is quite user unfriendly, settings included in this configuration file are going to be moved gradually to the **Expert settings** section above.
+</WRAP>
-----
+==== Examples of some parameters ====
-==== guiding_path_symbol ====
-{{:manual:settings:cfg_exmpl_guideline.png|}}
+=== guiding_path_map_symbol ===
-guiding_path_symbol=-20|0|-20|-10|0|-10|0|-20|20|0|0|20|0|10|-20|10
+This parameter allows to define very precisely the shape and size of the guiding line. Best is to explain it on the default parameter.
-{{:manual:settings:cfg_exmpl_guideline2.png|}}
+Basic values are: **-8.0|-2.0|7.0|0.0|-8.0|2.0**
-guiding_path_symbol=-11|0|-14|-5|5|0|-14|5
-<html><hr></html>
+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.
-==== map items ====
-<html>
+{{ :manual:advanced:customization:config_file_guiding_arrow.png?nolink |}}
-<table border="1" cellpadding="0" cellspacing="0">
-<tbody>
-<tr>
+==== Examples of some settings ====
-<td style="width: 250px; background-color: rgb(230, 230, 230); font-weight: bold;">keyword</td>
-<td style="width: 80px; text-align: center; background-color: rgb(230, 230, 230); font-weight: bold;">default</td>
-</tr>
-<tr>
+----
-<td>map_items_accuracy_circle_color</td><td style="text-align: center; background-color: #0000FF;"><font color=white>#0000FF</font></td>
+=== guiding_path_symbol ===
-</tr>
-<tr>
+{{:manual:advanced:customization:cfg_exmpl_guideline.png?nolink|}}
-<td>map_items_dynamic_altitude_font_size</td><td style="text-align: center;">14.0</td>
+guiding_path_symbol=-20|0|-20|-10|0|-10|0|-20|20|0|0|20|0|10|-20|10
-</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>
-<td>map_items_time_rings_font_size</td><td style="text-align: center;">14.0</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>
+{{:manual:advanced:customization:cfg_exmpl_guideline2.png?nolink|}}
-<td>map_items_distance_rings_font_size</td><td style="text-align: center;">14.0</td>
+guiding_path_symbol=-11|0|-14|-5|5|0|-14|5
-</tr>
-<tr>
-<td>map_items_distance_rings_color</td><td style="text-align: center; background-color: #C86400;">#C86400</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_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>
+**example of transparent label background:**
-<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>
+map_items_labels_color_text=#0A0A0A\\
-<td>map_items_line_to_gps_font_size</td><td style="text-align: center;">14.0</td>
+map_items_labels_color_bg_normal=#4CF0F0F0\\
-</tr>
+map_items_labels_color_border_normal=#19F0F0F0\\
-<tr>
+map_items_labels_color_bg_highlight=#4CF0F0F0\\
-<td>map_items_line_to_gps_color</td><td style="text-align: center; background-color: #009696;">#009696</td>
+map_items_labels_color_border_highlight=#19F0F0F0\\
-</tr>
-<tr>
-<td>map_items_line_to_gps_color_bg</td><td style="text-align: center; background-color: #FFFFFF;">#FFFFFF</td>
-</tr>
-<tr>
+**see the difference (default and customized)**
-<td>map_items_guiding_font_size</td><td style="text-align: center;">14.0</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>
+{{:manual:advanced:customization:cfg_item_label_default.png?nolink&150|}} {{:manual:advanced:customization:cfg_item_label_custom.png?nolink&150|}}
-</table>
+----
-</html>
 [[http://www.w3schools.com/tags/ref_colorpicker.asp|Colorpicker]]
-<html><hr></html>
+----

knowledge base

User Tools

Site Tools

Differences