Getting started with the VISR framework

Welcome to the user guide of the VISR user documentation.

Important

This document is work in progress. Please check the online documentation regularly for updates.

To get an overview of the VISR framework, we suggest reading Chapter VISR tutorial using Python, which provides a tutorial-style overview based on the paper [FF18].

Detailed installation instructions are provided in Chapter Getting VISR.

The standalone command-line applications contained in the VISR distribution are detailed in Chapter Using standalone applications.

The support for object-based audio in VISR is outlined in Chapter Object-Based Audio with VISR. This includes the audio object representation, but also the object-based renderers contained in the default VISR distribution.

The processing components contained in the default component libraries are documented in Chapter The default component library.

The Binaural synthesis toolkit is introduced in Chapter The Binaural Synthesis Toolkit, consisting of a tutorial-style description based on [FCPF18] and a component reference.

Python integration

Although the core of the VISR is written in C++ and there are uses of the VISR framework that do not require Python, the Python integration plays a central role in this user documentation. The main reason for that is accessibility. With Python, the VISR framework can be explored and extended interactively, and most interfaces are more intuitive than their C++ counterparts.

The main uses of the VISR framework without Python are the standalone applications explained in Using standalone applications, and the integration of VISR components and infrastructure in user-defined applications, plugins, or externals.

Because of this strong emphasis on the Python integration, it is important to install a VISR distribution built for thecorrect Python version, and to perform the Python-specific configuration steps. This is detailed in Section Setting up Python.