Development Environment
We assume Windows 10 environment. Development will use the Microsoft toolchain, aka Visual Studio.
Software
The following software will be presumed to be installed.
Visual Studio
Git
- Install Git for Windows.
- Install Git Fork or another git frontend of your choice. The command line or the one built into Visual Studio will suffice.
SDKs
Several binary dependencies currently need to be installed manually.
SDL2
- Grab the SDL2 SDK and unpack this file anywhere on your PC.
- Then edit your environment variables and add the path where you unpacked the zip under the
SDL2DIR
variable.
AssImp
Doxygen
Ubuntu in WSL
- Enable Windows Subsystem for Linux and install Ubuntu
- Open Ubuntu and install required components:
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo add-apt-repository ppa:janisozaur/cmake-update-bionic
sudo apt-get update
sudo apt-get install g++ g++-7 ninja-build cmake
Building
- Clone the repository
https://github.com/seanmiddleditch/grimm
. Make sure you also checkout all submodules and not just the root repository.
- Open the folder you just checked out in Visual Studio. If you have the Visual Studio CMake workload installed, it will automatically configure the build for you.
- After the configuration steps are complete, go to the menu bar at click
Project
->Build All
.
- To build in Ubuntu on WSL, select the
Linux via WSL (Debug Static)
configuration in Visual Studio, assuming you followed the steps above for setting up Ubuntu in WSL.
Running
You will need to convert the demo resources before running for the first time.
- In the Visual Studio Solution Explorer view, right-click the root of the project folder. There should be menu items at the bottom to Convert Resources. Select the appropriate one for your build configuration (Debug or Release).
- To run the demo shell, select shell.exe in the dropdown on the toolbar (it says
Select Startup Item
by default). Then hit play.