Commit 746626d4 authored by fpa's avatar fpa

Merge branch 'master' of https://git.rwth-aachen.de/ita/VAWebsite

parents 6ed5d6fc 6625420f
......@@ -19,6 +19,62 @@
<!-- Header -->
<header id="header">
<h1 id="logo"><a href="index.html">Start</a></h1>
<nav id="nav">
<ul>
<li>
<a href="#">Quick access</a>
<ul>
<li><a href="overview.html">Overview</a></li>
<li><a href="download.html">Download</a></li>
<li><a href="documentation.html">Documentation</a></li>
<li>
<a href="start.html">Getting started</a>
<ul>
<li><a href="start.html#configuration">Configuration</a></li>
<li><a href="start.html#control">Control</a></li>
<li><a href="start.html#scene_handling">Scene handling</a></li>
<li><a href="start.html#rendering">Audio rendering</a></li>
<li><a href="start.html#reproduction">Audio reproduction</a></li>
<li><a href="start.html#tracking">Tracking</a></li>
<li><a href="start.html#simulation_recording">Simulation and recording</a></li>
<li><a href="start.html#examples">Examples</a></li>
</ul>
</li>
<li>
<a href="help.html">Get help</a>
<ul>
<li><a href="help.html#faq">FAQ</a></li>
<li><a href="help.html#issue_tracker">Issue tracker</a></li>
<li><a href="help.html#community">Community</a></li>
<li><a href="help.html#nosupport">No support</a></li>
</ul>
</li>
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#api">C++ API</a></li>
<li><a href="developers.html#dependencies">Dependencies</a></li>
<li><a href="developers.html#configuration">Configuration</a></li>
<li><a href="developers.html#build_guide">Build guide</a></li>
<li><a href="developers.html#repositories">Repositories</a></li>
</ul>
</li>
<li>
<a href="research.html">Research</a>
<ul>
<li><a href="research.html#system">System papers</a></li>
<li><a href="research.html#technology">Technology papers</a></li>
<li><a href="research.html#applied">Applied papers</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="legal.html">Legal notice</a></li>
<!--<li><a href="#" class="button special">Sign Up</a></li>-->
</ul>
</nav>
</header>
<h1 id="logo"><a href="index.html">Start</a></h1>
<nav id="nav">
<ul>
......@@ -30,14 +86,19 @@
<li><a href="documentation.html">Documentation</a></li>
<li>
<a href="start.html">Get started</a>
<ul>
<a href="start.html">Getting started</a>
<ul>
<li><a href="start.html#configuration">Configuration</a></li>
<li><a href="start.html#control">Control</a></li>
<li><a href="start.html#scene_handling">Scene handling</a></li>
<li><a href="start.html#inputdata">Input data</a></li>
<li><a href="start.html#rendering">Rendering</a></li>
<li><a href="start.html#rendering">Audio rendering</a></li>
<li><a href="start.html#reproduction">Audio reproduction</a></li>
<li><a href="start.html#reproduction">Reproduction</a></li>
<li><a href="start.html#tracking">Tracking</a></li>
<li><a href="start.html#simulation_recording">Simulation and recording</a></li>
<li><a href="start.html#examples">Examples</a></li>
</ul>
</ul>
</li>
<li>
......
......@@ -27,22 +27,18 @@
<ul>
<li><a href="overview.html">Overview</a></li>
<li><a href="download.html">Download</a></li>
<li><a href="documentation.html">Documentation</a></li>
<li>
<a href="documentation.html">Documentation</a>
<ul>
<li><a href="documentation.html#framework">Framework</a></li>
</ul>
</li>
<li>
<a href="start.html">Get started</a>
<a href="start.html">Getting started</a>
<ul>
<li><a href="start.html#configuration">Configuration</a></li>
<li><a href="start.html#control">Control</a></li>
<li><a href="start.html#scene_handling">Scene handling</a></li>
<li><a href="start.html#inputdata">Input data</a></li>
<li><a href="start.html#rendering">Rendering</a></li>
<li><a href="start.html#reproduction">Reproduction</a></li>
<li><a href="start.html#rendering">Audio rendering</a></li>
<li><a href="start.html#reproduction">Audio reproduction</a></li>
<li><a href="start.html#tracking">Tracking</a></li>
<li><a href="start.html#simulation_recording">Simulation and recording</a></li>
<li><a href="start.html#examples">Examples</a></li>
</ul>
</li>
<li>
......
......@@ -19,6 +19,62 @@
<!-- Header -->
<header id="header">
<h1 id="logo"><a href="index.html">Start</a></h1>
<nav id="nav">
<ul>
<li>
<a href="#">Quick access</a>
<ul>
<li><a href="overview.html">Overview</a></li>
<li><a href="download.html">Download</a></li>
<li><a href="documentation.html">Documentation</a></li>
<li>
<a href="start.html">Getting started</a>
<ul>
<li><a href="start.html#configuration">Configuration</a></li>
<li><a href="start.html#control">Control</a></li>
<li><a href="start.html#scene_handling">Scene handling</a></li>
<li><a href="start.html#rendering">Audio rendering</a></li>
<li><a href="start.html#reproduction">Audio reproduction</a></li>
<li><a href="start.html#tracking">Tracking</a></li>
<li><a href="start.html#simulation_recording">Simulation and recording</a></li>
<li><a href="start.html#examples">Examples</a></li>
</ul>
</li>
<li>
<a href="help.html">Get help</a>
<ul>
<li><a href="help.html#faq">FAQ</a></li>
<li><a href="help.html#issue_tracker">Issue tracker</a></li>
<li><a href="help.html#community">Community</a></li>
<li><a href="help.html#nosupport">No support</a></li>
</ul>
</li>
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#api">C++ API</a></li>
<li><a href="developers.html#dependencies">Dependencies</a></li>
<li><a href="developers.html#configuration">Configuration</a></li>
<li><a href="developers.html#build_guide">Build guide</a></li>
<li><a href="developers.html#repositories">Repositories</a></li>
</ul>
</li>
<li>
<a href="research.html">Research</a>
<ul>
<li><a href="research.html#system">System papers</a></li>
<li><a href="research.html#technology">Technology papers</a></li>
<li><a href="research.html#applied">Applied papers</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="legal.html">Legal notice</a></li>
<!--<li><a href="#" class="button special">Sign Up</a></li>-->
</ul>
</nav>
</header>
<h1 id="logo"><a href="index.html">Start</a></h1>
<nav id="nav">
<ul>
......
......@@ -19,6 +19,62 @@
<!-- Header -->
<header id="header">
<h1 id="logo"><a href="index.html">Start</a></h1>
<nav id="nav">
<ul>
<li>
<a href="#">Quick access</a>
<ul>
<li><a href="overview.html">Overview</a></li>
<li><a href="download.html">Download</a></li>
<li><a href="documentation.html">Documentation</a></li>
<li>
<a href="start.html">Getting started</a>
<ul>
<li><a href="start.html#configuration">Configuration</a></li>
<li><a href="start.html#control">Control</a></li>
<li><a href="start.html#scene_handling">Scene handling</a></li>
<li><a href="start.html#rendering">Audio rendering</a></li>
<li><a href="start.html#reproduction">Audio reproduction</a></li>
<li><a href="start.html#tracking">Tracking</a></li>
<li><a href="start.html#simulation_recording">Simulation and recording</a></li>
<li><a href="start.html#examples">Examples</a></li>
</ul>
</li>
<li>
<a href="help.html">Get help</a>
<ul>
<li><a href="help.html#faq">FAQ</a></li>
<li><a href="help.html#issue_tracker">Issue tracker</a></li>
<li><a href="help.html#community">Community</a></li>
<li><a href="help.html#nosupport">No support</a></li>
</ul>
</li>
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#api">C++ API</a></li>
<li><a href="developers.html#dependencies">Dependencies</a></li>
<li><a href="developers.html#configuration">Configuration</a></li>
<li><a href="developers.html#build_guide">Build guide</a></li>
<li><a href="developers.html#repositories">Repositories</a></li>
</ul>
</li>
<li>
<a href="research.html">Research</a>
<ul>
<li><a href="research.html#system">System papers</a></li>
<li><a href="research.html#technology">Technology papers</a></li>
<li><a href="research.html#applied">Applied papers</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="legal.html">Legal notice</a></li>
<!--<li><a href="#" class="button special">Sign Up</a></li>-->
</ul>
</nav>
</header>
<h1 id="logo"><a href="index.html">Start</a></h1>
<nav id="nav">
<ul>
......
......@@ -19,6 +19,62 @@
<!-- Header -->
<header id="header">
<h1 id="logo"><a href="index.html">Start</a></h1>
<nav id="nav">
<ul>
<li>
<a href="#">Quick access</a>
<ul>
<li><a href="overview.html">Overview</a></li>
<li><a href="download.html">Download</a></li>
<li><a href="documentation.html">Documentation</a></li>
<li>
<a href="start.html">Getting started</a>
<ul>
<li><a href="start.html#configuration">Configuration</a></li>
<li><a href="start.html#control">Control</a></li>
<li><a href="start.html#scene_handling">Scene handling</a></li>
<li><a href="start.html#rendering">Audio rendering</a></li>
<li><a href="start.html#reproduction">Audio reproduction</a></li>
<li><a href="start.html#tracking">Tracking</a></li>
<li><a href="start.html#simulation_recording">Simulation and recording</a></li>
<li><a href="start.html#examples">Examples</a></li>
</ul>
</li>
<li>
<a href="help.html">Get help</a>
<ul>
<li><a href="help.html#faq">FAQ</a></li>
<li><a href="help.html#issue_tracker">Issue tracker</a></li>
<li><a href="help.html#community">Community</a></li>
<li><a href="help.html#nosupport">No support</a></li>
</ul>
</li>
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#api">C++ API</a></li>
<li><a href="developers.html#dependencies">Dependencies</a></li>
<li><a href="developers.html#configuration">Configuration</a></li>
<li><a href="developers.html#build_guide">Build guide</a></li>
<li><a href="developers.html#repositories">Repositories</a></li>
</ul>
</li>
<li>
<a href="research.html">Research</a>
<ul>
<li><a href="research.html#system">System papers</a></li>
<li><a href="research.html#technology">Technology papers</a></li>
<li><a href="research.html#applied">Applied papers</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="legal.html">Legal notice</a></li>
<!--<li><a href="#" class="button special">Sign Up</a></li>-->
</ul>
</nav>
</header>
<h1 id="logo"><a href="index.html">Start</a></h1>
<nav id="nav">
<ul>
......
......@@ -19,6 +19,62 @@
<!-- Header -->
<header id="header">
<h1 id="logo"><a href="index.html">Start</a></h1>
<nav id="nav">
<ul>
<li>
<a href="#">Quick access</a>
<ul>
<li><a href="overview.html">Overview</a></li>
<li><a href="download.html">Download</a></li>
<li><a href="documentation.html">Documentation</a></li>
<li>
<a href="start.html">Getting started</a>
<ul>
<li><a href="start.html#configuration">Configuration</a></li>
<li><a href="start.html#control">Control</a></li>
<li><a href="start.html#scene_handling">Scene handling</a></li>
<li><a href="start.html#rendering">Audio rendering</a></li>
<li><a href="start.html#reproduction">Audio reproduction</a></li>
<li><a href="start.html#tracking">Tracking</a></li>
<li><a href="start.html#simulation_recording">Simulation and recording</a></li>
<li><a href="start.html#examples">Examples</a></li>
</ul>
</li>
<li>
<a href="help.html">Get help</a>
<ul>
<li><a href="help.html#faq">FAQ</a></li>
<li><a href="help.html#issue_tracker">Issue tracker</a></li>
<li><a href="help.html#community">Community</a></li>
<li><a href="help.html#nosupport">No support</a></li>
</ul>
</li>
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#api">C++ API</a></li>
<li><a href="developers.html#dependencies">Dependencies</a></li>
<li><a href="developers.html#configuration">Configuration</a></li>
<li><a href="developers.html#build_guide">Build guide</a></li>
<li><a href="developers.html#repositories">Repositories</a></li>
</ul>
</li>
<li>
<a href="research.html">Research</a>
<ul>
<li><a href="research.html#system">System papers</a></li>
<li><a href="research.html#technology">Technology papers</a></li>
<li><a href="research.html#applied">Applied papers</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="legal.html">Legal notice</a></li>
<!--<li><a href="#" class="button special">Sign Up</a></li>-->
</ul>
</nav>
</header>
<h1 id="logo"><a href="index.html">Start</a></h1>
<nav id="nav">
<ul>
......@@ -30,14 +86,19 @@
<li><a href="documentation.html">Documentation</a></li>
<li>
<a href="start.html">Get started</a>
<ul>
<a href="start.html">Getting started</a>
<ul>
<li><a href="start.html#configuration">Configuration</a></li>
<li><a href="start.html#control">Control</a></li>
<li><a href="start.html#scene_handling">Scene handling</a></li>
<li><a href="start.html#inputdata">Input data</a></li>
<li><a href="start.html#rendering">Rendering</a></li>
<li><a href="start.html#rendering">Audio rendering</a></li>
<li><a href="start.html#reproduction">Audio reproduction</a></li>
<li><a href="start.html#reproduction">Reproduction</a></li>
<li><a href="start.html#tracking">Tracking</a></li>
<li><a href="start.html#simulation_recording">Simulation and recording</a></li>
<li><a href="start.html#examples">Examples</a></li>
</ul>
</ul>
</li>
<li>
......
......@@ -34,10 +34,11 @@
<li><a href="start.html#configuration">Configuration</a></li>
<li><a href="start.html#control">Control</a></li>
<li><a href="start.html#scene_handling">Scene handling</a></li>
<li><a href="start.html#inputdata">Input data</a></li>
<li><a href="start.html#rendering">Rendering</a></li>
<li><a href="start.html#reproduction">Reproduction</a></li>
<li><a href="start.html#rendering">Audio rendering</a></li>
<li><a href="start.html#reproduction">Audio reproduction</a></li>
<li><a href="start.html#tracking">Tracking</a></li>
<li><a href="start.html#simulation_recording">Simulation and recording</a></li>
<li><a href="start.html#examples">Examples</a></li>
</ul>
</li>
<li>
......@@ -92,13 +93,18 @@
<h3>Preface</h3>
<p>Virtual Acoustics is a powerful tool for the auralization of virtual acoustic scenes and the reproduction thereof. Getting started with VA includes three important steps
<p>
<strong><ul><li>Configuring the application</li><li>Controlling the core</li><li>Setting up a scene</li></ul></strong>
</p>
The overall design goal aimed at keeping things as simple as possible. However, certain circumstances do not allow further simplicity due to their complexity by nature. VA addresses professionals and is mainly used by scientists. Important features are never traded for convenience if the system's integrity is at stake. Hence, getting everything out of VA will require profound understanding of the technologies involved. It is designed to offer highest flexibility which comes at the price of a demanding configuration. At the beginning, configuring VA is not trivial especially if a loudspeaker-based audio reproduction shall be used. <br /><br />
The usage of VA can often be divided into two user groups
<strong><ul><li>those who seek for quick experiments with spatial audio and are happy with conventional playback over headphones</li>
<li>those who want to employ VA for a sophisticated loudspeaker setup for (multi modal) listening experiments and Virtual Reality applications</li></ul></strong>
</p>
For the first group of users, there are some simple setups that will already suffice for most of the things you aspire. Such setups include, for example, a configuration for binaural audio rendering over a non-equalized off-the-shelf pair of headphones. Another configuration example contains a self-crafted interactive rendering application that exchanges pre-recorded or simulated FIR filters using Matlab or Python scripts for different purposes such as room acoustic simulations, building acoustics, A/B live switching tests to assess the influence of equalization. The configuration effort is minimal and works out of the box if you use the Redstart applications or start a VA command line server with the corresponding core configuration file. If you consider yourself as part of this group of users skip the configuration part and <a href="#examples">have a look at the examples</a>. Thereafter, read the <a href="#control"> control section</a> and the <a href="#scene_handling">scene handling section</a><br />
<br />
......@@ -1149,24 +1155,6 @@ va.unlock_update
</section>
<hr />
<section id="inputdata">
<p><!-- dummy spacer to unhide title on anchor access --><br /></p>
<!--
<h3>Directivities</h3>
<p>
Generally, input data from files or other resources should be kept to a minimum in VR systems, because they inherently result in limited interactivity. However, it is very common that data is loaded from the hard drive. This input data is usually a product of costly simulations (like FEM/BEM), design procedures (like CAD models), post-processed measurement data like HRTFs/directivities as well as directional or anechoic recordings of speech, music and other sounds.
</p>
<h4>Geometries, acoustic materials and others</h4>
<p>
Further input files are currently not supported by the core of VA (they are not handled automatically). However, any required input file can be forwarded to special renderers via the VA interface by using the prototype methods (with the help of </code>VAStruct</code> containers). For example, the room acoustics renderer uses the scene to load a file and the property getter/setter to control details of the room acoustics simulation. The artificial reverb renderer uses the prototype setter to modify room parameters required to evaluate Sabine's formula. The upside of this design is, that tryouts can be implemented quickly and tested via any interface to VA without API change. The downside is, that the parameter assembly has to be known by the user (usually the developer). Withouth documentation, it is required to browse the C++ code of the renderer to interpret the required naming convention in order to modify settings using structs.
</p>
-->
</section>
<section id="rendering">
<p><!-- dummy spacer to unhide title on anchor access --><br /></p>
......@@ -1324,6 +1312,8 @@ va.set_reproduction_module_parameters( reproduction_id, in_params )</code></pre>
<section id="tracking">
<p><!-- dummy spacer to unhide title on anchor access --><br /></p>
<h3>Tracking</h3>
<p>
VA does not support tracking internally but facilitates the integration of tracking devices to update VA entities. For external tracking, the <code>VAMatlab</code> project currently supports <b>NaturalPoint's OptiTrack</b> devices to be connected to a server instance. It can automatically forward rigid body poses (head and torso, separately) to one sound receiver and one sound source. Another possibility is to use an HMD such as <b>Oculus Rift and HTC Vive</b> and update VA through <b>Unity</b>.
......@@ -1375,7 +1365,7 @@ va.set_tracked_sound_source_rigid_body_rotation( [x y z w ] )</code></pre>
<h4>HMD via VAUnity</h4>
<p>
To connect an HMD, set up a Unity scene and connect the tracked GameObject (usually the MainCamera) with a VAUSoundReceiver instance. For further details, please read the README files of VAUnity.
To connect an HMD, set up a Unity scene and connect the tracked GameObject (usually the MainCamera) with a VAUSoundReceiver instance. For further details, please read the <a href="https://git.rwth-aachen.de/ita/VAUnity/blob/master/README.md" target="_blank">README files of VAUnity</a>.
</p>
</section>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment