InstallSetup

Prev (Manual) | Home | Manual | Index | (Overview tool) Next

---

Table of contents

• Installation and Setup
  • Installation
    • Windows
    • Linux
  • Running
    • List of commandline options
  • Setup

---

Installation and Setup

Installation

Windows

For 64-bit Windows use the QMapShack installer binary which installs QMapTool, too.

The Windows installer makes the following changes to environment variables:

• add the installation path to the PATH variable,
• set the environment variable GDAL_DATA to the data subdirectory of the installation directory (contains various GDAL files),
• set the environment variable PROJ_DATA to the share subdirectory of the installation directory (contains various PROJ configuration files).

32-bit Windows systems are not supported.

Linux

Download, unpack and compile the latest stable release from the download page.

To compile QMapTool, you need to have installed:

• Qt6 (at least 6.8)
• GDAL
• PROJ
• CMake/Make
• a C++ compiler (supporting C++11)

Prefer installing those dependencies via the distribution's package system. You also need to install the development packages in order to build QMapTool.

Running

To run QMapTool start qmaptool.exe in the selected installation path.

Windows users can go to the start menu and select QMapShack - QMapTool (remember: QMapTool was installed together with QMapShack!).

After starting QMapTool, the initial user interface is shown:

List of commandline options

The following options are available when starting QMT from the commandline:

Switch	Parameter	Comment
-d		enable debug output on the console¹
-f		enable debug output and write it to file²
-c	<filename>	read/write the configuration from/to a configuration file
-l	<code>	QMapTool application locale (QMapTool version >= 1.20.0)
-n		do not show splash screen
-v		display version on the console¹ (QMapTool version > 1.19.0)
-h		display help on commandline options on the console¹

¹ Debug, version and help output goes to channel stdout.
  When started from Windows cmd console, stdout is not attached to console and no output is written to console.
  To see console output however with Windows, start QMapShack from Windows powershell console
  by command <QMS installation folder>\qmapshack.exe <commandline parameters> 2>&1 | write-output

² Debug output filename
  Windows: %temp%\org.qlandkarte.QMapTool.log
  Linux: /tmp/org.qlandkarte.QMapTool.log
  macOS: ~/Library/Logs/org.qlandkarte.QMapTool.log

If you start the application without the -c option, the configuration will be stored wherever your system stores application configurations. Otherwise it is stored in <filename> during the QMapTool run.

Remark for Windows users:

There is no default configuration file. Instead, the default configuration is saved in the registry branch HKCU\Software\QLandkarte\QMapTool.

If the configuration does not yet exist, then QMapTool uses it's default configuration location as mentioned above and the configuration is written to that location during the QMapTool run.

The configuration location keeps information about the

• setup of the user interface,
• setup of each of the available tools,
• user-defined setup values.

Configuration files are standard INI files and can be edited (be careful!).

The -c option is pretty handy if you start QMapTool from a memory stick and want to take your configuration with you.

Setup

QMapTool needs some setup to run properly. The user should carry out the following setup steps before working with QMT:

1. Select the menu item Setup - Ext.tools and fill in the requested paths to the GDAL package (QMT is trying to find these paths automatically):

   

   Remarks:

   • The first 4 settings are related to GDAL tools used in QMT.
   • The last setting points to an auxiliary executable created in the QMT compiler run.
   • All the executables used in this setup are distributed with the Windows installer and are located in the QMT installation path.

2. Select the menu item Setup - Setup units and select your unit (Nautical, imperial, or metric).

3. Select the menu item Setup - Setup coord.format and select your favorite coordinate format.

4. Until you know how to work with QMT leave the menu entry Setup - Show tool help selected (this displays quite a few useful help texts for the available tools).

5. Select the menu entry Window - Shell if you want to see the progress of calls to the GDAL tools in a shell window (recommended - you can see the end of longer calculations).

---

Prev (Manual) | Home | Manual | Index | Top | (Overview tool) Next