79 lines
2.9 KiB
HTML
79 lines
2.9 KiB
HTML
|
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
||
|
|
<meta name="GENERATOR" content="Mozilla/4.77 [en]C-gatewaynet (Win98; U) [Netscape]">
|
||
|
|
<meta name="Author" content="Phil Burk">
|
||
|
|
<meta name="Description" content="Tutorial for PortAudio, a cross platform, open-source, audio I/O library.It provides a very simple API for recording and/or playing sound using a simple callback function.">
|
||
|
|
<meta name="KeyWords" content="audio, tutorial, library, portable, open-source, DirectSound,sound, music, JSyn, synthesis,">
|
||
|
|
<title>PortAudio Tutorial</title>
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
|
||
|
|
<center><table COLS=1 WIDTH="100%" BGCOLOR="#FADA7A" >
|
||
|
|
<tr>
|
||
|
|
<td>
|
||
|
|
<center>
|
||
|
|
<h1>
|
||
|
|
PortAudio Tutorial</h1></center>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</table></center>
|
||
|
|
|
||
|
|
<h2>
|
||
|
|
Compiling for Windows (WMME or DirectSound)</h2>
|
||
|
|
|
||
|
|
<blockquote>To compile PortAudio for Windows, you can choose between two
|
||
|
|
options. One implementation uses the DirectSound API. The other uses the
|
||
|
|
Windows MultiMedia Extensions API (aka WMME or WAVE).
|
||
|
|
<p>Some advantages of using DirectSound are that DirectSound may have lower
|
||
|
|
latency than WMME, and supports effects processing plugins. But one disadvantage
|
||
|
|
is that DirectSound is not installed on all PCs, and is not well supported
|
||
|
|
under Windows NT. So WMME is the best choice for most projects.
|
||
|
|
<p>For either implementation add the following source files to your project:
|
||
|
|
<blockquote>
|
||
|
|
<pre><b>pa_common\pa_lib.c
|
||
|
|
pa_common\portaudio.h
|
||
|
|
pa_common\pa_host.h</b></pre>
|
||
|
|
</blockquote>
|
||
|
|
Link with the system library "<b>winmm.lib</b>". For Visual C++:
|
||
|
|
<ol>
|
||
|
|
<li>
|
||
|
|
select "Settings..." from the "Project" menu,</li>
|
||
|
|
|
||
|
|
<li>
|
||
|
|
select the project name in the tree on the left,</li>
|
||
|
|
|
||
|
|
<li>
|
||
|
|
choose "All Configurations" in the popup menu above the tree,</li>
|
||
|
|
|
||
|
|
<li>
|
||
|
|
select the "Link" tab,</li>
|
||
|
|
|
||
|
|
<li>
|
||
|
|
enter "winmm.lib", without quotes, as the first item in the "Object/library
|
||
|
|
modules:" field.</li>
|
||
|
|
</ol>
|
||
|
|
<b>WMME</b> - To use the WMME implementation, add the following source
|
||
|
|
files to your project:
|
||
|
|
<blockquote><b><tt>pa_win_wmme/pa_win_wmme.c</tt></b></blockquote>
|
||
|
|
<b>DirectSound</b> - If you want to use the DirectSound implementation
|
||
|
|
of PortAudio then you must have a recent copy of the free
|
||
|
|
<a href="http://www.microsoft.com/directx/download.asp">DirectX</a>
|
||
|
|
SDK for Developers from Microsoft installed on your computer. To compile
|
||
|
|
an application add the following source files to your project:
|
||
|
|
<blockquote>
|
||
|
|
<pre><b>pa_win_ds\dsound_wrapper.c
|
||
|
|
pa_win_ds\pa_dsound.c</b></pre>
|
||
|
|
</blockquote>
|
||
|
|
Link with the system library "<b>dsound.lib</b>" using the procedure described
|
||
|
|
above for "winmm.lib".</blockquote>
|
||
|
|
|
||
|
|
<blockquote>You might try compiling the "pa_tests\patest_saw.c" file first
|
||
|
|
because it is the simplest.</blockquote>
|
||
|
|
<font size=+2><a href="http://www.portaudio.com/">home</a> |
|
||
|
|
<a href="pa_tutorial.html">contents</a>
|
||
|
|
| <a href="pa_tut_over.html">previous</a> | <a href="pa_tut_callback.html">next</a></font>
|
||
|
|
</body>
|
||
|
|
</html>
|