Skip to content
wthaem edited this page Oct 17, 2020 · 19 revisions

Prev (Tips & tricks for raster maps, vector maps, and elevation data) | Home | Manual | Index | (Overview of toolbar actions) Next


Table of contents


Overview of setup and configuration options

Valid from patch version 55d8aa7 (18.11.2017).

This page gives an overview over the available QMS GUI setup and configuration options. This includes in some cases QMS installation topics, too.

More details of the topics mentioned on this page can be found elsewhere in this Wiki.

General options

Workspace setup

  • Go to menu Workspace - Setup workspace (Remark: changes made to these options need QMS restart!)

    In the pop-up windows define

    • a time interval for automatic project data backup,
    • a listening port for a QMS multi-user environment,
    • how GPS devices should be handled by QMS. If this option is not checked, then GPS devices can't be seen in QMS. Otherwise GPS devices plugged in to the PC can be seen in QMS. For details compare section "Working with GPS Devices".
    • whether tags (ratings and keywords) are shown in the workspace window for GIS data objects.
  • To control the visibility of parts of the workspace go to menu Window

    • Toggle docks: change visibility of all docked window parts at once.
    • Toolbar: change visibility of toolbar.
    • Maps, Dig.Elev.Model (DEM), Workspace, Database, Routing: change visibility of single docked window part.

Waypoint icons setup

  • Go to menu Workspace - Setup waypoint icons
  • In the pop-up windows click the Open icon and define a path from which additional user-defined waypoint icons can be loaded

Toolbar setup

The toolbar allows quick access to important QMS actions.

  • Toggle the display of the toolbar with the help of the menu Window - Toolbar.
  • Configure the toolbar with the help of the menu Window - Setup toolbar:
    • Move actions to be included in the toolbar from the left part of the pop-up window to the right part of the window.
    • Move actions not to be included in the toolbar from the right part of the pop-up window to the left of the window.
    • Select the checkbox, if the toolbar should be displayed in the fullscreen mode, too.

Map and DEM setup

Download and install

QMS can render vector maps in the Garmin format and various types of raster and online maps.

QMS can use digital elevation data (DEM data). Necessary files can be downloaded from

For more details about the installation of maps and DEM data compare also the Quick start guide.

Map paths

  • Assumption: Vector, raster maps or links to online maps have been downloaded and installed
  • Go to the Maps tab (docked window, if not visible, then open it with the menu entry Window - Maps)
  • Right-click in the window to open the context menu
  • Select Setup map paths (alternatively: select menu File - Setup map paths)
  • In the pop-up window, add or remove paths with vector or raster maps

Map cache path for online maps

  • Go to the Maps tab (docked window, if not visible, then open it with the menu entry Window - Maps)
  • Right-click in the window to open the context menu
  • Select Setup map paths (alternatively: select menu File - Setup map paths)
  • In the pop-up window, define a path used for caching online map tiles

DEM file paths

  • Assumption: DEM data has been downloaded and installed.
  • Go to the Dig.Elev.Model (DEM) tab (docked window, if not visible, then open it with the menu entry Window - Dig.Elev.Model (DEM))
  • Right-click in the window to open the context menu
  • Select Setup DEM paths (alternatively: select menu File - Setup DEM paths)
  • In the pop-up window add or remove paths with digital elevation (DEM) data

Map window display switches (toggles)

The following toggles change the layout of all map windows:

  • Menu View - Show scale: switch on or off display of map scale
  • Menu View - Show grid: switch on or off display of map grid in all map views
  • Menu View - POI text: switch on or off display of POI names on vector maps
  • Menu View - Map tooltip: switch on or off tooltip window display of features of the objects under the mouse cursor in a vector map
  • Menu View - Night/Day: change map display between day and night layout (if supported by map)
  • Menu View - Min./max. track values: show the minimum and maximum values of the track properties along the track in the map view
  • Menu View - Flip mouse wheel: change the zoom direction when zooming a map with the mouse wheel
  • Menu View - Ext. profile: if selected: track profile is shown in a resizable and floating separate window, otherwise in a small and fixed window

Map window display setup

The following setup options change the layout of all map windows:

  • Menu View - Setup map font: In the pop-up window select the font and its properties used for text in map objects

  • Menu View - Setup map background: In the pop-up window select the color of the map background

  • Menu View - Setup units: In the pop-up window select the length unit (nautical, imperial, metric, aviation) and the slope unit (% or °). Hint: Changes may take effect only after a QMS restart

  • Menu View - Setup grid:

    • Select the color of the map grid with the help of the palette icon
    • Expert mode: Define projection and datum (coordinate system) used for the map grid
    • Remark: Each view has its own settings!
  • Menu View - Setup map view:

    • Set the map scales to Logarithmic or Square. A change of this option leads to a different zoom behavior of maps (compare section "Map scale type").
    • Expert mode: Define projection and datum (coordinate system) used for rendering of maps
    • Remarks:
      • Each view has its own settings!
      • Projections using lat/lon coordinates are not supported. Don't use Proj.4 settings with +proj=longlat!
  • Menu View - Setup coord. format: Select one out of 3 supported geographical coordinate formats

Single map display options

With the help of these options the user controls the rendering of a single map. For details, see section "Adjustable map properties"

Routing setup

Routino database paths

  • Assumption: Routing databases have been downloaded and installed. For more details compare also the Quick start guide.
  • Go to the Routing tab (docked window, if not visible, then open it with the menu entry Window - Routing).
  • In the combobox on the top of the window, select Routino (offline).
  • Click the Open folder selection icon. In the pop-up window, add or remove paths to Routino databases.

Routino routing setup

  • Go to the Routing tab (docked window, if not visible, then open it with the menu entry Window - Routing).
  • In the combobox on the top of the window, select Routino (offline).
  • Select
    • Profile (vehicle type)
    • Language (for routing instructions)
    • Mode (quickest/shortest)
    • Routino database (should cover area under consideration, the names shown are the prefixes added to the routing databases when creating them).

User-defined Routino profiles

(valid from commit a0eda84 - 2020-06-23 08:10:57)

When QMS is using Routino for routing it reads in several Routino configuration files. By default, these files are located

  • for Windows in the routino-xml subdirectory of the QMS installation directory,
  • for Linux in /usr/local/share/routino folder.

One of the configuration files is profiles.xml. The purpose of this XML configuration file is to allow easy modification of the routing parameters for the offered vehicle types. More details about Routino configuration files can be found here. The structure of the profiles.xml file is described here.

In addition to the default profiles file the user can define database-specific profiles files. To do this proceed as follows:

  • If you want to use an additional profiles file for some Routino database: Copy the prefix-*.mem files of the considered database to prefix_xxx-*.mem where xxx should describe the profile variant.
  • Copy the default profiles.xml file to prefix_xxx-profiles.xml in the folder where the prefix_xxx-*.mem database files are located.
  • Change the settings in prefix_xxx-profiles.xml.
  • Warning: Don't add new profiles to the profiles file and don't change the name or transport attributes of a profile tag!
  • Start QMS.
  • When selecting the prefix_xxx database in the database selection listbox the newly defined prefix_xxx-profiles.xml is used for routing.
  • If no user-defined profiles file is found for a Routino database, then the default profiles files is used for routing.

Here is an example of the use of 3 different profiles files for one Routino database when creating a route/track through 3 waypoints (the area under consideration has lots of bridges, cycle routes and foot paths):

Routing with 3 profiles

The routing properties used for the 3 variants are

type default (%) - red bike routes & no bridges (%) - blue foot & no bike routes (%) - green
bridge 50 0 100
footroute 50 50 100
bicycleroute 60 100 10

Comments:

  • The blue route with a high preference of cycle routes and which should avoid bridges follows mainly cycle routes. It is rather long because it avoids bridges.
  • The green route with has a high preference of bridges and foot paths.
  • The red default route is a compromise between the extreme blue and green routes.

BRouter setup

  • For general information about the use of BRouter see here.

  • Go to the Routing tab (docked window, if not visible, then open it with the menu entry Window - Routing)

  • In the combobox on the top of the window, select BRouter (...)

  • Be sure the Internet can be accessed

  • Click the Setup button

  • In the pop-up window choose

    • online (BRouter-Web (online)) or offline (local installation) routing. Remark: This selection will change the router name shown in the above mentioned combobox.
    • Expert mode: if appropriate: enables setting of some additional parameters for off- or online routing. Recommendation: Don't select the expert mode (there is no advantage from changing the given default values)
  • Online router settings (recommended, easier to use, no additional installation step):

    • Click Next after selecting online routing
    • In the next window, add or remove available BRouter profiles. Click on a profile name to see a short summary of the profile features.
    • If necessary, change the order of selected profiles
    • Close the profile selection window
  • Offline router settings (requires additional installation step):

    • Be sure that Java runtime environment is installed on your system

    • Click Next after selecting offline routing

    • Select local BRouter installation directory

      • If the installation directory is empty or doesn't exist: click button Create new BRouter installation resp. Create directory and install BRouter there
      • If a BRouter installation is found in the installation directory: click button Update existing BRouter installation and select the version you want to install
    • Select Java executable if not automatically found

    • Go to the next window

    • Add or remove available BRouter profiles. Click on a profile name to see a short summary of the profile features.

    • If necessary, change the order of selected profiles

    • Close the profile selection window

    • In the next window, select the tiles (areas) to be used for routing.

      • The tiles (segments) have a size of 5° in each direction

      • The scale of the tile selection window can't be changed, but the window itself can be resized.

      • The tile selection window shows a world map as background.

      • Recommendation: Before starting the BRouter setup define with the help of the context menu Add area (resp. Add waypoint) a sufficiently large area on the map (resp. a few waypoints) for which routing data are required. Find this area in the tile selection window by moving the map to this area and then select tiles around it. In the next image a user-defined area covering large parts of Central Europe is shown.

      • The color and the texture of each tile inform about the following tile properties (also shown in an infobox, if the mouse is located on a tile):

        • Routing data available on the server or not.
        • Routing data is locally saved or not.
        • Routing data is outdated and should be updated.
        • Size of data download.
      • The status line in the window informs about the number of up-to-date and outdated tiles, and about. the number of tiles selected for download.

        Area overlay

    • Click Download to start the download of routing data for offline use. Attention: Depending on the size of the selected area the download duration can be considerable!

    • Close the download window after the end of the download.

  • Select one of the available routing profiles

  • Select, if wanted, an alternative to the original route

  • In the case of offline routing, select the on the fly routing checkbox, if the next route segment should be calculated immediately after selecting the next route point.

MapQuest setup

  • Go to the Routing tab (docked window, if not visible, then open it with the menu entry Window - Routing)
  • In the combobox on the top of the window, select MapQuest (online)
  • Select
    • Profile (vehicle type)
    • Language (for routing instructions)
    • Road types to avoid
  • Hint: When creating a new track, create first a new route, select - if necessary - Calculate route from the route context menu and after the route has been completely constructed, convert it to a track with the help of the route context menu.

Further setup and configuration options

The following list shows some more setup options without detailed description:

  • Database import from QLandkarte (menu Tool - Import database from QLandkarte)
  • VRT Builder for raster maps (menu Tool - VRT Builder)
  • Routino database creation (menu Tool - Create Routino database)

Prev (Tips & tricks for raster maps, vector maps, and elevation data) | Home | Manual | Index | Top | (Overview of toolbar actions) Next

Clone this wiki locally