|
|
# Old build system using VistaCMakeCommon
|
|
|
|
|
|
In the beginning of 2022, the build system was reworked. Only use this guide, if you work with code versions from 2021 or before. It is highly recommended to use the new build system which is described [here](home).
|
|
|
|
|
|
## Quick build guide
|
|
|
|
|
|
The ITA code base uses the build environment of [Vista VR Toolkit](http://www.itc.rwth-aachen.de/cms/IT-Center/Forschung-Projekte/Virtuelle-Realitaet/Infrastruktur/~fgmo/ViSTA-Virtual-Reality-Toolkit/), maintained by the [Virtual Acoustics Reality Group](http://www.itc.rwth-aachen.de/cms/IT-Center/Forschung-Projekte/~eubl/Virtuelle-Realitaet/) of [RWTH Aachen University](http://www.rwth-aachen.de). It is based on [CMake](http://www.cmake.org) with some macro extensions to ease finding external projects that expose a certain folder structure. You will have to download the following before you can start:
|
|
|
|
|
|
+ GIT (git for windows and, for convenience, TortoiseGit)
|
|
|
+ CMake
|
|
|
+ Development environment such as Visual Studio 2014 with Visual Studio Compiler 12 (vc12)
|
|
|
+ ViSTA preferably from [GIT](https://devhub.vr.rwth-aachen.de/VR-Group/ViSTA) or alternatively from [sourceforge.org](https://sourceforge.net/projects/vistavrtoolkit/files/)
|
|
|
+ VistaCMakeCommon preferably from [GIT](https://devhub.vr.rwth-aachen.de/VR-Group/VistaCMakeCommon) or alternatively from [sourceforge](https://sourceforge.net/projects/vistavrtoolkit/files/) (switch to 'develop' or 'ita' branch for newest features)
|
|
|
+ ExternalLibs (copy from ITA server at share/vr/dev/ExternalLibs or include this resource as a network drive within ITA network)
|
|
|
|
|
|
### Clone repositories (GIT)
|
|
|
|
|
|
Clone the repositories you want to aquire to your local file system. Some projects use submodules, so always **check out recursively** or initialize the submodules afterwards.
|
|
|
|
|
|
### Prepare CMake
|
|
|
|
|
|
In order to register additional vista macros and to help CMake to find the external libs, please add the following to your system environment variable list:
|
|
|
|
|
|
```
|
|
|
VISTA_CMAKE_COMMON=C:/path/to/VistaCMakeCommon
|
|
|
VISTA_EXTERNAL_LIBS=C:/path/to/ExternalLibs
|
|
|
```
|
|
|
|
|
|
Now you can start CMake, set the source code to the project you want to build and create project files, i.e. an ITACoreLibs.sln (Solution file for Visual Studio).
|
|
|
|
|
|
We recommend to use a naming similar to 'build_win32-x64.vc12' for a project file with win64 architecture for the Visual Studio 12 compiler, but any other name such as a simple 'build' is possible.
|
|
|
|
|
|
### Add-on components
|
|
|
|
|
|
ITACoreLibs requires third-party libraries for a few add-on components. For example, if you want to enable features such as reading WAV files, required external packages have to be found by CMake, in this case `libsndfile`. Follow the instructions from [ViSTA VR Toolkit documentation](https://sourceforge.net/projects/vistavrtoolkit/files/) on how to make your life easier with external libs.
|
|
|
|
|
|
### Latest updates
|
|
|
|
|
|
Follow the latest updates on the [Akustik-Blog](http://blog.rwth-aachen.de/akustik/category/software). |