Differences

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

--- en:help:landmarks:custom-icons [2013/11/11 18:32] – psyberia
+++ en:help:landmarks:custom-icons [2021/04/23 17:55] (current) – external edit 127.0.0.1
@@ Line 2: / Line 2: @@
 ====== Custom waypoint icons ======
+\\
+In you don't find the waypoint icons that suit your needs, the application allows you to import and use your own ones.
-AlpineQuest has the ability to use custom icons for waypoints.
+\\
-Icons must be placed in the "**''icons/''**" sub-folder of AlpineQuest's main folder (so usually "**''/sdcard/alpinequest/icons/''**"), and must meet the following requirements:
+===== Requirements and setup =====
-  * **Maximum file size**: 100KB;
+\\
-  * **Image format**: PNG, JPG, GIF, BMP. Alpha channel supported if any;
+Icon files must be saved in the "**''icons/''**" sub-folder of [[en:help:settings:storage#how_to_locate_the_application_folder|application folder]], and must meet the following requirements:
-  * **Image dimension**: 32px × 32px recommended.
+  * **Image format**: SVG (recommended, only simple shapes supported), PNG, JPG, GIF, BMP. Alpha channel supported if any;
+  * **Image dimension**: 32px × 32px recommended for non SVG formats;
+  * **Maximum file size**: 100KB.
-{{:icon_help.png?nolink}} The file name (without the extension) is used as the icon name. If you use an existing icon name, this one will be replaced by your custom icon. Names are case insensitive.
+{{:icon_help.png?nolink}} The file name (without the extension) is used as the icon name. If you use an existing icon name, this one will be replaced by your custom icon. Names are //not// case sensitive.
-Then, custom icons can be selected from AlpineQuest like any other icons:
+{{:icon_help.png?nolink}} The center point of the icon is displayed on the waypoint's location.
-  * Create a new waypoint;
-  * Click on the "**''Icon''**" button {{:icon_01.png?nolink}};
-  * You should see a new "**''Custom''**" category {{:icon_02.png?nolink}};
-  * Select your icon {{:icon_03.png?nolink}};
-  * Save the waypoint {{:icon_04.png?nolink}};
-You should see your waypoint with the custom icon {{:icon_05.png?nolink}} (size of 64px × 64px used in this example).
+{{:icon_help.png?nolink}} You must restart the application after adding custom icons in order to be able to use them.
-{{:icon_help.png?nolink}} The icon centers correspond exactly to the waypoint locations.
+\\
-{{ :en:help:landmarks:custom-icons.jpg?nolink |}}
+===== Usage =====
+\\
+To use a custom icon, [[en:help:landmarks:local-create-waypoint#how_to_create_a_waypoint|create a new waypoint]] or [[en:help:landmarks:local-create-waypoint#how_to_edit_a_waypoint|edit an existing one]]. In the edit waypoint dialog:
+  * Click on the ''"**Add icon**"'' {{:icon_01.png?nolink}} shortcut button, or alternatively click on ''"**More...**"'' {{:icon_02.png?nolink}} and select ''"**Icon**"'' {{:icon_03.png?nolink}};
+  * Under the "Custom" category, select your custom icon {{:icon_04.png?nolink}}.
+{{:icon_help.png?nolink}} By grouping some icons in a sub-folder, they will appears in a custom category named after the sub-folder.
+{{ :en:help:landmarks:local-waypoints-custom-icons.jpg?nolink }}