On Windows systems, we recommend using vcpkg to install and manage dependencies. The following steps install everything necessary to build CartoCrow.

• MSVC. Download MSVC 2019 from Microsoft's website and install it.

• CMake. Download CMake from here and install it. (Note: If you have a version of CMake installed in Cygwin, this does not seem to play well with vcpkg. Please install a native version of CMake.)

• vcpkg. The standard procedure to setup vcpkg on Windows:

  git clone https://github.com/microsoft/vcpkg
  cd vcpkg
  .\bootstrap-vcpkg.bat

  In our experience, vcpkg may misbehave when installed in a directory with a long path name, or a path name containing exotic characters. vcpkg itself recommends C:\src\vcpkg.

  For more information on installing vcpkg, see here.

• Install dependencies. As described here:

  vcpkg install cgal:x64-windows
  vcpkg install qt5:x64-windows
  vcpkg install glog:x64-windows
  vcpkg install nlohmann-json:x64-windows

  This step can take a very long time, especially compiling CGAL (around 30 minutes) and Qt (around 2 hours).

• Ipelib. This library is not available in vcpkg, so we will have to build it ourselves. Unfortunately, the upstream version of ipelib does not compile cleanly with MSVC. We prepared a patched version (to do: link coming soon) that can be compiled and installed with

  cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=install -DCMAKE_TOOLCHAIN_FILE=<path-to-vcpkg>\scripts\buildsystems\vcpkg.cmake -S . -B build
  cmake --build build
  sudo cmake --install build

In case your machine does not have MSYS2 installed yet, you can download it from here.

Most dependencies can be obtained from the repository:

pacman -S base-devel mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja
pacman -S mingw-w64-x86_64-cgal mingw-w64-x86_64-glog mingw-w64-x86_64-qt5 mingw-w64-x86_64-nlohmann-json

The remaining dependencies need to be built manually.

• Ipelib. Download the source archive and unpack it. Instead of the instructions for Ubuntu given in install.txt, you can use the following to install the dependencies:

  pacman -S mingw-w64-x86_64-freetype mingw-w64-x86_64-cairo mingw-w64-x86_64-libjpeg-turbo
  pacman -S mingw-w64-x86_64-libpng mingw-w64-x86_64-lua mingw-w64-x86_64-zlib
  pacman -S mingw-w64-x86_64-libspiro mingw-w64-x86_64-gsl

  Then set the correct environment: in common.mak, set

  # line 158
  IPEDEPS       := /mingw64  # or /ucrt64 if you're building under UCRT64
  
  # line 167-168
  LUA_CFLAGS    := -I$(IPEDEPS)/lua54/include
  LUA_LIBS      := -L$(IPEDEPS)/lib -llua

  A few changes are necessary to make Ipelib compile correctly:

  • in src/ipelib/ipeplatform.cpp and src/ipelib/ipebitmap_win.cpp, add an #include <string>;
  • in src/ipelib/ipeplatform.cpp, in Platform::runLatex(), replace wcmd.data() by &wcmd[0];
  • in src/ipelib/ipeplatform.cpp, in String::w(), replace result.data() by &result[0].

  Then, to compile:

  cd src
  make IPEPREFIX=/usr/local ipelib

  The compiled library ipe.dll ends up in mingw64/bin.

On Ubuntu, most dependencies can be obtained from the repository:

sudo apt install build-essential cmake
sudo apt install libcgal-dev nlohmann-json3-dev

The remaining dependencies need to be built manually.

• glog. This dependency is built manually because Ubuntu's packaging apparently does not include the CMake files we need.

  git clone https://github.com/google/glog.git
  cd glog
  cmake -S . -B build
  cmake --build build
  sudo cmake --install build

• Ipelib. Download the source archive, unpack it, and compile and install it using the instructions given in install.txt.