53. Customizing General¶
Little Navmap creates multiple configuration files in the directory
C:\Users\YOURUSERNAME\AppData\Roaming\ABarthel when started. These
allow extended customization of the program.
The files use the Windows-
INI style that has groups in square
key=value lines. See
here for more information
about this type of configuration files.
You have to restart Little Navmap to see any changes. Also, do not edit the files while Little Navmap is running since it might overwrite your changes.
To undo all changes simply delete a file. It will be created again containing the default values when Little Navmap is started.
Single lines can also be deleted and will be restored with the default value when Little Navmap is started.
Keys and values are case sensitive. Order in the files is not important if the keys remain in their respective sections. The program might reorder the keys when saving or updating the files.
Some of the INI files contain a section
[Options] with a key
Version as shown below.
Do not delete the version since Little Navmap relies on this information when updating the file. It will reset the file occasionally whenever the default settings change. A backup will be created to save your user customizations
Add this version section to all new files. Otherwise, Little Navmap might reset the content.
Examples for backup files:
The file will be backed up and reset if you delete or change the version.
Only two user interface styles can be customized. These are
Night and can be found in User Interface in the options dialog.
These two styles are available on all operating systems.
Two files are generated that allow the customization for all window, button and dialog colors. These are:
The key names in these files are derived from the Qt palette options. Each key consists of the group and role name separated by an underscore. See below for more information on the color formats used.
53.3. Map Display¶
allows to customize various aspects of the map display and is currently
limited to colors and pens. Most key names are self explaining. See
below for more information about color values.
53.3.1. Color Format¶
Color can be in one of these formats which are commonly used in web design:
#RRGGBBeach of R, G, B and A is a single hex digit. Each color value ranges from 00 - FF (decimal 0-255)
#AARRGGBBfirst two digits contain the alpha/transparency value.
00equals to fully tranparent and
FF(decimal 255) to opaque.
- SVG color name
SVG color name is one of the colors defined in the list of
gainsboro. Note that you cannot enter an alpha channel value if you
use a color name.
You can use the w3schools color picker to get the hex values for a color.
53.3.2. Pen Format¶
A pen contains the following values in a comma separated list:
- Color as described above
- Pen width as a floating point value measured in pixels. You have to
.as decimal separator no matter what your locale defines.
- Pen style. One of the following values:
RestrictedPen=#fd8c00, 2, DashDotDot
ModecPen=#509090, 2, Solid
NationalParkPen=#509090, 2.1, Solid
To change an icon download it from the GitHub source repository Icon
or extract the included file
Modify the icon and save it into the settings directory
C:\Users\YOURUSERNAME\AppData\Roaming\ABarthel. Little Navmap will
automatically detect and use the icon on next startup.
The format is limited to SVG (Scalable Vector Graphics (SVG) Tiny 1.2 Specification) where advanced graphics effects like textures will not work.
You can use the free vector drawing program Inkscape to edit the icons. Restart Little Navmap to see the changes.
53.4.1. User, AI and Multiplayer Aircraft Icons¶
All icons for user, AI/multiplayer aircraft, helicopters and ships are stored in the program but can be overloaded by the user.
The icons are:
The suffixes are chosen by vehicle type, status (ground or airborne) and
user or AI/multiplayer. The icon is for airborne vehicles if
is missing and for AI/multiplayer vehicles if
user is missing. For
historical reasons all icons are prefixed with
53.4.2. Userpoint Category Icons¶
Icons for userpoint categories are stored in the program but can be overloaded by the user as well.
Default category icons can be overloaded with another icon by placing a file with one of the default category names in the settings directory.
New categories can be added by placing a new icon adhering to a certain name pattern in the default directory.
The text between the first underscore
_ and the
defines the category. For example
userpoint_My Places.png creates a
Do not use special characters like
/ for categories. Only letters,
digits, space, underscore and dashes are allowed. Umlauts and accented
characters are no problem.