User Tools

Site Tools


manual:advanced:customization:icons

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:icons [2023/05/04 08:57] – [Making your own icon pack] mstupkamanual:advanced:customization:icons [2025/03/13 09:33] (current) mstupka
Line 3: Line 3:
 ---- ----
  
-Locus Map enables using custom icons for **Points** and also **Tracks** folders. :!: **Custom icons are not supported in Livetracking**.+Locus Map enables using custom icons for **Points**, points folders, and also **Tracks/routes** folders (custom icons are **not supported in Livetracking**).
  
-Once you create or download an icon pack you may simply select folder icons in **Folder Add/edit dialog** or in **Edit dialog** for points (simply tap on point and choose edit from sub-menu)+Once you create or download an icon pack you may simply select folder icons in **Folder add/edit dialog** or in **Edit dialog** for points (simply tap on point and choose edit from sub-menu)
  
 ==== Basics ==== ==== Basics ====
  
-  * **directory**: //Locus/icons/ //+  * **directory**: usually //Android/data/menion.android.locus/files/Locus/icons/ // (check in the "About App" section of the main menu)
   * **pack**: zipped (*.zip)   * **pack**: zipped (*.zip)
 +<WRAP center round tip>
 +On Android 11 and newer OS versions, it is almost impossible to access the /Android/data/ sector. Therefore, **[[manual:user_guide:settings:backup_fsys#set_the_main_directory|move the main app directory to /Android/media/]]** sector which is fully accessible with common file browsers.
 +</WRAP>
  
 ==== Making your own icon pack ==== ==== Making your own icon pack ====
  
-  * pack the icons to a ZIP file and copy it into the **Locus/icons** directory. **DO NOT compress a folder with icons** - the icons must be in the root of the ZIP file. +  * create or download custom icons in **.PNG** format 
-  * choose which icons (internal Locus or any of your files) you want to show in the icons selecting dialog +  * the size of icons is upon you but we recommend the size **96x96px**. You can also set the size by adding the **_sX.X** parameter to the icon filename - the range is 0.5 to 10.0 times the default size. //Example: icon_sX.X.png//
-  * use format **.PNG** +
-  * the size of icons is upon you but we recommend the size **96x96px**. You can also set the size by adding **_sX.X** parameter to the icon filename - the range is 0.5 to 10.0 times the default size. //Example: icon_sX.X.png//+
   * default align of all icons is **center bottom line**. If you want the icons to be aligned **center-center**, add **_hscc** (hot spot - center-center) to the end of the icon name. //Example: icon_hscc.png//   * default align of all icons is **center bottom line**. If you want the icons to be aligned **center-center**, add **_hscc** (hot spot - center-center) to the end of the icon name. //Example: icon_hscc.png//
   * both parameters can be combined. Size first, align second. //Example: icon_sX.X_hscc.png//   * both parameters can be combined. Size first, align second. //Example: icon_sX.X_hscc.png//
-  * some icons are already available in Locus Store. Do you want to place some of your own there? [[locus.map@asamm.com|Get in touch]] with us!+  * pack the icons to a ZIP file and copy it into the **Locus/icons** directory. **DO NOT compress a folder with icons** - the icons must be in the root of the ZIP file. 
 +  * some icons are already available in the Locus Store. Do you want to place some of your own there? [[locus.map@asamm.com|Get in touch]] with us! 
 +==== Icon groups ==== 
 +If you need to have your custom icons sorted into groups here's the solution: 
 +  * edit and add the following XML file into the .ZIP pack with the icons. It defines commonly used "info" that Locus Map uses in many places for various files. Next to this main <item> tag with meta-information, there's a new container <content> that contains meta-information related to the content of the file itself. There are also a few comments so it should be clear:\\  
 +<code xml info.xml> 
 +<?xml version="1.0" encoding="utf-8"?> 
 +<items version="1"> 
 + 
 + <!-- container with item meta information --> 
 + <item> 
 + <version>1</version> 
 + <name> 
 + <def>Default pack name</def> 
 + </name> 
 + <creator>Creator</creator> 
 + <publisher>Name of publisher</publisher> 
 + <description> 
 + <def>Custom icons for Locus Map app</def> 
 + <cs>Vlastní ikony pro Locus Map aplikaci</cs> 
 + </description> 
 + <date>2017-06-01</date> 
 + </item> 
 + 
 + <!-- container with meta information about item content --> 
 + <content> 
 + <!-- sort options, 'content' for original sort as packed in zip, otherwise sorted by name --> 
 + <sort>content</sort> 
 + 
 + <!-- single category of items --> 
 + <category id="pins"> 
 +  
 + <!-- name of category (optional, ID is used if not defined) --> 
 + <name> 
 + <def>Pins</def> 
 + <cs>Špendlíky</cs> 
 + </name> 
 +  
 + <!-- items within a category --> 
 + <item file="blue-pushpin.png"> 
 +  
 + <!-- name of item (optional) --> 
 + <name> 
 + <def>blue</def> 
 + <cs>modrá</cs> 
 + </name> 
 + </item> 
 + <item file="green-pushpin.png"> 
 + <name> 
 + <def>green</def> 
 + <cs>zelená</cs> 
 + </name> 
 + </item> 
 + </category> 
 +  
 + <!-- another category --> 
 + <category id="letters_red"> 
 + <item file="1.png" /> 
 + <item file="2.png" /> 
 + <item file="3.png" /> 
 + <item file="A.png" /> 
 + <item file="B.png" /> 
 + </category> 
 + 
 + <!-- another category --> 
 + <category id="letters_blue"> 
 + <item file="1_blue.png" /> 
 + <item file="2_blue.png" /> 
 + <item file="3_blue.png" /> 
 + <item file="A_blue.png" /> 
 + <item file="B_blue.png" /> 
 + </category> 
 + </content>
  
 +</items>
 +</code>
 +Important is tag <category> that defines your **group** of items.
 ====== Map & Navigation cursors ====== ====== Map & Navigation cursors ======
  
Line 32: Line 108:
 ==== Basics ==== ==== Basics ====
  
-  * all subfolders in the ZIP file are optional. They may be used if you want to create some publicly available icons (we’ll gladly put them in Locus Store, possibly also as paid content). In this case, Locus Map selects automatically the best folder. +  * all subfolders in the ZIP file are optional. They may be used if you want to create some publicly available icons (we’ll gladly put them in the Locus Store, possibly also as paid content). In this case, Locus Map selects automatically the best folder. 
-  * if you want to use the pack just for your personal purposes, best is to put the icons at root of the .zip file+  * if you want to use the pack just for your personal purposes, best is to put the icons at the root of the .zip file
  
 ===== Basic cursors ===== ===== Basic cursors =====
Line 39: Line 115:
   * directory: //Locus/icons/cursors///   * directory: //Locus/icons/cursors///
   * pack: zipped (*.zip)   * pack: zipped (*.zip)
-  * where to select: Locus settings > Controlling > Map screen > Map cursors+  * where to select: Locus settings > Controlling > Map screen > Screen cursors
  
 **content: (example name ‘myIcons.zip’)** - name the files according to this sample: **content: (example name ‘myIcons.zip’)** - name the files according to this sample:
Line 91: Line 167:
 ---- ----
  
-Locus Map offers also ability to create custom icons for geocaches. Current implementation isn't as straightforward as adding custom icons described above, anyway we suggest to read that also.+Locus Map offers also the ability to create custom icons for geocaches. The current implementation isn't as straightforward as adding custom icons described above, anywaywe suggest reading that too.
  
 __The whole procedure requires a few steps__: __The whole procedure requires a few steps__:
Line 103: Line 179:
 ==== Creating an icon pack ==== ==== Creating an icon pack ====
  
-Images of caches are usually created from one icon (in case of //disabled// and other statuses it's more than one). Anyway this new system offers to create icons with various parameters.+Images of caches are usually created from one icon (in case of //disabled// and other statuses it's more than one). Anywaythis new system offers to create icons with various parameters.
  
-Firstly, prepare images you want to use. At the bottom of this page, there is a list of possible image names. I'll not explain all images, as all are self-explaining by their names.+Firstly, prepare the images you want to use. At the bottom of this page, there is a list of possible image names. I'll not explain all images, as all are self-explaining by their names.
  
-You don't have to use all images. Locus Map will firstly try to load images from your pack and in case an icon is missing, the default will be used.+You don't have to use all the images. Locus Map will first try to load images from your pack and in case an icon is missing, the default will be used.
  
-Compress all icons to a .zip file (icons will be stored directly in zip, not in any sub-directory) and place them into **Locus/icons** directory.+Compress all icons to a .zip file (icons will be stored directly in zip, not in any sub-directory) and place them into the **Locus/icons** directory.
  
 ==== Configure Locus ==== ==== Configure Locus ====
Line 121: Line 197:
 type_benchmark.png type_benchmark.png
 type_cache_in_trash_out.png type_cache_in_trash_out.png
 +type_community_celebration.png
 type_earth.png type_earth.png
 type_event.png type_event.png
 +type_gc_hq.png
 +type_gc_hq_block_party.png
 +type_gc_hq_celebration.png
 type_giga_event.png type_giga_event.png
 type_gps_adventure.png (for "maze" type of geocache) type_gps_adventure.png (for "maze" type of geocache)
manual/advanced/customization/icons.1683183439.txt.gz · Last modified: 2023/05/04 08:57 by mstupka