Skip to content

GitLab

Last edited by Lukas Aspöck
Page history

Home

ITACoreLibs Wiki

ITACoreLibs are a collection of C++ libraries with basic tools for virtual acoustics including real-time audio streaming components for synthesis and reproduction.

Quick build guide

The ITA code base uses the build environment of Vista VR Toolkit, maintained by the Virtual Acoustics Reality Group of RWTH Aachen University. It is based on CMake 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 or alternatively from sourceforge.org
  • VistaCMakeCommon preferably from GIT or alternatively from sourceforge (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 on how to make your life easier with external libs.

Latest updates

Follow the latest updates on the Akustik-Blog.