progressing

parent 097b41b1
......@@ -59,6 +59,14 @@
<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>
......
......@@ -27,7 +27,12 @@
<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>
<ul>
......@@ -52,10 +57,21 @@
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#build">Build guides</a></li>
<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>
......@@ -76,14 +92,17 @@
</header>
<!-- Content -->
<section id="vabasics">
<section id="preface">
<!--<a href="#" class="image fit"><img src="images/pic05.jpg" alt="" /></a>-->
<h4>Preface</h4>
<h3>Preface</h3>
<p>The documentation section offers a deeper insight into the principles of our approach, the design concept and implementation details. It is intended to address scientists who are looking for a profound description of VA, professionals of virtual acoustics who are interested in the details of concepts and software developer who are evaluating the deployment of VA.<br />
For all others, the <a href="overview.html">overview page</a> and the <a href="start.html">getting stated section</a> should be first point of contact.</p>
</section>
<section id="framework">
<h3>The Virtual Acoustics framework</h3>
......
......@@ -52,10 +52,21 @@
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#build">Build guides</a></li>
<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>
......
......@@ -52,10 +52,21 @@
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#build">Build guides</a></li>
<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>
......
......@@ -52,10 +52,21 @@
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#build">Build guides</a></li>
<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>
......
......@@ -52,10 +52,21 @@
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#build">Build guides</a></li>
<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>
......
......@@ -52,10 +52,21 @@
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#build">Build guides</a></li>
<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>
......
......@@ -52,7 +52,10 @@
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#build">Build guides</a></li>
<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>
......@@ -60,6 +63,7 @@
<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>
......
......@@ -52,10 +52,21 @@
<li>
<a href="developers.html">Developers</a>
<ul>
<li><a href="developers.html#build">Build guides</a></li>
<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>
......@@ -101,10 +112,155 @@
</p>
<h4>Basic configuration</h4>
<p></p>
<h5>Paths</h5>
<p>The <code>Paths</code> section allows to add search paths to the core. If resources are added that require a file (like HRTFs, geometry files, audio files), these folders are used to find it. Relative paths are resolved from the execution folder where the VA server application is started from. If you use the start batch scripts on Windows, it is recommended to add <code>data</code> and <code>conf</code> folders.</p>
<p>
<pre><code>[Paths]
data = data
conf = conf
my_data = C:/Users/Me/Documents/AuralizationData
my_other_data = /home/me/auralization/input
</code></pre>
</p>
<h5>Files</h5>
<p>The <code>Files</code> section allows to name files that will be included as further configuration files. This is helpful when certain configuration sections must be <i>outsourced</i> to be reused efficiently. This is especially helpful to switch between static sections like hardware descriptions for laboratories or setups, but can also be used for rendering and reproduction modules (see below). Avoid copying larger configuration sections and use different files, instead.
<p>
<pre><code>[Files]
old_lab = VASetup.OldLab.Loudspeakers.ini
#new_lab = VASetup.NewLab.Loudspeakers.ini
</code></pre>
</p>
<h5>Macros</h5>
<p>The <code>Macros</code> section is helpful to write clean scene scripts. Use macros if it is not explicitly required to use a this or that input file. For example, if any HRTF can be used for a scene, the <code>DefaultHRIR</code> points to the default HRTF data set (in time domain, hence HRIR). Macros can be defined and will be replaced with given value by the core.<br />
Usage: "$(MyMacroName)/file.abc" -> "MyValue/file.abc"<br />
Macros are substituted forwardly by key name order (use with care), otherwise stay untouched: A = B; C = $(A) -> $(C) is B<br />
The example macros below are a good practice set that should be present in a configuration file in order to keep the example scripts valid.<br />
Macros are also very helpful if certain exported file prefixes are desired, i.e. to get a more structured recording input and output file naming.
<p>
<pre><code>[Macros]
DefaultHRIR = HRIR/ITA-Kunstkopf_HRIR_AP11_Pressure_Equalized_3x3_256.v17.ir.daff
HumanDir = Directivity/Singer.v17.ms.daff
Trumpet = Directivity/Trumpet1.v17.ms.daff
# Define some other macros (examples)
ProjectName = MyVirtualAcousticsProject
</code></pre>
</p>
<h5>Debug</h5>
<p>The <code>Debug</code> section configures the initial behaviour of the core, i.e. log level and i/o recording. In the example, some macros are used (see Macros section above).
<p>
<pre><code>[Debug]
# Record device input and store to hard drive (will record every input channel)
OutputRecordEnabled = false
OutputRecordFilePath = $(ProjectName)_in.wav
# Record device output and store to hard drive (will record every output channel)
InputRecordEnabled = false
OutputRecordFilePath = $(ProjectName)_out.wav
# Set log level: 0 = quiet; 1 = errors; 2 = warnings (default); 3 = info; 4 = verbose; 5 = trace;
LogLevel = 3
</code></pre>
</p>
<h4>Audio interface configuration</h4>
<p></p>
<p>
The audio interface controls the backend driver and the device. Currently for the <code>Driver</code> backend key, <code>ASIO</code> is supported for Windows and <code>Portaudio</code> is available on all platforms. By default, Portaudio with the default driver is used that usually produces audible sound without further ado. However, the block sizes are high and the update rates are not sufficient for real-time auralization using motion tracking. Therefore, dedicated hardware and small block sizes should be used - and ASIO is recommended for Windows platforms.
</p>
<h5>ASIO example using ASIO4ALL v2</h5>
<p>
<a href="http://www.asio4all.de" target="_blank">ASIO4ALL</a> is a useful and well-implemented intermediate layer for audio I/O making it possible to use ASIO drivers for the internal hardware (and any other audio device available). It must be installed on the PC, first.
<pre><code>[Audio driver]
Driver = ASIO
Samplerate = 44100
Buffersize = AUTO
Device = ASIO4ALL v2
</code></pre>
Although it apprears that the buffer size can be defined for ASIO devices, the ASIO backend will automatically detect the buffer size that has been configured by the driver when the <code>AUTO</code> value is set (recommended). Set the buffer size in the ASIO driver dialog of your physical device, instead. Make sure, that the sampling rates are matching.<br />
ASIO requires a device name to be defined by each driver host. Further common hardware device names are
</p>
<div class="table-wrapper">
<table class="alt">
<thead>
<tr>
<th width="16%">Manufacturer</th>
<th width="32%">Device</th>
<th>ASIO device name</th>
</tr>
</thead>
<tbody>
<tr>
<td><b>RME</b></td>
<td><i>Hammerfall DSP</i></td>
<td><code>ASIO Hammerfall DSP</code></td>
</tr>
<tr>
<td><b>RME</b></td>
<td><i>Fireface USB</i></td>
<td><code>ASIO Fireface USB</code></td>
</tr>
<tr>
<td><b>RME</b></td>
<td><i>MADIFace USB</i></td>
<td><code>ASIO MADIface USB</code></td>
</tr>
<tr>
<td><b>Focusrite</b></td>
<td><i>2i2, 4i2, ...</i></td>
<td><code>Focusrite USB 2.0 Audio Driver</code></td>
</tr>
<tr>
<td><b>M-Audio</b></td>
<td><i>Fast Track Ultra</i></td>
<td><code>M-Audio Fast Track Ultra ASIO</code></td>
</tr>
<tr>
<td><b>Steinberg</b></td>
<td><i></i></td>
<td><code>Yamaha Steinberg USB ASIO</code></td>
</tr>
<tr>
<td><b>Zoom</b></td>
<td><i>H6</i></td>
<td><code>Zoom H6 ASIO</code></td>
</tr>
</tbody>
<tfoot>
<tr>
<td colspan="3">Table 1: Common ASIO device driver host names</td>
</tr>
</tfoot>
</table>
</div>
<p>
If you do not have any latency requirements you can also use <code>Portaudio</code> under Windows and other platforms. The specific device names of Portaudio interfaces can be detected e.g. with the VLC player or with Audacity. But the <code>default</code> device is recommended simply because it will pick the audio device that is also registered as the default device of your system. This is, what most people need anyway, and the system tools can be used to change the output device.<br />
If the <code>Buffersize</code> is unkown, at least the native buffer size of the audio device should be used (which is most likely <code>1024</code> for on-board chips). Otherwise, timing will behave oddly which has a negative side effect on the rendering.
<pre><code>[Audio driver]
Driver = Portaudio
Samplerate = 44100
Buffersize = 1024
Device = default
</code></pre>
</p>
<h4>Audio hardware configuration</h4>
<p></p>
......
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