PerfectTIN

PerfectTIN development takes place on Github. There is not yet a mailing list or IRC channel for PerfectTIN; if you'd like to get involved, contact me and I'll set one up.

General Building

To build PerfectTIN, you need CMake and a C++ compiler. If you are packaging PerfectTIN, it is fine to put the build directory inside the source directory, but if you are developing it, you should use an out-of-source build.

If you're going to use PLY files, build and install Plytapus before you build PerfectTIN. The instructions are the same, except for the name of the program.

Building on Unix and the like

I use the following file to make build directories for building on Linux and BSD:

You can use Ninja instead of Make (add -GNinja to each line) or add a subdirectory for fuzzing with American Fuzzy Lop (add -DCMAKE_C_COMPILER=afl-clang -DCMAKE_CXX_COMPILER=afl-clang++ or the same with afl-gcc to the cmake command).

Building on Debian and derivatives

To build on Debian, Ubuntu, or anything else using the Debian package manager, install the following packages:

• ssh
• git
• g++
• make
• ninja-build (if you use ninja)
• cmake
• qtbase5-dev
• qttools5-dev
• libboost-all-dev
• xorg

Create the ~/bin/build file above. Clone the repo into ~/src/perfecttin and run these commands in an xterm:

Building on Debian
you@comp:~/src$ mkdir ~/build you@comp:~/src$ ~/bin/build perfecttin you@comp:~/src$ cd ~/build/perfecttin/dbg you@comp:~/build/perfecttin/dbg$ make -j 3 you@comp:~/build/perfecttin/dbg$ ./perfecttin-gui&

Building on Red Hat and derivatives

Don't try to build on RHEL/CentOS 7. The versions of CMake and g++ are too old. It may be possible to build by hacking the repositories, but it is not worth the hassle. I have not tried RHEL/CentOS 8.

To build on Red Hat, Fedora, CentOS, or anything else using the Red Hat package manager, install the following packages:

• openssh
• git
• gcc-g++
• make
• ninja-build (if you use ninja)
• cmake
• qt5-qtbase-devel
• qt5-linguist
• qt5-qtbase-gui
• libX11
• fftw-devel (optional)

Create the ~/bin/build file above. Clone the repo into ~/src/perfecttin and run these commands in an xterm:

Building on Red Hat
[you@comp src]$ mkdir ~/build [you@comp src]$ ~/bin/build perfecttin [you@comp src]$ cd ~/build/perfecttin/dbg [you@comp dbg]$ make -j 3 [you@comp dbg]$ ./perfecttin-gui&

Building on FreeBSD and DragonFly BSD

To build on systems using the ports or DPorts collection, install the following packages:

• git
• cmake
• ninja (if you use ninja)
• qt5-core
• qt5-gui
• qt5-linguist
• qt5-buildtools
• xorg
• boost-all

Create the ~/bin/build file above. Clone the repo into ~/src/perfecttin and run these commands in an xterm:

Building on DragonFly
[you@comp ~/src]$ mkdir ~/build [you@comp ~/src]$ ~/bin/build perfecttin [you@comp ~/src]$ cd ~/build/perfecttin/dbg [you@comp ~/build/perfecttin/dbg]$ make -j 3 [you@comp ~/build/perfecttin/dbg]$ ./perfecttin-gui&

Building on Windows with Cygwin

Instructions for Windows are not updated from Bezitopo

To build on Cygwin, install the following packages:

• ssh
• git
• gcc-g++
• make
• cmake
• libQt5Core-devel
• libQt5Gui-devel
• xinit

Create the ~/bin/build file above, but without the three w64 lines. Clone the repo into ~/src/perfecttin and run these commands:

Building on Cygwin
you@comp ~/src $ mkdir ~/build you@comp ~/src $ ~/bin/build perfecttin you@comp ~/src $ cd ~/build/perfecttin/dbg you@comp ~/build/perfecttin/dbg $ make -j 3 you@comp ~/build/perfecttin/dbg $ startxwin& you@comp ~/build/perfecttin/dbg $ DISPLAY=:0;export DISPLAY you@comp ~/build/perfecttin/dbg $ ./perfecttin-gui&

Building on Windows

I use the following file to make build directories for building on Windows:

Building with MinGW

Install the following Chocolatey packages:

• git (includes bash)
• mingw
• cmake
• openssh
• ninja
• kate (or other editor)

Install Qt, selecting the MinGW build. Create the build.cmd file above, setting the Qt and MinGW version numbers to what you installed. Clone the repo into ~/src/perfecttin and run these commands in a bash shell:

If you're building an install or release build, omit the 'd' from the library names; it stands for "debug". There is no Qt5LinguistTools.dll file; the above three are sufficient. WindeployQt copies the libraries to the build directory, but for the install or release build on MinGW, it copies the wrong ones, the debug ones.

Building with MSVC++

Install the following Chocolatey packages:

• git (includes bash)
• cmake
• openssh
• ninja
• kate (or other editor)

Install Visual Studio. Install Qt, selecting the MSVC build. Create the build.cmd file above, setting the Qt and MSVC version numbers to what you installed. Clone the repo into ~/src/perfecttin and run these commands in a 64-bit Visual Studio shell:

If you're building an install or release build, omit the 'd' from the library names; it stands for "debug". There is no Qt5LinguistTools.dll file; the above three are sufficient.

Unlike MinGW, MSVC does not support ten-byte floating point. This produces slightly less accuracy on spirals, but you're unlikely to notice, as the spirals have to be much longer and curlier than any actually used in a road to make any difference.

First time on a new OS or processor

After building, run the test. You can type make test or testptin individual tests. To see the list of tests, type testptin -l.