2014-08-25 19:57:30 +00:00
# Paysages 3D
2014-02-09 15:29:50 +00:00
2014-10-26 20:53:02 +00:00
[![Build Status ](https://travis-ci.org/thunderk/paysages3d.svg?branch=master )](https://travis-ci.org/thunderk/paysages3d)
2014-02-18 22:12:57 +00:00
2014-08-25 19:57:30 +00:00
## About
2014-02-09 16:05:01 +00:00
[Paysages 3D ](http://www.paysages3d.com ) is a work-in-progress landscape generator, modeler and renderer software.
2014-08-25 19:57:30 +00:00
It is written in C++ 11, using Qt 5.2 as only dependency (and Google Test for unit testing).
2014-02-09 16:05:01 +00:00
2014-02-23 10:47:46 +00:00
[![Screenshot 1 ](data/screenshots/small1.jpg )](data/screenshots/large1.jpg) [![Screenshot 2 ](data/screenshots/small2.jpg )](data/screenshots/large2.jpg) [![Screenshot 3 ](data/screenshots/small3.jpg )](data/screenshots/large3.jpg)
2014-02-09 16:05:01 +00:00
2014-08-25 19:57:30 +00:00
## Build/Run
### Using QtSDK (All platforms)
Download and install the latest [QtSDK ](http://qt-project.org/downloads ).
Launch QtCreator, and open the project file *src/paysages.pro* .
Go to the "Projects" tab to edit the directory in which the executable will be run, and set **the top project directory** (the one that contains *src* and *data* ). If you don't do this, some data files will not be found.
### Using a packaged Qt (Linux)
You need at least the 5.2 packaged version of Qt, with qMake and QtCore, QtGui and QtOpengl modules.
On Ubuntu/Mint:
sudo apt-get install qt5-qmake libqt5core5a libqt5gui5 libqt5widgets5 libqt5opengl5-dev
2014-02-09 16:05:01 +00:00
2014-08-25 19:57:30 +00:00
Then to build and run the software:
2014-02-09 16:05:01 +00:00
2014-08-25 19:57:30 +00:00
make run
2014-02-09 16:05:01 +00:00
2014-08-25 19:57:30 +00:00
### Unit tests
Running the unit tests needs the Google Test framework:
git submodule init
git submodule update
Then build and run the tests:
make tests
If you're using QtCreator, you can run the "tests" executable, not forgetting to change the directory in which the executable is run.
## Licensing
2014-02-09 16:05:01 +00:00
The source code is subject to the terms of the [Mozilla Public License, v. 2.0 ](http://mozilla.org/MPL/2.0/ ). Read the full terms in the LICENSE file.
2014-08-25 19:57:30 +00:00
## Credits
2014-02-09 16:05:01 +00:00
* [Michaël Lemaire ](http://thunderk.net ) - Main developer
* [Eric Bruneton and Fabrice Neyet ](http://www-evasion.imag.fr/Membres/Eric.Bruneton/ ) - Publication and source code from *Precomputed Atmospheric Scattering (2008)*
2014-02-09 16:07:53 +00:00
* [Qt ](http://qt-project.org/ ) - Library in use
2014-08-25 19:57:30 +00:00
* [GoogleTest ](https://code.google.com/p/googletest/ ) - Used for unit testing