62. 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
brackets and key=value
lines. See
INI (Wikipedia) for more information
about this type of configuration files.
Note
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.
62.1. Version¶
Some of the INI files contain a section [Options]
with a key
Version
as shown below.
[Options]
Version=2.0.1
Warning
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: little_navmap_mapstyle_backup_2.0.0.ini
or little_navmap_mapstyle_backup.ini
.
The file will be backed up and reset if you delete or change the version.
62.2. GUI¶
Only two user interface styles can be customized. These are Fusion
and 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:
C:\Users\YOURUSERNAME\AppData\Roaming\ABarthel\little_navmap_fusionstyle.ini
C:\Users\YOURUSERNAME\AppData\Roaming\ABarthel\little_navmap_nightstyle.ini
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.
62.3. Map Display¶
The file
C:\Users\YOURUSERNAME\AppData\Roaming\ABarthel\little_navmap_mapstyle.ini
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.
62.3.1. Color Format¶
Color can be in one of these formats which are commonly used in web design:
#RRGGBB
each of R, G, B and A is a single hex digit. Each color value ranges from 00 - FF (decimal 0-255)#AARRGGBB
first two digits contain the alpha/transparency value.00
equals to fully tranparent andFF
(decimal 255) to opaque.- SVG color name
SVG color name is one of the colors defined in the list of
CSS Colors;
for example, steelblue
or
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.
Examples:
Active_Highlight=#308cc6
AlertFillColor=darkred
ApproachFillColor=#3060808a
62.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
use
.
as decimal separator no matter what your locale defines. - Pen style. One of the following values:
Solid
,Dash
,Dot
,DashDot
andDashDotDot
.
Examples:
RestrictedPen=#fd8c00, 2, DashDotDot
ModecPen=#509090, 2, Solid
NationalParkPen=#509090, 2.1, Solid
62.4. Icons¶
To change an icon download it from the GitHub source repository Icon
Resources
or extract the included file Little Navmap/customize/icons.zip
.
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.
62.4.1. User, AI and Multiplayer Aircraft Icons¶
Default icons are included in file aircraft-icons.zip
in installation folder customize
.
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:
aircraft_boat.svg
aircraft_boat_ground.svg
aircraft_boat_ground_user.svg
aircraft_boat_user.svg
aircraft_helicopter.svg
aircraft_helicopter_ground.svg
aircraft_helicopter_ground_user.svg
aircraft_helicopter_user.svg
aircraft_jet.svg
aircraft_jet_ground.svg
aircraft_jet_ground_user.svg
aircraft_jet_user.svg
aircraft_online.svg
aircraft_online_ground.svg
aircraft_small.svg
aircraft_small_ground.svg
aircraft_small_ground_user.svg
aircraft_small_user.svg
Only used in X-Plane:
aircraft_carrier.svg
aircraft_carrier_ground.svg
aircraft_carrier_ground_user.svg
aircraft_carrier_user.svg
aircraft_frigate.svg
aircraft_frigate_ground.svg
aircraft_frigate_ground_user.svg
aircraft_frigate_user.svg
The suffixes are chosen by vehicle type, status (ground or airborne) and
user or AI/multiplayer. The icon is for airborne vehicles if ground
is missing and for AI/multiplayer vehicles if user
is missing. For
historical reasons all icons are prefixed with aircraft
.
62.4.2. Userpoint Category Icons¶
Default icons are included in file userpoint-icons.zip
in installation folder customize
.
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.
userpoint_Airport.svg
userpoint_Airstrip.svg
userpoint_Bookmark.svg
userpoint_Cabin.svg
userpoint_Closed.svg
userpoint_DME.svg
userpoint_Error.svg
userpoint_Flag.svg
userpoint_Helipad.svg
userpoint_Lighthouse.svg
userpoint_Location.svg
userpoint_Logbook.svg
userpoint_Marker.svg
userpoint_Mountain.svg
userpoint_NDB.svg
userpoint_Obstacle.svg
userpoint_Pin.svg
userpoint_POI.svg
userpoint_Seaport.svg
userpoint_TACAN.svg
userpoint_Unknown.svg
userpoint_VOR.svg
userpoint_VORDME.svg
userpoint_VORTAC.svg
userpoint_VRP.svg
userpoint_Waypoint.svg
The text between the first underscore _
and the .png
ending
defines the category. For example userpoint_My Places.png
creates a
new category My Places
.
Do not use special characters like /
for categories. Only letters,
digits, space, underscore and dashes are allowed. Umlauts and accented
characters are no problem.