This project was created as an end of semester project in the engineering school Ensimag (Grenoble, France).
It consists of a ecosystem generator we can divide in two parts, namely the generation of the terrain and the behavior of the animals :

• Generation of the terrain is a procedural generation of an island with mountains, plains and sands using Voronoi diagram, tessellation and other technics;
• Animals are ruled with boids behavior and a graph to go from one behavior to another.

• HAMMEN Maxence (github)
• KACHER Ilyes (github)
• LY Mickaël (github)
• STOFFEL Mathieu (github)

#Compile voro++
cd lib/voro++/src
make

#Compile external libraries
cd extlib/
make

#Compile project (In root of the project)
rm -rf build/
mkdir build/
cd build/
cmake ..
make -j 8

1) Build the voro++ library:

• Run CMake so as to generate the Visual Studio solution;

# Building voro++
cd lib/voro++
mkdir build
cd build
cmake ..

• Open the Visual Studio solution with the latter, and build both the "Debug" and "Release" versions.

2) Build the tinyobjloader library:

• Run CMake so as to generate the Visual Studio solution;

# Building tinyobjloader
cd extlib/Win32/tinyobjloader
mkdir build
cd build
cmake ..

• Open the Visual Studio solution with the latter, and build both the "Debug" and "Release" versions.

3) Build the FreeType library:

• Open the Visual Studio solution in the repository extlib/freetype-2.5.5/builds/windows/vc2010/, and build both the "Debug" and "Release" versions.

4) Build the project:

• Running CMake so as to generate the Visual Studio solutions (one in "Debug" mode and one in "Release" mode. This separation is entailed by the fact that different versions of the libraries are needed, according to the mode. It must exists a way to unify both thanks to CMake, but, so far, we have not found it);

# Building the project in Debug and Release modes
rm -fr build
mkdir build
cd build
mkdir BuildTree_Debug
cd BuildTree_Debug
cmake ../..
cd ..
mkdir BuildTree_Release
cd BuildTree_Release
cmake -D CMAKE_BUILD_TYPE=RELEASE ../..

• Open the Visual Studio solutions with the latter, and build them both (the Debug one in Debug mode and the Release one in Release mode);
• Copy the following dlls in the folder build created during the step 4):
  • extlib/Win32/sfml-2.3.2/bin/sfml-graphics-2.dll;
  • extlib/Win32/sfml-2.3.2/bin/sfml-graphics-d-2.dll;
  • extlib/Win32/sfml-2.3.2/bin/sfml-system-2.dll;
  • extlib/Win32/sfml-2.3.2/bin/sfml-system-d-2.dll;
  • extlib/Win32/sfml-2.3.2/bin/sfml-window-2.dll;
  • extlib/Win32/sfml-2.3.2/bin/sfml-window-d-2.dll;
  • extlib/Win32/glew-1.13.0/bin/Release/Win32/glew32.dll.
• Copy the wanted executable (namely main.exe, either in BuildTree_Debug/Debug or in BuildTree_Release/Release, according to the chosen compilation mode) in the folder build created during the step 4).

5) Execute the project by running main.exe.

• CMake : CMake is an open-source, cross-platform family of tools designed to build, test and package software. For more info, click on this link;
• gcc : gcc is a compiler collection for C++ and other languages. For more info, click on this link;
• Visual Studio 2015: Visual Studio 2015 is a complete Development Environment (including, notably, an IDE and a compiler), created and developped by Microsoft. For more info, click on this link;
• Doxygen : Doxygen is a standard tool for generating documentation. For more info, click on this link;
• Rapidjson : Rapidjson is a fast JSON parser/generator for C++ with both SAX/DOM style API. For more info, click on this link;
• Voro++ : Voro++ is a software library for carrying out three-dimensional computations of the Voronoi tessellation. For more info, click on this link;
• C++ Bitmap Library : The C++ Bitmap Library consists of simple, robust, optimized and portable processing routines for the 24-bit per pixel bitmap image format. For more info, click on this link.

#Generate the documentation
cd doc
make

#To read the documentation
firefox html/index.html

• On rare occasion, an exception occur following a bad management of the boid when it moves from one cell to an other in the grid (06/08/2016);
• If a boid gets too close to the border of the map and depending on the precision of the grid, an exception will occur (06/08/2016);
• The boid can have unexpected behavior when walking on the mountains.

• Sometimes, a small wall can cut the map in two. This is due to the interpolation extending the influence of the mountain on a horizontal/vertical line.

A very warm thank you to our two awesome computer graphics teachers who helped us during this project :

• DELAME Thomas (website)
• MANTEAUX Pierre-Luc (github)

See LICENSE.

See BIBLIOGRAPHY.md.

The following meshes have been used :

• Rabbit
• Wolf
• Tree

The 'carrot' has been created by Ilyes Kacher.