support.html 11.7 KB
Newer Older
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
<!DOCTYPE HTML>
<!--
	Landed by HTML5 UP
	html5up.net | @ajlkn
	Free for personal and commercial use under the CCA 3.0 license (html5up.net/license)
-->
<html>
	<head>
		<title>Virtual Acoustics</title>
		<meta charset="utf-8" />
		<meta name="viewport" content="width=device-width, initial-scale=1" />
		<!--[if lte IE 8]><script src="assets/js/ie/html5shiv.js"></script><![endif]-->
		<link rel="stylesheet" href="assets/css/main.css" />
		<!--[if lte IE 9]><link rel="stylesheet" href="assets/css/ie9.css" /><![endif]-->
		<!--[if lte IE 8]><link rel="stylesheet" href="assets/css/ie8.css" /><![endif]-->
	</head>
	<body>
		<div id="page-wrapper">

			<!-- Header -->
				<header id="header">
22
					<h1 id="logo"><a href="index.html">Home</a></h1>
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
23 24
					<nav id="nav">
						<ul>
25 26 27 28 29 30 31 32 33 34 35 36 37 38
							<li><a href="overview.html">Overview</a></li>
							<li><a href="download.html">Download</a></li>
							<li><a href="documentation.html">Documentation</a>
								<ul>
									<li><a href="documentation.html#configuration">Configuration</a></li>
									<li><a href="documentation.html#control">Control</a></li>
									<li><a href="documentation.html#scene_handling">Scene handling</a></li>
									<li><a href="documentation.html#rendering">Audio rendering</a></li>
									<li><a href="documentation.html#reproduction">Audio reproduction</a></li>
									<li><a href="documentation.html#tracking">Tracking</a></li>
									<li><a href="documentation.html#simulation_recording">Simulation and recording</a></li>
									<li><a href="documentation.html#examples">Examples</a></li>
								</ul>
							</li>
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
39
							<li>
40
								<a href="support.html">Support</a>
41
								<ul>
42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63
									<li><a href="support.html#faq">FAQ</a></li>
									<li><a href="support.html#issue_tracker">Issue tracker</a></li>
									<li><a href="support.html#community">Community</a></li>
									<li><a href="support.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>
64 65 66 67 68 69
								</ul>
							</li>
							<li><a href="legal.html">Legal notice</a></li>
						</ul>
					</nav>
				</header>
70
					
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
71 72 73 74 75 76


			<!-- Main -->
				<div id="main" class="wrapper style1">
					<div class="container">
						<header class="major">
77
							<h2>Support section</h2>
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
78 79 80 81 82 83 84 85 86 87 88
							<p>Get help </p>
						</header>
						<div class="row 150%">
							<div class="7u 12u$(medium)">

								<!-- Content -->
									<section id="faq">
										
										<h3>Frequently Asked Questions (FAQ)</h3>
										<p>
										
89 90
										<li><b>VA keeps nagging that the file I want to load can not be found </b> </li>
										<ul>If you load a file from hard drive, it has to be placed <i>on the computer where the VA server is running</i> - not necessarily on the client side, if you are using a remote connection. Use relative paths for loading files only, avoid absolute paths. Add search paths (folders where your files can be found) to help VA find the files. You can do this in the configuration file of the VA server, or you can interactively add the search path over the VA interface.
91 92
										</ul>
										
93 94
										<li><b>I can't connect to my VA server, although I am certain that the IP and port is correct. </b> </li>
										<ul>It is very likely, that your firewall has blocked the program due to insufficient privileges. This happens a lot in managed networks like universities, where you are not allowed to open a TCP/IP port. Please contact your network administration or check, if your firewall settings are blocking VA.<br >
95
										Also, check if the versions are matching and you are not mixing different VA binary packages of different compiler versions. Especially if dynamic linking to ViSTA and VA libraries is used, this can lead to unpredictable behavior, because the DLLs will have the same name - but are incompatible. It is strongly recommended to use static linking for bindings like Python or Matlab for this reason.
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
96 97
										</ul>
										
98 99 100 101
										<li><b>My audio output sounds strange </b> </li>
										<ul>Check your sampling rates and buffer sizes.<br />
										Do not overload your computer. There are limits on how much sound sources and sound receivers can be processed depending on the number of rendering and reproduction modules you've instantiated.<br />
										Use ASIO drivers.
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
102 103
										</ul>
										
Dipl.-Ing. Jonas Stienen's avatar
Stuff  
Dipl.-Ing. Jonas Stienen committed
104 105
										<li><b>Can a VA server run on a mobile device, for example on an <code>Android</code> platform?</b></li>
										<ul>No.</ul>										
106
										
Dipl.-Ing. Jonas Stienen's avatar
Stuff  
Dipl.-Ing. Jonas Stienen committed
107
										<li><b>I am trying to use a VA binding, but I get a 'module not found' or 'library not found' error.</b> </li>
Dipl.-Ing. Jonas Stienen's avatar
WIP  
Dipl.-Ing. Jonas Stienen committed
108
										<ul>You are missing a dependent shared library (dll on Windows). Make sure to include the dependencies if you copy libraries. If you are a developer, the <i>Dependency Walker</i> is an excellent supporter for solving these problems on Windows platforms. Otherwise consider switching to static linking to avoid this problem with the VA bindings.
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
109
										</ul>
Dipl.-Ing. Jonas Stienen's avatar
Stuff  
Dipl.-Ing. Jonas Stienen committed
110 111 112 113
										
										<li><b>Can I use <code>SOFA</code> HRTFs in VA?</b></li>
										<ul>Not directly, but you can convert <code>SOFA</code> HRTF files into <code>OpenDAFF</code> using the <a href="http://www.ita-toolbox.org" target="_blank">ITA-Toolbox for Matlab</a>. Create an <code>itaHRTF</code> and load the <code>SOFA</code> file, then export using <code>ita_write_daff</code>.</ul>
										
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
114 115 116 117 118 119 120 121 122 123
										</p>
										
									</section>
									
									<section id="issue_tracker">
									
										<p><!-- dummy spacer to unhide title on anchor access --><br /></p>
										
										<h3>Issue tracker</h3>
										
Dipl.-Ing. Jonas Stienen's avatar
WIP  
Dipl.-Ing. Jonas Stienen committed
124
										Issues are very likely to appear. VA is a prototyping software, and the usage can hardly be foreseen by the developers. However, it is important to identify if the issues you have are usage-related or require a bug fix in the code. If you are insecure, go through the <a href="#faq">FAQ</a> and discuss with the <a href="#community">community</a> first. <br />
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
125
										<br />
126
										If you have trouble configuring and using VA, there is a whole section about that in the <a href="documentation.html">documentation page</a>, which should be thoroughly read first. <br >
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
127 128 129 130 131 132
										<br />
										If you are sure it is a bug that should be fixed, then
										<ul>
										<li>does it affect the interface? File it here: <a href="https://git.rwth-aachen.de/ita/VABase/issues" target="_blank">VABase issues</a></li>
										<li>does it affect the Python binding? File it here: <a href="https://git.rwth-aachen.de/ita/VAPython/issues" target="_blank">VAPython issues</a></li>
										<li>does it affect the Matlab binding? File it here: <a href="https://git.rwth-aachen.de/ita/VAMatlab/issues" target="_blank">VAMatlab issues</a></li>
Dipl.-Ing. Jonas Stienen's avatar
Stuff  
Dipl.-Ing. Jonas Stienen committed
133
										<li>does it affect the Redstart application: <a href="https://git.rwth-aachen.de/ita/Redstart/issues" target="_blank">Redstart issues</a></li>
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
134 135
										<li>does it affect the functionality* of VA? File it here: <a href="https://git.rwth-aachen.de/ita/VACore/issues" target="_blank">VACore issues</a></li>
										</ul>
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
136
										* in most cases, VA and its rendering or reproduction modules will behave oddly, which usually points to a problem in the core of VA. Also, if you do not know where to file your issue, use the VACore as it is the most active part of development.
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
137 138 139 140 141 142 143 144
										
									</section>
									
									<section id="community">
									
										<p><!-- dummy spacer to unhide title on anchor access --><br /></p>
										
										<h3>VA community</h3>
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
145 146
										<p>The developers of VA can not answer every question due to limited resources. The solution approach is to establish a community of users that help each other to a) minimize the workload for the dev team and b) handle potentially easy-to-solve questions quicker. <br />
										Right now, questions can be asked at <a href="https://sound.stackexchange.com/search?q=va" target="_blank">stack exchange's sound design group</a>. If there are enough VA questions, a <a href="https://sound.stackexchange.com/questions/tagged/va" target="_blank">tag</a> <code>va</code> can be created that should be assigned with every question.
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
147 148 149 150 151 152 153 154 155
										</p>
										
									</section>
									
									<section id="nosupport">
									
										<p><!-- dummy spacer to unhide title on anchor access --><br /></p>
										
										<h3>VA has no official support team</h3>
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
156
										<p>We are very sorry to inform you, that there is no official support team in place. We, the developers of VA, are scientists and are paid for research, not commercial or private support activity. However, if you are willing to start a research alliance or fund a joint project that gives us opportunities to spend time on your ideas, we will be open to discuss your proposal. Please contact the administration of the <a href="http://www.akustik.rwth-aachen.de" target="_blank">Institute of Technical Acoustics (ITA), RWTH Aachen University</a>, in this case.
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
157 158 159 160 161 162 163 164 165 166 167 168
										</p>
										
									</section>
									

							</div>
							<div class="5u$ 12u$(medium)">

								<!-- Sidebar -->
									<section id="sidebar">
										<section>
											<h3>FAQ</h3>
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
169
											Frequently asked questions, the number one resource for quick help.
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198
											<p><a href="#faw">Read on</a><br />
											<h3>Issue tracker</h3>
											<p>Having a serious problem with VA? File it to get it fixed. <br /><a href="#issue_tracker">File it</a>
											</p>
											<h3>Community</h3>
											<p>Quick answers from other VA users. <br /> <a href="#community">Contact</a>
											</p>
											<h3>No support</h3>
											<p>Why we can't provide more support. <br /><a href="#community">Understand</a>
											</p>
										</section>
										<hr />
									</section>

							</div>
						</div>
					</div>
				</div>

			<!-- Footer -->
				<footer id="footer" style="background-color:black">
					<ul class="icons">
						<li><a href="http://www.akustik.rwth-aachen.de" class="icon alt fa-globe"><span class="label">ITA website</span></a></li>
						<li><a href="http://blog.rwth-aachen.de/akustik/category/va" class="icon alt fa-comments-o"><span class="label">Akustik-Blog</span></a></li>
						<li><a href="http://git.rwth-aachen.de/ita" class="icon alt fa-github"><span class="label">ITA GitLab</span></a></li>
					</ul>
					
					<span class="image"><img src="images/rwth_ita_akustik_en_institute_weiss_rgb_blackbg_small.jpg" alt="Institute of Technical Acoustics (ITA), RWTH Aachen University" /></span>
					
199
					<ul class="copyright">&copy; 2017-2020 Institute of Technical Acoustics (ITA), RWTH Aachen University</ul>
Dipl.-Ing. Jonas Stienen's avatar
Dipl.-Ing. Jonas Stienen committed
200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216
				</footer>


		</div>

		<!-- Scripts -->
			<script src="assets/js/jquery.min.js"></script>
			<script src="assets/js/jquery.scrolly.min.js"></script>
			<script src="assets/js/jquery.dropotron.min.js"></script>
			<script src="assets/js/jquery.scrollex.min.js"></script>
			<script src="assets/js/skel.min.js"></script>
			<script src="assets/js/util.js"></script>
			<!--[if lte IE 8]><script src="assets/js/ie/respond.min.js"></script><![endif]-->
			<script src="assets/js/main.js"></script>

	</body>
</html>