Overview and item selection
[When you set up a key-value pair , you never have to type its user-assigned value again - it becomes selectable from a drop-down list commonly referred to as a spinner].
You are currently viewing a list of key-value pairs as determined by the filtering criteria shown in the colored header.
Key-values are entities (1 database row per entity) that have a key (ie: class ) that defines its purpose, and 1 or more values.
In the list, only the following information is displayed for each entity:
Key Shown in red if its value is the default value for its class. (key is often referred to as class)
Value Usually the 'S1' ('string 1') value.
Description [Optional]
Selecting an item takes you to its 'Edit' screen where you can view and modify its other properties And where, via the > and < action bar icons, you may scroll to the next/previous item in the list without actually returning to the list.
When you do finally return to the list, the last edited item will be softly highlighted.
Menu options
(a) New filter: ('Magnifying glass' icon). Define (or refine) the filtering criteria. NB: Request key-value Import/Export from here!
(b) Add new item: ('+' symbol). Create a new key-value entity.
(c) Help: ('Information' symbol). Key-values explained. (This text.)
(d) Goto list item: Jump to an absolute position in list. The targeted item will be softly highlighted. (Useful for navigating large lists.)
(e) Mass deletion: Irreversibly delete every item in the current, filtered, list. You will be prompted for final confirmation beforehand.
(f) Synchronize id0/1: (For keys id0 and id1 only.) Search database for every point and shape having an id0/1 value for which no corresponding key-value already exists then create one accordingly. [ The new KVs will have a blank description but will appear in the editor spinners. ]
Supported Keys (Classes)
id0 id1
These provide the primary method for classifying your entities. You should exploit these from the instant of importation. For this reason they are more fully described in the import GPX file dialog help.
user0 user1 user2 user3
These correspond to the identically named 'user' fields in all your waypoints, routes and tracks. For example you might use the user2 fields to store the common name of geo-tagged trees. In this event, you would set up multiple user2 keys with values like oak, elm etc.
type
Corresponds to the HTML <type> tag. Supported for waypoints, routes, tracks and points.
Provides another method of categorisation.
symbol
Corresponds to the HTML <sym> tag. Supported for waypoints, routes, tracks and points.
Identifies the symbol for map display.
path
Paths are used for binding external image libraries to individual entities (waypoints, routes and tracks). They contain 2 critical values:
The 'S1' ('string 1') value defines the actual path within the SD card.
The 'S2' ('string 2') value is used as a binder and is the value actually stored in the entity. (Thereby allowing the semi-volatile path specification to exist in one place only ).
Detailed instructions on the use of the path class are given in the Import Photograph dialog help book.
alias
Aliases are currently used for the following purposes;
(1) Converting HTML tags during import/export.
(2) Converting symbol values during import/export.
They contain 3 critical values.
The 'S1' value is the source (ie 'from') value.
The 'S2' value is the target (ie 'to') value.
The Description is hijacked for use as the binder
Instructions on the use of the alias class are given in the appropriate help books at the time of their use.
Default values
Classes other than alias allow for one of its assigned values to be tagged as the default for its class. The default value becomes the one occupying the spinner box (when the spinner is not open) and thus the value most easily pasted into the appropriate screen text box during editing.
The default value is also sometimes used during tasks that do not offer a visual user interface. For example, when importing an individual waypoint, route or track from a GPX file, the default id0 and id1 values will be used.
Only one member of a class can be the default. If no default is defined, the first item in the spinner is treated as the default.
Import/Export and Sample files
You may wish to share your key-value data with other team members. To begin the import/export dialog you must first enter the filtering dialog, select a class, and then press the import/export icon in the action bar.
Go here also to import the sample '.kv' files...
(a) path1.kv [RECOMMENDED] Detailed instructions are given in the help book associated with the Import photo dialog.
(b) symbol1.kv Contains about 300 symbol descriptions.