Skip to content

Commit 757d96f

Browse files
committed
Add some flesh to the manual.
1 parent ded9b17 commit 757d96f

File tree

2 files changed

+24
-2
lines changed

2 files changed

+24
-2
lines changed

SarWeb/manual.html

+18-2
Original file line numberDiff line numberDiff line change
@@ -19,14 +19,30 @@ <h1>Router</h1>
1919
<div class="main">
2020
<h2>Overview</h2>
2121
<h2>Installation</h2>
22+
<p>System Requirements: <strong>Windows 7</strong> or later, x64 (64-bit) version, and an audio interface with ASIO support. <a href="http://www.asio4all.com">ASIO4ALL</a> is supported for devices without native ASIO support.</p>
23+
<p>SAR is provided as a standard Windows Installer package. If you're using Windows 7, Windows Update <a href="https://technet.microsoft.com/en-us/library/security/3033929.aspx">KB3033929</a> is a prerequisite. If it's missing, driver installation/loading will fail with an unsigned driver error.</p>
24+
<p>If SAR is currrently in use, you may need to close applications or reboot your machine after installing. Follow the on-screen instructions as needed.</p>
25+
<p>Once installed, the DAW application should be <a href="#known-issues">run as admin</a>, and SAR will be available in the list of ASIO drivers. Select it and open its control panel to open the endpoint list.</p>
2226
<h2>Endpoint List</h2>
27+
<p>The endpoint list contains the most important required configuration options for SAR.</p>
2328
<img src="images/sar_endpoints.png" />
29+
<ul>
30+
<li><strong>Hardware Interface</strong> - Select an ASIO driver for the physical audio interface to be used. SAR will not function without a selected ASIO driver. Click <strong>Configure</strong> to open the control panel for the physical audio interface's driver.</li>
31+
<li><strong>Windows Audio Devices</strong> - used to define audio endpoints. Any number of endpoints may be created, limited only by the performance of the machine. Endpoints are dynamically created when the host application starts ASIO, so they won't be visible in Windows control panel or applications until the configuration dialog is closed. Two types of endpoint are supported: <strong>Playback</strong> endpoints appear as Windows sound outputs and are mapped to ASIO input channels. Use them to capture audio from applications. <strong>Recording</strong> endpoints appear as Windows sound inputs and are mapped to ASIO output channels. Use them to send audio to applications.</li>
32+
</ul>
33+
<p>Selecting <strong>Add</strong> opens the endpoint details dialog.</p>
2434
<img src="images/sar_endpoint_details.png" />
35+
<p>Enter the name, type and number of channels for the endpoint and it will be added to the end of the endpoint list. Each endpoint will be mapped to ASIO channels in the order it occurs in the endpoint list, so for example, if the physical audio interface provides 2 input and 2 output channels, the configuration above would present BGM on ASIO inputs 3 and 4, Game on inputs 5 and 6, etc, and OBS on ASIO outputs 3 and 4, while leaving the original channels of the physical interface unmodified.</p>
2536
<h2>Application List</h2>
37+
<p>The application list is used to configure per-application overrides of the default Windows audio endpoints. This is useful to isolate audio from applications which don't have a UI for selecting an audio device.</p>
2638
<img src="images/sar_applications.png" />
27-
<h2>Application Details</h2>
39+
<ul>
40+
<li><strong>Enable per-application audio routing rules</strong> must be enabled to use this feature. If it's not enabled, applications will see the normal Windows defaults.</li>
41+
<li><strong>Applications</strong> displays the defined routing rules. Each entry specifies which default endpoints should be used for one or more applications.</li>
42+
</ul>
43+
<p>Selecting <strong>Add</strong> or double clicking a list entry opens the application details dialog.</p>
2844
<img src="images/sar_application_details.png" />
29-
<h2>Known Issues / Limitations</h2>
45+
<h2><a name="known-issues">Known Issues / Limitations</a></h2>
3046
<p>SAR is subject to the maximum latency limitation of WaveRT, which attempts to maintain a 10ms processing interval. As such, SAR limits the buffer size that's available to the ASIO host to a maximum of 1/100th of the sample rate. This imposes a latency requirement for the system that not all machines may be able to meet. If you experience buffer underruns at the maximum supported latency, try running a latency testing program such as LatencyMon to determine the cause of the delays.</p>
3147
<p>The current version of SAR requires that the host application which is creating endpoints have admin privileges. This is due to some security concerns with allowing applications to dynamically create audio endpoints, as well as the shared memory approach used to implement the WaveRT "hardware registers". The limitation may be removed in the future.</p>
3248
</div>

SarWeb/site.css

+6
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,12 @@ h1::first-letter
1515
color: red;
1616
}
1717

18+
img
19+
{
20+
margin: 2em auto;
21+
display: block;
22+
}
23+
1824
.title-wrapper { text-align: center; }
1925

2026
.title

0 commit comments

Comments
 (0)