mirror of
https://github.com/cookiengineer/audacity
synced 2025-10-11 09:03:36 +02:00
Update portaudio to upstream r1966
------------------------------------------------------------------------ r1966 | philburk | 2016-02-15 11:06:54 -0600 (Mon, 15 Feb 2016) | 3 lines Update docs for building on Linux ------------------------------------------------------------------------ r1965 | philburk | 2016-01-04 11:22:56 -0600 (Mon, 04 Jan 2016) | 6 lines Files needed for compiling on El Capitan. These files were autogenerated using autoreconf based on changes from the previous commit. ------------------------------------------------------------------------ r1964 | philburk | 2016-01-04 11:22:00 -0600 (Mon, 04 Jan 2016) | 9 lines Add support for 10.11 SDK so PortAudio can compile on Mac. Also allow deprecated APIs until we can remove them. Note that this commit only includes the source files that were changed. The next commit will include the files that are generated by autoreconf. So look at this commit to see what really changed. ------------------------------------------------------------------------ r1963 | dmitrykos | 2015-10-21 09:25:07 -0500 (Wed, 21 Oct 2015) | 1 line wasapi: correction to the previous commit ------------------------------------------------------------------------ r1962 | dmitrykos | 2015-10-20 11:02:39 -0500 (Tue, 20 Oct 2015) | 1 line wasapi: workaround to avoid PaWasapi_Initialize() failure when enumerating devices and device fails to report min/default periods with IAudioClient::GetDevicePeriod(): ignore error and assign WASAPI common known period values for min/default ------------------------------------------------------------------------ r1961 | dmitrykos | 2015-10-19 06:03:31 -0500 (Mon, 19 Oct 2015) | 1 line wasapi: support for setting the WASAPI's AudioClientProperties options via PaWasapiStreamInfo struct (__IAudioClient2_INTERFACE_DEFINED__ must be defined by Windows SDK (for Windows 8 and up) to have effect from these new options, otherwise it will be noop) ------------------------------------------------------------------------ r1960 | rbencina | 2015-09-06 08:17:05 -0500 (Sun, 06 Sep 2015) | 1 line update doxygen main page to reference developer guidelines and implementation style guidelines on the Wiki ------------------------------------------------------------------------ r1959 | rbencina | 2015-09-06 07:43:06 -0500 (Sun, 06 Sep 2015) | 1 line checkfiledocs.py: blacklist mingw-include from doc check ------------------------------------------------------------------------ r1958 | rbencina | 2015-09-06 07:37:38 -0500 (Sun, 06 Sep 2015) | 1 line checkfiledocs.py: only check source code under src and include ------------------------------------------------------------------------ r1957 | rbencina | 2015-09-06 05:55:01 -0500 (Sun, 06 Sep 2015) | 1 line Issue #234 fixed typo in configure and configure.in affecting mingw builds. Rename: pa_win_wdmks_util.o --> pa_win_wdmks_utils.o ------------------------------------------------------------------------ r1956 | rbencina | 2015-09-06 05:26:16 -0500 (Sun, 06 Sep 2015) | 1 line removed bindings/java from doxygen generated documentation ------------------------------------------------------------------------ r1954 | gineera | 2015-04-19 13:48:38 -0500 (Sun, 19 Apr 2015) | 1 line Pa_process: Fix output channel adaption by not skipping the conversion when the host and user number-of-channels are not equal. Reported by Leif Asbrink when using an envy24 soundcard on Linux at it's native Int32 format with 1 or 2 channels. Corresponding fix for input already in r1913. ------------------------------------------------------------------------ r1953 | philburk | 2015-04-09 23:00:09 -0500 (Thu, 09 Apr 2015) | 4 lines Add Pa_GetVersionInfo() Add scripts to update pa_svnrevision.h ------------------------------------------------------------------------ r1952 | philburk | 2015-03-12 11:23:11 -0500 (Thu, 12 Mar 2015) | 3 lines Test adding a second file with SVN keywords. ------------------------------------------------------------------------ r1951 | philburk | 2015-03-12 11:21:04 -0500 (Thu, 12 Mar 2015) | 3 lines Used propset to enable SVN keywords on test file. ------------------------------------------------------------------------ r1950 | philburk | 2015-03-12 11:16:44 -0500 (Thu, 12 Mar 2015) | 3 lines Experiment with the SVN version keywords. ------------------------------------------------------------------------ r1949 | philburk | 2015-03-03 11:28:15 -0600 (Tue, 03 Mar 2015) | 4 lines Add version numbering with major.minor.subminor format. Bump version to 19.5.0 ------------------------------------------------------------------------ r1948 | rbencina | 2015-01-21 00:52:11 -0600 (Wed, 21 Jan 2015) | 1 line pa/wmme: avoid potential (but highly unlikely) overflow in buffer size in call to WideCharToMultiByte if a device name length exceeds INT_MAX. should also fix compiler warning about size_t to int assignment. ------------------------------------------------------------------------ r1947 | rbencina | 2015-01-21 00:32:29 -0600 (Wed, 21 Jan 2015) | 1 line removed declaration of unused variable ------------------------------------------------------------------------ r1946 | rbencina | 2015-01-21 00:30:53 -0600 (Wed, 21 Jan 2015) | 1 line fixed compiler warning: conversion from 'double' to 'float', possible loss of data ------------------------------------------------------------------------ r1945 | rbencina | 2015-01-21 00:24:32 -0600 (Wed, 21 Jan 2015) | 1 line disabled deprecated API warning for GetVersionEx in dsound, wmme and wdmks host APIs. ------------------------------------------------------------------------ r1944 | rbencina | 2015-01-20 23:35:39 -0600 (Tue, 20 Jan 2015) | 1 line Removed MSVC dependence on ksguid.lib from src/os/win/pa_win_wdmks_utils.c (ksguid.lib is no longer in Platform SDK 8.0). Always use static instances of GUIDs like the GCC builds do. Removed ksguid.lib from MSVC project file. The following symbols are no longer used: PA_WDMKS_NO_KSGUID_LIB, PAWIN_WDMKS_NO_KSGUID_LIB; removed them from CMakeLists.txt and the MSVC project file. ------------------------------------------------------------------------ r1943 | rbencina | 2015-01-19 23:10:17 -0600 (Mon, 19 Jan 2015) | 1 line cpp binding: make operator == and != const. thanks to Riot for this patch. ticket #230 ------------------------------------------------------------------------ r1934 | rbencina | 2014-11-04 19:03:57 -0600 (Tue, 04 Nov 2014) | 1 line PA/CoreAudio: fixed copy-pasto: last host error was being associated with paInDevelopment host api not paCoreAudio ------------------------------------------------------------------------ r1933 | robiwan | 2014-08-28 00:59:40 -0500 (Thu, 28 Aug 2014) | 1 line Added more debugging info in wdmks/pa_win_wdmks.c ------------------------------------------------------------------------ r1932 | robiwan | 2014-08-15 01:35:32 -0500 (Fri, 15 Aug 2014) | 1 line Committing Lelands patch for WDM-KS, should take care of some of the problems referenced here http://music.columbia.edu/pipermail/portaudio/2014-August/016246.html ------------------------------------------------------------------------ r1930 | bejayoharen | 2014-06-28 11:28:17 -0500 (Sat, 28 Jun 2014) | 1 line olivier's device name patch for os x ------------------------------------------------------------------------ r1928 | rbencina | 2014-04-11 00:46:40 -0500 (Fri, 11 Apr 2014) | 1 line pa_win_ds.c converted tabs to spaces (only a small amount of code was incorrectly using tabs). ------------------------------------------------------------------------ r1927 | rbencina | 2014-04-11 00:44:50 -0500 (Fri, 11 Apr 2014) | 1 line DirectSound: correctly output device names as UTF-8 when compiled with UNICODE defined. Note that this patch may not be correct if UNICODE is not defined. Patch from Tobias Erichsen. See ticket #224 for details. ------------------------------------------------------------------------ r1926 | rbencina | 2014-04-11 00:31:13 -0500 (Fri, 11 Apr 2014) | 1 line pa_win_wmme.c: converted tabs to spaces (just a few sections) ------------------------------------------------------------------------ r1925 | rbencina | 2014-04-11 00:25:48 -0500 (Fri, 11 Apr 2014) | 1 line WMME: correctly convert device names to UTF-8, see ticket #224. Thanks to Tobias Erichsen for the patch. ------------------------------------------------------------------------ r1924 | robiwan | 2014-04-09 09:27:21 -0500 (Wed, 09 Apr 2014) | 4 lines CMake: Added PA_WDMKS_NO_KSGUID_LIB to WDMKS and solution folders WDMKS: Support for default device (see caveat for input devices though in ScanDeviceInfos) Added possibility to set channel mask ------------------------------------------------------------------------ r1920 | bejayoharen | 2014-02-05 12:43:31 -0600 (Wed, 05 Feb 2014) | 1 line Clarified safety of operations in callback (doc) ------------------------------------------------------------------------ r1919 | rbencina | 2014-01-30 05:46:42 -0600 (Thu, 30 Jan 2014) | 1 line updated Windows+ASIO build tutorial: Building Portaudio for Windows with ASIO support using MSVC. The tutorial was out of date and contained a number of errors that broke the build process. ------------------------------------------------------------------------ r1918 | rbencina | 2014-01-30 04:12:02 -0600 (Thu, 30 Jan 2014) | 1 line tweaked Windows build tutorial: Building PortAudio for Windows using Microsoft Visual Studio - various improvements to clarity of text. Fixed broken ASIO SDK URL. ------------------------------------------------------------------------ r1916 | philburk | 2014-01-16 21:45:15 -0600 (Thu, 16 Jan 2014) | 6 lines Add stub to pa_trace.c to eliminate warning. "make install" was causing a warning if PA_TRACE_REALTIME_EVENTS was not defined. ------------------------------------------------------------------------ r1915 | philburk | 2014-01-16 11:51:26 -0600 (Thu, 16 Jan 2014) | 5 lines [tests] Add EOL to patest_mono.c Build was failing on Mac because of the missing end-of-line. ------------------------------------------------------------------------ r1914 | philburk | 2014-01-16 11:49:33 -0600 (Thu, 16 Jan 2014) | 6 lines [macosx] Add support for SDK 10.8 and 10.9. This was required to fix a broken build caused by not having SDK 10.7 or earlier. ------------------------------------------------------------------------ r1913 | gineera | 2013-11-18 05:42:27 -0600 (Mon, 18 Nov 2013) | 1 line Pa_process: Fix input channel adaption by not skipping the input conversion when the host and user number-of-channels are not equal. The bug manifested when recording mono from a stereo-only device (eg with Alsa hw: devices on some sound-cards), and was reported by the Mixxx team -see https://bugs.launchpad.net/mixxx/+bug/900364. (In the long-term, some refactoring may be preferable.) Also fixed copy-paste typos in comments. ------------------------------------------------------------------------ r1912 | gineera | 2013-11-15 06:27:07 -0600 (Fri, 15 Nov 2013) | 1 line Jack: Add a port-type filter expression to calls to jack_get_ports() so that only audio ports are listed (removing eg Midi etc) as reported by 'sqweek'. ------------------------------------------------------------------------ r1911 | gineera | 2013-10-17 07:44:09 -0500 (Thu, 17 Oct 2013) | 1 line Alsa: Revise the use of the environment variable 'PA_ALSA_PLUGHW' so it correctly influences the Device-List and the capabilities reported. Also rename a mis-leading variable and add one additional DEBUG line.
This commit is contained in:
Leland Lucius
@@ -49,7 +49,9 @@ Documentation for the Java JNI interface to PortAudio
|
||||
|
||||
- <a href="http://www.assembla.com/spaces/portaudio/wiki">Our wiki and issue tracking system</a>
|
||||
|
||||
- <a href="http://www.portaudio.com/docs/proposals/014-StyleGuide.html">Coding guidelines</a>
|
||||
- <a href="https://www.assembla.com/spaces/portaudio/wiki/DeveloperGuidelines">Developer guidelines</a>
|
||||
|
||||
- <a href="https://www.assembla.com/spaces/portaudio/wiki/ImplementationStyleGuidelines">Implementation style guidelines</a>
|
||||
|
||||
If you're interested in helping out with PortAudio development we're more than happy for you to be involved. Just drop by the PortAudio mailing list and ask how you can help. Or <a href="http://www.assembla.com/spaces/portaudio/tickets">check out the starter tickets</a>.
|
||||
|
||||
|
||||
@@ -32,7 +32,7 @@ That will build PortAudio using Jack, ALSA and OSS in whatever combination they
|
||||
To use PortAudio in your apps, you can simply install the .so files:
|
||||
|
||||
@code
|
||||
make install
|
||||
sudo make install
|
||||
@endcode
|
||||
|
||||
Projects built this way will expect PortAudio to be installed on target systems in order to run. If you want to build a more self-contained binary, you may use the libportaudio.a file:
|
||||
@@ -41,10 +41,16 @@ Projects built this way will expect PortAudio to be installed on target systems
|
||||
cp lib/.libs/libportaudio.a /YOUR/PROJECT/DIR
|
||||
@endcode
|
||||
|
||||
On some systems you may need to use:
|
||||
|
||||
@code
|
||||
cp /usr/local/lib/libportaudio.a /YOUR/PROJECT/DIR
|
||||
@endcode
|
||||
|
||||
You may also need to copy portaudio.h, located in the include/ directory of PortAudio into your project. Note that you will usually need to link with the approriate libraries that you used, such as ALSA and JACK, as well as with librt and libpthread. For example:
|
||||
|
||||
@code
|
||||
gcc -lrt -lasound -ljack -lpthread -o YOUR_BINARY main.c libportaudio.a
|
||||
gcc main.c libportaudio.a -lrt -lm -lasound -ljack -pthread -o YOUR_BINARY
|
||||
@endcode
|
||||
|
||||
@section comp_linux4 Linux Extensions
|
||||
|
||||
@@ -1,33 +1,39 @@
|
||||
/** @page compile_windows Building Portaudio for Windows using Microsoft Visual Studio
|
||||
/** @page compile_windows Building PortAudio for Windows using Microsoft Visual Studio
|
||||
@ingroup tutorial
|
||||
|
||||
Below is a list of steps to build PortAudio into a dll and lib file. The resulting dll file may contain all five current win32 PortAudio APIs: MME, DirectSound, WASAPI, WDM/KS and ASIO, depending on the preprocessor definitions set in step 9 below.
|
||||
|
||||
PortAudio can be compiled using Visual C++ Express Edition which is available free from Microsoft. If you do not already have a C++ development environment, simply download and install. These instructions have been observed to succeed using Visual Studio 2010 as well.
|
||||
|
||||
1) PortAudio for Windows requires the files <i>dsound.h</i> and <i>dsconf.h</i>. Download and install the DirectX SDK from http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=3021d52b-514e-41d3-ad02-438a3ba730ba to obtain these files. If you installed the DirectX SDK then the !DirectSound libraries and header files should be found automatically by Visual !Studio/Visual C++. If you get an error saying dsound.h or dsconf.h is missing, you can declare these paths by hand. Alternatively, you can copy dsound.h and dsconf.h to portaudio\\include. There should also be a file named ''dsound.lib'' in C:\\Program Files\\Microsoft SDKs\\Windows\\v6.0A\\Lib.
|
||||
1) Building PortAudio with DirectSound support requires the files <i>dsound.h</i> and <i>dsconf.h</i>. Download and install the DirectX SDK from http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=3021d52b-514e-41d3-ad02-438a3ba730ba to obtain these files. If you installed the DirectX SDK then the DirectSound libraries and header files should be found automatically by Visual Studio/Visual C++. If you get an error saying dsound.h or dsconf.h is missing, you will need to add an extra include path to the Visual Studio project file referencing the DirectX includes directory.
|
||||
|
||||
2) For ASIO support, download the ASIO SDK from Steinberg at http://www.steinberg.net/en/company/developer.html. The SDK is free but you will need to set up a developer account with Steinberg. Copy the entire ASIOSDK2 folder into src\\hostapi\\asio\\. Rename it from ASIOSDK2 to ASIOSDK. To build without ASIO (or other host API) see the "Building without ASIO support" section below.
|
||||
2) For ASIO support, download the ASIO SDK from Steinberg at http://www.steinberg.net/en/company/developer.html . The SDK is free, but you will need to set up a developer account with Steinberg. To use the Visual Studio projects mentioned below, copy the entire ASIOSDK2 folder into src\\hostapi\\asio\\. Rename it from ASIOSDK2 to ASIOSDK. To build without ASIO (or other host API) see the "Building without ASIO support" section below.
|
||||
|
||||
3) If you have Visual Studio 6.0, 7.0(VC.NET/2001) or 7.1(VC.2003), open portaudio.dsp and convert if needed.
|
||||
|
||||
4) If you have Visual Studio 2005, Visual C++ 2008 Express Edition or Visual Studio 2010, double click the portaudio.sln file located in build\\msvc\\. Doing so will open Visual Studio or Visual C++. Click "Finish" if a wizard appears. The sln file contains four configurations: Win32 and Win64 in both Release and Debug variants.
|
||||
4) If you have Visual Studio 2005, Visual C++ 2008 Express Edition or Visual Studio 2010, open the portaudio.sln file located in build\\msvc\\. Doing so will open Visual Studio or Visual C++. Click "Finish" if a conversion wizard appears. The sln file contains four configurations: Win32 and Win64 in both Release and Debug variants.
|
||||
|
||||
@section comp_win1 For Visual Studio 2005, Visual C++ 2008 Express Edition or Visual Studio 2010
|
||||
|
||||
The steps below describe settings for recent versions of Visual Studio. Similar settings can be set in earlier versions of Visual Studio.
|
||||
|
||||
5) Open Project -> portaudio Properties and select "Configuration Properties" in the tree view.
|
||||
|
||||
6) Select "all configurations" in the "Configurations" combo box above. Select "All Platforms" in the "Platforms" combo box.
|
||||
|
||||
7) Now set a few options:
|
||||
|
||||
C/C++ -> Optimization -> Omit frame pointers = Yes
|
||||
Required:
|
||||
|
||||
C/C++ -> Code Generation -> Runtime library = /MT
|
||||
|
||||
Optional:
|
||||
|
||||
C/C++ -> Optimization -> Omit frame pointers = Yes
|
||||
|
||||
Optional: C/C++ -> Code Generation -> Floating point model = fast
|
||||
|
||||
NOTE: For most users it is not necessary to explicitly set the structure member alignment; the default should work fine. However some languages require, for example, 4-byte alignment. If you are having problems with portaudio.h structure members not being properly read or written to, it may be necessary to explicitly set this value by going to C/C++ -> Code Generation -> Struct member alignment and setting it to an appropriate value (four is a common value). If your compiler is configurable, you should ensure that it is set to use the same structure member alignment value as used for the PortAudio build.
|
||||
NOTE: When using PortAudio from C/C++ it is not usually necessary to explicitly set the structure member alignment; the default should work fine. However some languages require, for example, 4-byte alignment. If you are having problems with portaudio.h structure members not being properly read or written to, it may be necessary to explicitly set this value by going to C/C++ -> Code Generation -> Struct member alignment and setting it to an appropriate value (four is a common value). If your compiler is configurable, you should ensure that it is set to use the same structure member alignment value as used for the PortAudio build.
|
||||
|
||||
Click "Ok" when you have finished setting these parameters.
|
||||
|
||||
@@ -37,7 +43,7 @@ Since the preprocessor definitions are different for each configuration and plat
|
||||
|
||||
8) To suppress PortAudio runtime debug console output, go to Project -> Properties -> Configuration Properties -> C/C++ -> Preprocessor. In the field 'Preprocessor Definitions', find PA_ENABLE_DEBUG_OUTPUT and remove it. The console will not output debug messages.
|
||||
|
||||
9) Also in the preprocessor definitions you need to explicitly define the audio APIs you wish to use. For Windows the available API definitions are:
|
||||
9) Also in the preprocessor definitions you need to explicitly define the native audio APIs you wish to use. For Windows the available API definitions are:
|
||||
|
||||
PA_USE_ASIO<br>
|
||||
PA_USE_DS (DirectSound)<br>
|
||||
@@ -46,7 +52,7 @@ PA_USE_WASAPI<br>
|
||||
PA_USE_WDMKS<br>
|
||||
PA_USE_SKELETON
|
||||
|
||||
For each of these, the value of 0 indicates that support for this API should not be included. The value 1 indicates that support for this API should be included.
|
||||
For each of these, the value of 0 indicates that support for this API should not be included. The value 1 indicates that support for this API should be included. (PA_USE_SKELETON is not usually used, it is a code sample for developers wanting to support a new API).
|
||||
|
||||
@section comp_win3 Building
|
||||
|
||||
@@ -54,7 +60,7 @@ As when setting Preprocessor definitions, building is a per-configuration per-pl
|
||||
|
||||
10) From the Build menu click Build -> Build solution. For 32-bit compilations, the dll file created by this process (portaudio_x86.dll) can be found in the directory build\\msvc\\Win32\\Release. For 64-bit compilations, the dll file is called portaudio_x64.dll, and is found in the directory build\\msvc\\x64\\Release.
|
||||
|
||||
11) Now, any project which requires portaudio can be linked with portaudio_x86.lib (or _x64) and include the relevant headers (portaudio.h, and/or pa_asio.h , pa_x86_plain_converters.h) You may want to add/remove some DLL entry points. Right now those 6 entries are not from portaudio.h:
|
||||
11) Now, any project that requires portaudio can be linked with portaudio_x86.lib (or _x64) and include the relevant headers (portaudio.h, and/or pa_asio.h , pa_x86_plain_converters.h) You may want to add/remove some DLL entry points. At the time of writing the following 6 entries are not part of the official PortAudio API defined in portaudio.h:
|
||||
|
||||
(from portaudio.def)
|
||||
@code
|
||||
@@ -71,13 +77,16 @@ PaUtil_SetLogPrintFunction @55
|
||||
|
||||
To build PortAudio without ASIO support you need to:
|
||||
|
||||
1) Make sure your project doesn't try to build any ASIO SDK files. If you're using one of the shipped projects, remove the ASIO related files from the project.
|
||||
1) Make sure your project doesn't try to build any ASIO SDK files. If you're using one of the shipped projects, remove the ASIO related files from the project. In the shipped projects you can find them in the project tree under portaudio > Source Files > hostapi > ASIO > ASIOSDK
|
||||
|
||||
2) Make sure your project doesn't try to build the PortAudio ASIO implementation files:
|
||||
|
||||
src\\hostapi\\pa_asio.cpp src\\hostapi\\iasiothiscallresolver.cpp
|
||||
@code
|
||||
src\\hostapi\\pa_asio.cpp
|
||||
src\\hostapi\\iasiothiscallresolver.cpp
|
||||
@endcode
|
||||
|
||||
If you're using one of the shipped projects, remove them from the project.
|
||||
If you're using one of the shipped projects, remove them from the project. In the shipped projects you can find them in the project tree under portaudio > Source Files > hostapi > ASIO
|
||||
|
||||
3) Define the preprocessor symbols in the project properties as described in step 9 above. In VS2005 this can be accomplished by selecting
|
||||
Project Properties -> Configuration Properties -> C/C++ -> Preprocessor -> Preprocessor Definitions. Omitting PA_USE_ASIO or setting it to 0 stops src\\os\\win\\pa_win_hostapis.c from trying to initialize the PortAudio ASIO implementation.
|
||||
@@ -92,6 +101,8 @@ Updated by Chris on 5/26/2011
|
||||
|
||||
Improvements by John Clements on 12/15/2011
|
||||
|
||||
Edits by Ross on 1/20/2014
|
||||
|
||||
Back to the Tutorial: \ref tutorial_start
|
||||
|
||||
*/
|
||||
@@ -7,14 +7,14 @@ This tutorial describes how to build PortAudio with ASIO support using MSVC *fro
|
||||
|
||||
ASIO is a low latency audio API from Steinberg. To compile an ASIO
|
||||
application, you must first download the ASIO SDK from Steinberg. You also
|
||||
need to obtain ASIO drivers for your audio device. Download the ASIO SDK from Steinberg at http://www.steinberg.net/en/company/developer.html. The SDK is free but you will need to set up a developer account with Steinberg.
|
||||
need to obtain ASIO drivers for your audio device. Download the ASIO SDK from Steinberg at http://www.steinberg.net/en/company/developer.html . The SDK is free but you will need to set up a developer account with Steinberg.
|
||||
|
||||
This tutorial assumes that you have 3 directories set up at the same level (side by side), one containing PortAudio, one containing the ASIO SDK and one containing your Visual Studio project:
|
||||
|
||||
@code
|
||||
/ASIOSDK2
|
||||
/portaudio
|
||||
/DirContainingYourVisualStudioProject
|
||||
/DirContainingYourVisualStudioProject (should directly contain the .sln, .vcproj or .vcprojx etc.)
|
||||
@endcode
|
||||
|
||||
First, make sure that the Steinberg SDK and the portaudio files are "side by side" in the same directory.
|
||||
@@ -54,10 +54,11 @@ pa_stream.c (portaudio\src\common)
|
||||
pa_trace.c (portaudio\src\common)
|
||||
pa_win_hostapis.c (portaudio\src\os\win)
|
||||
pa_win_util.c (portaudio\src\os\win)
|
||||
pa_win_coinitialize.c (portaudio\src\os\win)
|
||||
pa_win_waveformat.c (portaudio\src\os\win)
|
||||
pa_x86_plain_converters.c (portaudio\src\os\win)
|
||||
patest_saw.c (portaudio\test) (Or another file containing main()
|
||||
for the console exe to be built.)
|
||||
paex_saw.c (portaudio\examples) (Or another file containing main()
|
||||
for the console exe to be built.)
|
||||
@endcode
|
||||
|
||||
|
||||
@@ -71,25 +72,26 @@ pa_asio.h (portaudio\include)
|
||||
These header files define the interfaces to the PortAudio API.
|
||||
|
||||
|
||||
Next, go to Project Settings > All Configurations > C/C++ > Preprocessor > Preprocessor definitions and add
|
||||
Next, go to Project Settings > All Configurations > C/C++ > Preprocessor > Preprocessor Definitions and add
|
||||
PA_USE_ASIO=1 to any entries that might be there.
|
||||
|
||||
eg: WIN32;_CONSOLE;_MBCS changes to WIN32;_CONSOLE,_MBCS;PA_USE_ASIO=1
|
||||
|
||||
Then, on the same Project Settings tab, go down to Additional include directories: and enter the following relative include paths.
|
||||
Then, on the same Project Settings tab, go down to Additional Include Directories (in VS2010 you'll find this setting under C/C++ > General) and enter the following relative include paths:
|
||||
|
||||
@code
|
||||
..\portaudio\include,..\portaudio\src\common,..\asiosdk2\common,..\asiosdk2\host,..\asiosdk2\host\pc
|
||||
..\portaudio\include;..\portaudio\src\common;..\portaudio\src\os\win;..\asiosdk2\common;..\asiosdk2\host;..\asiosdk2\host\pc
|
||||
@endcode
|
||||
|
||||
You'll need to make sure the relative paths are correct for the particular directory layout you're using. The above should work fine if you use the side-by-side layout we recommended earlier.
|
||||
|
||||
You should now be able to build any of the test executables in the portaudio\test directory.
|
||||
We suggest that you start with patest_saw.c because it's one of the simplest test files.
|
||||
Some source code in the ASIO SDK is not compatible with the Win32 API UNICODE mode (The ASIO SDK expects the non-Unicode Win32 API). Therefore you need to make sure your project is set to not use Unicode. You do this by setting the project Character Set to "Use Multi-Byte Character Set" (NOT "Use Unicode Character Set"). In VS2010 the Character Set option can be found at Configuration Properties > General > Character Set. (An alternative to setting the project to non-Unicode is to patch asiolist.cpp to work when UNICODE is defined: put #undef UNICODE at the top of the file before windows.h is included.)
|
||||
|
||||
You should now be able to build any of the test executables in the portaudio\\examples directory.
|
||||
We suggest that you start with paex_saw.c because it's one of the simplest example files.
|
||||
|
||||
--- Chris Share, Tom McCandless, Ross Bencina
|
||||
|
||||
[wiki:UsingThePortAudioSvnRepository SVN instructions]
|
||||
Back to the Tutorial: \ref tutorial_start
|
||||
|
||||
*/
|
||||
@@ -7,7 +7,11 @@ To write a program using PortAudio, you must include the "portaudio.h" include f
|
||||
@endcode
|
||||
The next task is to write your own "callback" function. The "callback" is a function that is called by the PortAudio engine whenever it has captured audio data, or when it needs more audio data for output.
|
||||
|
||||
Before we begin, it's important to realize that the callback is a delicate place. This is because some systems perform the callback in a special thread, or interrupt handler, and it is rarely treated the same as the rest of your code. In addition, if you want your audio to reach the speakers on time, you'll need to make sure whatever code you run in the callback runs quickly. What is safe or not safe will vary from platform to platform, but as a rule of thumb, don't do anything like allocating or freeing memory, reading or writing files, printf(), or anything else that might take an unbounded amount of time or rely on the OS or require a context switch. <i>Ed: is this still true?: Also do not call any PortAudio functions in the callback except for Pa_StreamTime() and Pa_GetCPULoad().</i>
|
||||
Before we begin, it's important to realize that the callback is a delicate place. This is because some systems perform the callback in a special thread, or interrupt handler, and it is rarely treated the same as the rest of your code.
|
||||
For most modern systems, you won't be able to cause crashes by making disallowed calls in the callback, but if you want your code to produce glitch-free audio, you will have to make sure you avoid function calls that may take an unbounded amount of time
|
||||
to execute. Exactly what these are depend on your platform but almost certainly include the following: memory allocation/deallocation, I/O (including file I/O as well as console I/O, such as printf()), context switching (such as exec() or
|
||||
yield()), mutex operations, or anything else that might rely on the OS. If you think short critical sections are safe please go read about priority inversion. Windows amd Mac OS schedulers have no real-time safe priority inversion prevention. Other platforms require special mutex flags. In addition, it is not safe to call any PortAudio API functions in the callback except as explicitly permitted in the documentation.
|
||||
|
||||
|
||||
Your callback function must return an int and accept the exact parameters specified in this typedef:
|
||||
|
||||
@@ -63,4 +67,4 @@ static int patestCallback( const void *inputBuffer, void *outputBuffer,
|
||||
|
||||
Previous: \ref tutorial_start | Next: \ref initializing_portaudio
|
||||
|
||||
*/
|
||||
*/
|
||||
|
||||
@@ -18,14 +18,23 @@ paHtmlDocDirectory = os.path.join( paRootDirectory, "doc", "html" )
|
||||
## This can be used as a first-level check to make sure the documentation is in order.
|
||||
##
|
||||
## The idea is to get a list of which files are missing doxygen documentation.
|
||||
##
|
||||
## How to run:
|
||||
## $ cd doc/utils
|
||||
## $ python checkfiledocs.py
|
||||
|
||||
def oneOf_a_in_b(a, b):
|
||||
for x in a:
|
||||
if x in b:
|
||||
return True
|
||||
return False
|
||||
|
||||
# recurse from top and return a list of all with the given
|
||||
# extensions. ignore .svn directories. return absolute paths
|
||||
def recursiveFindFiles( top, extensions, includePaths ):
|
||||
def recursiveFindFiles( top, extensions, dirBlacklist, includePaths ):
|
||||
result = []
|
||||
for (dirpath, dirnames, filenames) in os.walk(top):
|
||||
if not '.svn' in dirpath:
|
||||
if not oneOf_a_in_b(dirBlacklist, dirpath):
|
||||
for f in filenames:
|
||||
if os.path.splitext(f)[1] in extensions:
|
||||
if includePaths:
|
||||
@@ -41,8 +50,9 @@ def doxygenHtmlDocFileName( sourceFile ):
|
||||
return sourceFile.replace( '_', '__' ).replace( '.', '_8' ) + '.html'
|
||||
|
||||
|
||||
sourceFiles = recursiveFindFiles( paRootDirectory, [ '.c', '.h', '.cpp' ], True );
|
||||
docFiles = recursiveFindFiles( paHtmlDocDirectory, [ '.html' ], False );
|
||||
sourceFiles = recursiveFindFiles( os.path.join(paRootDirectory,'src'), [ '.c', '.h', '.cpp' ], ['.svn', 'mingw-include'], True );
|
||||
sourceFiles += recursiveFindFiles( os.path.join(paRootDirectory,'include'), [ '.c', '.h', '.cpp' ], ['.svn'], True );
|
||||
docFiles = recursiveFindFiles( paHtmlDocDirectory, [ '.html' ], ['.svn'], False );
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user