Building

Qt is a cross platform framework, available for most desktop operating systems, as well as embedded platforms and smartphones.

Linux/X11

On many Linux distros, such as Debian (Ubuntu, Mint, ...) the Qt libraries are outdated, and the versions available in the repositories may be several years old (as a trade-off between stability and access to the latest software). Unless you're using a "bleeding edge" distribution (eg. Arch), it is recommended to use the official release available from the website of Qt. You can get the required tools from here (select open source). You'll have to install Desktop GCC and Gamepad from Qt 5.8, and Qt Creator from under Tools.

If you're using Arch, you can get Qt from AUR; here's the relevant wiki page.

Using the graphical tools

See the Qt Creator how to.

Using the command line

1. Create a build directory somewhere, and cd into it
2. Call qmake, the configuration tool of Qt: /path/to/qmake path/to/project/directory. If you have multiple Qt versions installed, make sure you call the right qmake. If you've installed using the official release from the Qt site, you can find it in [qt-installdir]/Qt5/[version]/gcc_64/bin (you can add it to your $PATH if you want, but it's not necessary). You can also set some configuration parameters, see the general build guide for more information.
3. Call make
4. [optional] Call make install

Windows

On Windows, you can use the official Qt installer, which you can get from here (select open source). Select Qt 5.8 during the installation, and one of the compilers you'll use for the building/development: either Microsoft Visual Studio (MSVC) or the open source MinGW tools. You'll also need Gamepad (under Qt 5.8), and Qt Creator (from Tools).

Alternatively, if you're using MSYS2, you can find a setup guide here.

After installation, follow the Qt Creator guide.

macOS

You can use the official Qt installer from here (select open source), and it is also available from Homebrew (qt5). Generally, you can follow the Linux/X11 guide. Xcode is also supported by Qt.

Linux/Embedded

// TODO

General: configuration options

You can set optional parameters to qmake (the Qt configuration tool) by appending KEY=VALUE pairs to its command line call. If you're using Qt Creator, you can find these settings on the Projects -> Build settings tab, where you can modify the Additional arguments option (see here).

You can use the following parameters:

Option	Description
INSTALLDIR	The general installation directory used by make install. Defaults to /opt/pegasus-frontend on Linux and C:\pegasus-frontend on Windows. You can fine tune the installation directory of some components by other options.
INSTALL_BINDIR	The installation directory of the runtime binary ("exe"). Defaults to INSTALLDIR.
INSTALL_DATADIR	The installation directory of the data files, eg. default themes. Defaults to INSTALLDIR.
INSTALL_DATADIR	The installation directory of the data files, eg. default themes. Defaults to INSTALLDIR.
INSTALL_ICONDIR	[Linux only] The installation directory of the icon file. Defaults to INSTALLDIR (to make it portable), /usr/share/pixmaps is recommended if you want to install Pegasus system-wide.
INSTALL_DESKTOPDIR	[Linux only] The installation directory of the desktop entry. Defaults to INSTALLDIR (to make it portable), /usr/share/applications is recommended if you want to install Pegasus system-wide.

General: using Qt Creator

1. Open Qt Creator

2. Open the project file (pegasus.pro) in Qt Creator

3. Qt Creator will ask you which Qt setup ("kit") you want to use (in case you've installed multiple versions), and where you want to place the generated files (see Details). If everything's OK, click Configure Project.

4. In the bottom left corner, on the sidebar of Qt Creator, you can find 4 buttons:

   • with the button that looks like a desktop monitor, you can change the build type (optimized Release build or development-friendly but slower Debug build)
   • the green arrow will build and run the program
   • the green arrow with a bug will also open several debug toolbars
   • the hammer will build the project but won't run it

5. Change the build type to Release (see above), and press the green arrow to build and run the project.