pioneer-thirdparty

This repository contains third-party packages required to build Pioneer. Not all environments/systems provide all the necessary packages, and some do but have made modifications that render them unsuitable for use in Pioneer. This will give you everything you need in a form that is tested and supported by the Pioneer devs.

Read COMPILING.txt in the main Pioneer repository to see how to use this.

Updating the win32 binaries

Required development environment:

• Visual Studio 2019 Community Edition: https://visualstudio.microsoft.com/vs/
• C++ CMake tools for Windows
  • Open VS 2019
  • On the main menu, goto Tools->Get Tools and Features
  • Indivudal Components
  • "C++ CMake tools for Windows"
• DirectX 9 SDK: https://www.microsoft.com/en-us/download/details.aspx?id=6812

libassimp

libassimp must be built in both debug and release mode!

1. Build and install the library

   • From the command line

     1. Open an appropriate Visual Studio command prompt (ie. 'x64 Native Tools Command Prompt for VS 2019')
     2. Navigate to the pioneer-thirdparty/source/assimp directory
     3. Create a build folder and enter it
     4. Configure cmake: cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=install -DASSIMP_BUILD_ASSIMP_TOOLS=OFF
     5. Run the build: ninja
     6. Install: ninja install
     7. Copy the files from build/install to the appropriate folders:
     • install/bin/x64/vs2019/assimp-vc142-mt*.dll -> pioneer-thirdparty/win32/bin/x64/vs2019
     • install/lib/x64/vs2019/assimo-vc142-mt*.lib -> pioneer-thirdparty/win32/lib/x64/vs2019

   • From within Visual Studio

     1. Open the pioneer-thirdparty/source/assimp directory as a folder
     2. Build the x64-debug configuration
     3. Install the x64-debug configuration (right click on the assimp CMake project and select install)
     4. Repeat build and install for the x64-release configuration
     5. Copy the files from out/install to the appropriate folders:
     • out/install/bin/assimp-vc142-mt*.dll -> pioneer-thirdparty/win32/bin/x64/vs2019
     • out/install/lib/assimp-vc142-mt*.lib -> pioneer-thirdparty/win32/lib/x64/vs2019

FreeType2

1. Download compiled binaries from https://github.com/ubawurinna/freetype-windows-binaries and place into pioneer-thirdparty/win32/

SDL2

1. Open an appropriate Visual Studio command prompt (ie. 'x64 Native Tools Command Prompt for VS 2019')
2. Navigate to the pioneer-thirdparty/source/sdl2 directory
3. Create a build folder and enter it
4. Configure cmake: cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=install -DEXTRA_LIBS=vcruntime
5. Run the build: ninja
6. Install: ninja install
7. Copy the files from build/install to the appropriate folders:
   • install/bin/*.dll -> pioneer-thirdparty/win32/bin/x64/vs2019
   • install/lib/*.lib -> pioneer-thirdparty/win32/lib/x64/vs2019

SDL Image

The solution in sdl2_image has been reconfigured for VS2019 and to find the appropriate SDL headers and libraries. SDL must be built first.

1. Open pioneer-thirdparty/source/sdl2_image/VisualC/sdl_image.sln in Visual Studio 2019
2. Build the appropriate release builds
3. Copy files from sd2_image/VisualC/*/Release to the appropriate pioneer-thirdparty/win32 folders

SDL2 Net

Follow the instructions for SDL2 above in the pioneer-thirdparty/source/sdl2_net directory.

libogg

1. Open an appropriate Visual Studio command prompt (ie. 'x64 Native Tools Command Prompt for VS 2019')
2. Navigate to the pioneer-thirdparty/source/libogg-1.3.4 directory
3. Create a build folder and enter it
4. Configure cmake: cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=install
5. Run the build: ninja
6. Install: ninja install
7. Copy the files from build/install to the appropriate folders:
   • install/lib/*.lib -> pioneer-thirdparty/win32/lib/x64/vs2019

libvorbis

1. Build libogg first and copy the lib files to pioneer/thirdparty/win32/lib/*
2. Open an appropriate Visual Studio command prompt (ie. 'x64 Native Tools Command Prompt for VS 2019')
3. Navigate to the pioneer-thirdparty/source/libvorbis-1.3.7 directory
4. Create a build folder and enter it
5. Configure cmake: cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=install -DOGG_INCLUDE_DIR=..\..\libogg-1.3.4\include -DOGG_LIBRARY=..\..\..\win32\lib\x64\vs2019\ogg.lib
   • replace lib\x64\ with the appropriate lib directory (ie. x86)
6. Run the build: ninja
7. Install: ninja install
8. Copy the files from build/install to the appropriate folders:
   • install/lib/*.lib -> pioneer-thirdparty/win32/lib/x64/vs2019

libsigc++

libsigc++ must be built in both debug and release mode!

1. Open an appropriate Visual Studio command prompt (ie. 'x64 Native Tools Command Prompt for VS 2019')
2. Navigate to the pioneer-thirdparty/source/libsigc++-2.10.4/MSVC_NMake directory
3. Run nmake: nmake /f Makefile.vc CFG=Release PREFIX=install install
4. Copy the dll and lib files from install/bin and install/lib to pioneer-thirdparty/win32/*

For new versions of libsigc++, copy the install/include/sigc++-2.0 directory to pioneer-thirdparty/win32/include and (sigc++ source dir)/untracked/MSVC_NMake/sigc++config.h to pioneer-thirdparty/win32/include/sigc++config.h