|
|
|
# ITABase Wiki
|
|
|
|
|
|
|
|
ITABase is a component of [ITACoreLibs](https://git.rwth-aachen.de/ita/ITACoreLibs), a collection of libraries for audio streaming, general sample manipulation and useful tools for virtual acoustics applications in the C++ programming language
|
|
|
|
|
|
|
|
## 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 [RWTH GIT](https://git.rwth-aachen.de/ita/ViSTA) or alternatively from [sourceforge.org](https://sourceforge.net/projects/vistavrtoolkit/files/)
|
|
|
|
+ VistaCMakeCommon preferably from [RWTH GIT](https://git.rwth-aachen.de/ita/VistaCMakeCommon) or alternatively from [sourceforge](https://sourceforge.net/projects/vistavrtoolkit/files/)
|
|
|
|
+ ExternalLibs (copy from Verdi 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
|
|
|
|
|
|
|
|
ITABase 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.
|
|
|
|
|
|
|
|
#### Overview CMake switches for add-on features
|
|
|
|
|
|
|
|
```
|
|
|
|
ITA_BASE_WITH_OLD_CONFIG_IMPL
|
|
|
|
ITA_BASE_WITH_FASTMATH_ASSEMBLER
|
|
|
|
ITA_BASE_WITH_FASTMATH_IPP
|
|
|
|
ITA_BASE_WITH_OLD_ATOMICS
|
|
|
|
ITA_BASE_WITH_OLD_RAVEN_OPS
|
|
|
|
ITA_BASE_WITH_REGULAR_EXPRESSIONS
|
|
|
|
ITA_BASE_WITH_SNDFILE
|
|
|
|
```
|
|
|
|
|
|
|
|
### Latest updates
|
|
|
|
|
|
|
|
Follow the latest updates on the [Akustik-Blog](http://blog.rwth-aachen.de/akustik/category/software). |