58 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
PortAudio Portable Real-Time Audio Library
45 | Copyright (c) 1999-2011 Ross Bencina, Phil Burk
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
47 |The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
48 |THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
49 |
50 |
The text above constitutes the entire PortAudio license; however, the PortAudio community also makes the following non-binding requests:
52 |Any person wishing to distribute modifications to the Software is requested to send the modifications to the original developer so that they can be incorporated into the canonical version. It is also requested that these non-binding requests be included along with the license above.
53 |
58 | 1.8.2
59 |
60 |
61 |
62 |
--------------------------------------------------------------------------------
/Documentation/html/bc_s.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/bc_s.png
--------------------------------------------------------------------------------
/Documentation/html/bdwn.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/bdwn.png
--------------------------------------------------------------------------------
/Documentation/html/classScopedPaHandler.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Public Member Functions | |
| 56 | PaError | result () const |
Definition at line 221 of file paex_sine_c++.cpp.
62 |
70 | 1.8.2
71 |
72 |
73 |
74 |
--------------------------------------------------------------------------------
/Documentation/html/classSine.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Public Member Functions | |
| 56 | bool | open (PaDeviceIndex index) |
| 59 | bool | close () |
| 62 | bool | start () |
| 65 | bool | stop () |
Definition at line 58 of file paex_sine_c++.cpp.
71 |
79 | 1.8.2
80 |
81 |
82 |
83 |
--------------------------------------------------------------------------------
/Documentation/html/classes.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
73 | 1.8.2
74 |
75 |
76 |
77 |
--------------------------------------------------------------------------------
/Documentation/html/closed.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/closed.png
--------------------------------------------------------------------------------
/Documentation/html/compile_cmake.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
This is a simple "How-to" for creating build files for Microsoft Visual C++ via CMake and the CMakeLists.txt file
45 |Both ASIO and DirectX SDK are automatically searched for by the CMake script, so if you have DirectX SDK installed and have placed the ASIO2 SDK according to point 2 above, you should be able to build portaudio with !DirectSound and ASIO support.
64 |Should you later on decide to change a portaudio option, just jump in at step 5 above (MSVC will then prompt you to reload projects/solutions/workspace)
65 |— Robert Bielik
66 |Back to the Tutorial: PortAudio Tutorials
67 |
72 | 1.8.2
73 |
74 |
75 |
76 |
--------------------------------------------------------------------------------
/Documentation/html/compile_linux.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
Note: this page has not been reviewed, and may contain errors.
45 |The OSS sound API is very old and not well supported. It is recommended that you use the ALSA sound API. The PortAudio configure script will look for the ALSA SDK. You can install the ALSA SDK on Ubuntu using:
48 |You might need to use yum, or some other package manager, instead of apt-get on your machine. If you do not install ALSA then you might get a message when testing that says you have no audio devices.
50 |You can find out more about ALSA here: http://www.alsa-project.org/
51 |You can build PortAudio in Linux Environments using the standard configure/make tools:
54 |That will build PortAudio using Jack, ALSA and OSS in whatever combination they are found on your system. For example, if you have Jack and OSS but not ALSA, it will build using Jack and OSS but not ALSA. This step also builds a number of tests, which can be found in the bin directory of PortAudio. It's a good idea to run some of these tests to make sure PortAudio is working correctly.
56 |To use PortAudio in your apps, you can simply install the .so files:
59 |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:
61 |On some systems you may need to use:
63 |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:
65 |Note that the ALSA PortAudio back-end adds a few extensions to the standard API that you may take advantage of. To use these functions be sure to include the pa_linux_alsa.h file found in the include file in the PortAudio folder. This file contains further documentation on the following functions:
69 |PaAlsaStreamInfo/PaAlsa_InitializeStreamInfo:: Objects of the !PaAlsaStreamInfo type may be used for the !hostApiSpecificStreamInfo attribute of a !PaStreamParameters object, in order to specify the name of an ALSA device to open directly. Specify the device via !PaAlsaStreamInfo.deviceString, after initializing the object with PaAlsa_InitializeStreamInfo.
70 |PaAlsa_EnableRealtimeScheduling:: PA ALSA supports real-time scheduling of the audio callback thread (using the FIFO pthread scheduling policy), via the extension PaAlsa_EnableRealtimeScheduling. Call this on the stream before starting it with the enableScheduling parameter set to true or false, to enable or disable this behaviour respectively.
71 |PaAlsa_GetStreamInputCard:: Use this function to get the ALSA-lib card index of the stream's input device.
72 |PaAlsa_GetStreamOutputCard:: Use this function to get the ALSA-lib card index of the stream's output device.
73 |Of particular importance is PaAlsa_EnableRealtimeScheduling, which allows ALSA to run at a high priority to prevent ordinary processes on the system from preempting audio playback. Without this, low latency audio playback will be irregular and will contain frequent drop-outs.
74 |Eliot Blennerhassett writes:
77 |On linux build, use e.g. "libtool gdb bin/patest_sine8" to debug that program. This is because on linux bin/patest_sine8 is a libtool shell script that wraps bin/.libs/patest_sine8 and allows it to find the appropriate libraries within the build tree.
78 |
83 | 1.8.2
84 |
85 |
86 |
87 |
--------------------------------------------------------------------------------
/Documentation/html/compile_windows_mingw.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
This document contains old or out-of-date information. Please see a draft of new MinGW information on our Wiki: PortAudio Wiki: Notes about building PortAudio with MinGW
47 |= MinGW/MSYS =
48 |From the [http://www.mingw.org MinGW projectpage]:
49 |MinGW: A collection of freely available and freely distributable Windows specific header files and import libraries, augmenting the GNU Compiler Collection, (GCC), and its associated tools, (GNU binutils). MinGW provides a complete Open Source programming tool set which is suitable for the development of native Windows programs that do not depend on any 3rd-party C runtime DLLs.
50 |MSYS: A Minimal SYStem providing a POSIX compatible Bourne shell environment, with a small collection of UNIX command line tools. Primarily developed as a means to execute the configure scripts and Makefiles used to build Open Source software, but also useful as a general purpose command line interface to replace Windows cmd.exe.
51 |MinGW provides a compiler/linker toolchain while MSYS is required to actually run the PortAudio configure script.
52 |Once MinGW and MSYS are installed (see the [http://www.mingw.org/MinGWiki MinGW-Wiki]) open an MSYS shell and run the famous:
53 |The above should create a working version though you might want to provide '–prefix=<path-to-install-dir>' to configure.
57 |'./configure –help' gives details as to what can be tinkered with.
58 |— Mikael Magnusson
59 |To update your copy or check out a fresh copy of the source
60 |[wiki:UsingThePortAudioSvnRepository SVN instructions]
61 |— Bob !McGwier
62 |Back to the Tutorial: PortAudio Tutorials
63 |
68 | 1.8.2
69 |
70 |
71 |
72 |
--------------------------------------------------------------------------------
/Documentation/html/deprecated.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
53 | 1.8.2
54 |
55 |
56 |
57 |
--------------------------------------------------------------------------------
/Documentation/html/doxygen.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/doxygen.png
--------------------------------------------------------------------------------
/Documentation/html/dynsections.js:
--------------------------------------------------------------------------------
1 | function toggleVisibility(linkObj)
2 | {
3 | var base = $(linkObj).attr('id');
4 | var summary = $('#'+base+'-summary');
5 | var content = $('#'+base+'-content');
6 | var trigger = $('#'+base+'-trigger');
7 | var src=$(trigger).attr('src');
8 | if (content.is(':visible')===true) {
9 | content.hide();
10 | summary.show();
11 | $(linkObj).addClass('closed').removeClass('opened');
12 | $(trigger).attr('src',src.substring(0,src.length-8)+'closed.png');
13 | } else {
14 | content.show();
15 | summary.hide();
16 | $(linkObj).removeClass('closed').addClass('opened');
17 | $(trigger).attr('src',src.substring(0,src.length-10)+'open.png');
18 | }
19 | return false;
20 | }
21 |
22 | function updateStripes()
23 | {
24 | $('table.directory tr').
25 | removeClass('even').filter(':visible:even').addClass('even');
26 | }
27 | function toggleLevel(level)
28 | {
29 | $('table.directory tr').each(function(){
30 | var l = this.id.split('_').length-1;
31 | var i = $('#img'+this.id.substring(3));
32 | var a = $('#arr'+this.id.substring(3));
33 | if (l|
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
Now that you have a good idea of how PortAudio works, you can try out the example programs. You'll find them in the examples/ directory in the PortAudio distribution.
45 |For an example of playing a sine wave, see examples/paex_sine.c.
46 |For an example of recording and playing back a sound, see examples/paex_record.c.
47 |I also encourage you to examine the source for the PortAudio libraries. If you have suggestions on ways to improve them, please let us know. If you want to implement PortAudio on a new platform, please let us know as well so we can coordinate people's efforts.
48 |Previous: Blocking Read/Write Functions | Next: This is the end of the tutorial.
49 |
54 | 1.8.2
55 |
56 |
57 |
58 |
--------------------------------------------------------------------------------
/Documentation/html/ftv2blank.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2blank.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2cl.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2cl.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2doc.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2doc.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2folderclosed.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2folderclosed.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2folderopen.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2folderopen.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2lastnode.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2lastnode.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2link.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2link.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2mlastnode.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2mlastnode.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2mnode.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2mnode.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2mo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2mo.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2node.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2node.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2ns.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2ns.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2plastnode.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2plastnode.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2pnode.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2pnode.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2splitbar.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2splitbar.png
--------------------------------------------------------------------------------
/Documentation/html/ftv2vertline.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/ftv2vertline.png
--------------------------------------------------------------------------------
/Documentation/html/globals_enum.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
81 | 1.8.2
82 |
83 |
84 |
85 |
--------------------------------------------------------------------------------
/Documentation/html/globals_eval.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
93 | 1.8.2
94 |
95 |
96 |
97 |
--------------------------------------------------------------------------------
/Documentation/html/globals_type.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
129 | 1.8.2
130 |
131 |
132 |
133 |
--------------------------------------------------------------------------------
/Documentation/html/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
PortAudio is a cross-platform, open-source C language library for real-time audio input and output. The library provides functions that allow your software to acquire and output real-time audio streams from your computer's hardware audio interfaces. It is designed to simplify writing cross-platform audio applications, and also to simplify the development of audio software in general by hiding the complexities of dealing directly with each native audio API. PortAudio is used to implement sound recording, editing and mixing applications, software synthesizers, effects processors, music players, internet telephony applications, software defined radios and more. Supported platforms include MS Windows, Mac OS X and Linux. Third-party language bindings make it possible to call PortAudio from other programming languages including Java, C++, C#, Python, PureBasic, FreePascal and Lazarus.
47 |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 check out the starter tickets.
99 |This documentation covers the current API version: PortAudio V19, API version 2.0. API 2.0 differs in a number of ways from previous versions (most often encountered in PortAudio V18), please consult the enhancement proposals for details of what was added/changed for V19: http://www.portaudio.com/docs/proposals/index.html
102 |
107 | 1.8.2
108 |
109 |
110 |
111 |
--------------------------------------------------------------------------------
/Documentation/html/initializing_portaudio.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
Before making any other calls to PortAudio, you 'must' call Pa_Initialize(). This will trigger a scan of available devices which can be queried later. Like most PA functions, it will return a result of type paError. If the result is not paNoError, then an error has occurred.
47 |You can get a text message that explains the error message by passing it to Pa_GetErrorText( err ). For Example:
50 |It is also important, when you are done with PortAudio, to Terminate it:
52 |Previous: Writing a Callback Function | Next: Opening a Stream Using Defaults
56 |
61 | 1.8.2
62 |
63 |
64 |
65 |
--------------------------------------------------------------------------------
/Documentation/html/modules.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
 Public API definitions for users of PortAudio | |
 Example programs demonstrating PortAudio usage |
55 | 1.8.2
56 |
57 |
58 |
59 |
--------------------------------------------------------------------------------
/Documentation/html/nav_f.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/nav_f.png
--------------------------------------------------------------------------------
/Documentation/html/nav_g.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/nav_g.png
--------------------------------------------------------------------------------
/Documentation/html/nav_h.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/nav_h.png
--------------------------------------------------------------------------------
/Documentation/html/open.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/open.png
--------------------------------------------------------------------------------
/Documentation/html/open_default_stream.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
The next step is to open a stream, which is similar to opening a file. You can specify whether you want audio input and/or output, how many channels, the data format, sample rate, etc. Opening a ''default'' stream means opening the default input and output devices, which saves you the trouble of getting a list of devices and choosing one from the list. (We'll see how to do that later.)
45 |The data structure and callback are described in Writing a Callback Function.
71 |The above example opens the stream for writing, which is sufficient for playback. It is also possible to open a stream for reading, to do recording, or both reading and writing, for simultaneous recording and playback or even real-time audio processing. If you plan to do playback and recording at the same time, open only one stream with valid input and output parameters.
72 |There are some caveats to note about simultaneous read/write:
73 |Previous: Initializing PortAudio | Next: Starting, Stopping and Aborting a Stream
81 |
86 | 1.8.2
87 |
88 |
89 |
90 |
--------------------------------------------------------------------------------
/Documentation/html/pa__devs_8c.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
List available devices, including device information. 58 | More...
59 | 63 |Go to the source code of this file.
64 |66 | Functions | |
| 68 | int | main (void) |
List available devices, including device information.
73 |@author Phil Burk http://www.softsynth.com 74 |
Definition in file pa_devs.c.
77 |
82 | 1.8.2
83 |
84 |
85 |
86 |
--------------------------------------------------------------------------------
/Documentation/html/pa__jack_8h.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
JACK-specific PortAudio API extension header file. 58 | More...
59 |#include "portaudio.h"Go to the source code of this file.
62 |64 | Functions | |
| PaError | PaJack_SetClientName (const char *name) |
| PaError | PaJack_GetClientName (const char **clientName) |
JACK-specific PortAudio API extension header file.
72 | 73 |Definition in file pa_jack.h.
74 || PaError PaJack_GetClientName | 81 |( | 82 |const char ** | 83 |clientName | ) | 84 |85 | |
Get the JACK client name used by PA JACK.
89 |The caller is responsible for freeing the returned pointer.
90 | 91 || PaError PaJack_SetClientName | 99 |( | 100 |const char * | 101 |name | ) | 102 |103 | |
Set the JACK client name.
107 |During Pa_Initialize, When PA JACK connects as a client of the JACK server, it requests a certain name, which is for instance prepended to port names. By default this name is "PortAudio". The JACK server may append a suffix to the client name, in order to avoid clashes among clients that try to connect with the same name (e.g., different PA JACK clients).
108 |This function must be called before Pa_Initialize, otherwise it won't have any effect. Note that the string is not copied, but instead referenced directly, so it must not be freed for as long as PA might need it.
109 |
118 | 1.8.2
119 |
120 |
121 |
122 |
--------------------------------------------------------------------------------
/Documentation/html/pa__win__ds_8h.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
DirectSound-specific PortAudio API extension header file. 60 | More...
61 | 64 |Go to the source code of this file.
65 |67 | Data Structures | |
| struct | PaWinDirectSoundStreamInfo |
72 | Macros | |
| 74 | #define | paWinDirectSoundUseLowLevelLatencyParameters (0x01) |
| 77 | #define | paWinDirectSoundUseChannelMask (0x04) |
81 | Typedefs | |
|
83 | typedef struct 84 | PaWinDirectSoundStreamInfo | PaWinDirectSoundStreamInfo |
DirectSound-specific PortAudio API extension header file.
89 | 90 |Definition in file pa_win_ds.h.
91 |
96 | 1.8.2
97 |
98 |
99 |
100 |
--------------------------------------------------------------------------------
/Documentation/html/paex__saw_8c.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
Play a simple (aliasing) sawtooth wave. 60 | More...
61 | 65 |Go to the source code of this file.
66 |68 | Data Structures | |
| struct | paTestData |
73 | Macros | |
| 75 | #define | NUM_SECONDS (4) |
| 78 | #define | SAMPLE_RATE (44100) |
82 | Functions | |
| 84 | int | main (void) |
Play a simple (aliasing) sawtooth wave.
89 | 90 | 91 |Definition in file paex_saw.c.
92 |
97 | 1.8.2
98 |
99 |
100 |
101 |
--------------------------------------------------------------------------------
/Documentation/html/paex__write__sine_8c.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
Play a sine wave for several seconds using the blocking API (Pa_WriteStream()) 59 | More...
60 | 64 |Go to the source code of this file.
65 |67 | Macros | |
| 69 | #define | NUM_SECONDS (5) |
| 72 | #define | SAMPLE_RATE (44100) |
| 75 | #define | FRAMES_PER_BUFFER (1024) |
| 78 | #define | M_PI (3.14159265) |
| 81 | #define | TABLE_SIZE (200) |
85 | Functions | |
| 87 | int | main (void) |
Play a sine wave for several seconds using the blocking API (Pa_WriteStream())
92 |@author Ross Bencina <rossb@audiomulch.com> 93 |94 | 95 |
Definition in file paex_write_sine.c.
96 |
101 | 1.8.2
102 |
103 |
104 |
105 |
--------------------------------------------------------------------------------
/Documentation/html/paex__write__sine__nonint_8c.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
Play a non-interleaved sine wave using the blocking API (Pa_WriteStream()) 59 | More...
60 | 64 |Go to the source code of this file.
65 |67 | Macros | |
| 69 | #define | NUM_SECONDS (5) |
| 72 | #define | SAMPLE_RATE (44100) |
| 75 | #define | FRAMES_PER_BUFFER (1024) |
| 78 | #define | M_PI (3.14159265) |
| 81 | #define | TABLE_SIZE (200) |
85 | Functions | |
| 87 | int | main (void) |
Play a non-interleaved sine wave using the blocking API (Pa_WriteStream())
92 |@author Ross Bencina <rossb@audiomulch.com> 93 |94 | 95 |
Definition in file paex_write_sine_nonint.c.
96 |
101 | 1.8.2
102 |
103 |
104 |
105 |
--------------------------------------------------------------------------------
/Documentation/html/pages.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
| PortAudio API Overview | |
| PortAudio License | |
| Blocking Read/Write Functions | |
| Creating MSVC Build Files via CMake | |
| Building Portaudio for Linux | |
| Building Portaudio for Mac OS X | |
| Building PortAudio for Windows using Microsoft Visual Studio | |
| Building Portaudio for Windows with ASIO support using MSVC | |
| Building Portaudio for Windows with MinGW | |
| Exploring PortAudio | |
| Initializing PortAudio | |
| Opening a Stream Using Defaults | |
| Enumerating and Querying PortAudio Devices | |
| Starting, Stopping and Aborting a Stream | |
| Closing a Stream and Terminating PortAudio | |
| PortAudio Tutorials | |
| Utility Functions | |
| Writing a Callback Function | |
| Deprecated List |
72 | 1.8.2
73 |
74 |
75 |
76 |
--------------------------------------------------------------------------------
/Documentation/html/portaudio-external-architecture-diagram.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/portaudio-external-architecture-diagram.png
--------------------------------------------------------------------------------
/Documentation/html/start_stop_abort.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
PortAudio will not start playing back audio until you start the stream. After calling Pa_StartStream(), PortAudio will start calling your callback function to perform the audio processing.
47 |You can communicate with your callback routine through the data structure you passed in on the open call, or through global variables, or using other interprocess communication techniques, but please be aware that your callback function may be called at interrupt time when your foreground process is least expecting it. So avoid sharing complex data structures that are easily corrupted like double linked lists, and avoid using locks such as mutexs as this may cause your callback function to block and therefore drop audio. Such techniques may even cause deadlock on some platforms.
50 |PortAudio will continue to call your callback and process audio until you stop the stream. This can be done in one of several ways, but, before we do so, we'll want to see that some of our audio gets processed by sleeping for a few seconds. This is easy to do with Pa_Sleep(), which is used by many of the examples in the patests/ directory for exactly this purpose. Note that, for a variety of reasons, you can not rely on this function for accurate scheduling, so your stream may not run for exactly the same amount of time as you expect, but it's good enough for our example.
51 |Now we need to stop playback. There are several ways to do this, the simplest of which is to call Pa_StopStream():
54 |Pa_StopStream() is designed to make sure that the buffers you've processed in your callback are all played, which may cause some delay. Alternatively, you could call Pa_AbortStream(). On some platforms, aborting the stream is much faster and may cause some data processed by your callback not to be played.
57 |Another way to stop the stream is to return either paComplete, or paAbort from your callback. paComplete ensures that the last buffer is played whereas paAbort stops the stream as soon as possible. If you stop the stream using this technique, you will need to call Pa_StopStream() before starting the stream again.
58 |Previous: Opening a Stream Using Defaults | Next: Closing a Stream and Terminating PortAudio
59 |
64 | 1.8.2
65 |
66 |
67 |
68 |
--------------------------------------------------------------------------------
/Documentation/html/structBiQuad.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Data Fields | |
| 56 | float | bq_b0 |
| 59 | float | bq_b1 |
| 62 | float | bq_b2 |
| 65 | float | bq_a1 |
| 68 | float | bq_a2 |
Definition at line 83 of file paex_ocean_shore.c.
74 |
82 | 1.8.2
83 |
84 |
85 |
86 |
--------------------------------------------------------------------------------
/Documentation/html/structPaAlsaStreamInfo.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Data Fields | |
| 56 | unsigned long | size |
| 59 | PaHostApiTypeId | hostApiType |
| 62 | unsigned long | version |
| 65 | const char * | deviceString |
Definition at line 53 of file pa_linux_alsa.h.
71 |
79 | 1.8.2
80 |
81 |
82 |
83 |
--------------------------------------------------------------------------------
/Documentation/html/structPaAsioStreamInfo.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Data Fields | |
| unsigned long | size |
| PaHostApiTypeId | hostApiType |
| unsigned long | version |
| 62 | unsigned long | flags |
| 65 | int * | channelSelectors |
| PaHostApiTypeId PaAsioStreamInfo::hostApiType | 78 |
| unsigned long PaAsioStreamInfo::size | 93 |
| unsigned long PaAsioStreamInfo::version | 108 |
125 | 1.8.2
126 |
127 |
128 |
129 |
--------------------------------------------------------------------------------
/Documentation/html/structPaHostErrorInfo.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
#include <portaudio.h>
56 | Data Fields | |
| PaHostApiTypeId | hostApiType |
| long | errorCode |
| const char * | errorText |
Structure used to return information about a host error condition.
66 | 67 |Definition at line 389 of file portaudio.h.
68 || long PaHostErrorInfo::errorCode | 75 |
the error code returned
79 | 80 |Definition at line 391 of file portaudio.h.
81 | 82 || const char* PaHostErrorInfo::errorText | 90 |
a textual description of the error if available, otherwise a zero-length string
94 | 95 |Definition at line 392 of file portaudio.h.
96 | 97 || PaHostApiTypeId PaHostErrorInfo::hostApiType | 105 |
the host API which returned the error code
109 | 110 |Definition at line 390 of file portaudio.h.
111 | 112 |
122 | 1.8.2
123 |
124 |
125 |
126 |
--------------------------------------------------------------------------------
/Documentation/html/structPaVersionInfo.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
#include <portaudio.h>
56 | Data Fields | |
| 58 | int | versionMajor |
| 61 | int | versionMinor |
| 64 | int | versionSubMinor |
| const char * | versionControlRevision |
| const char * | versionText |
A structure containing PortAudio API version information.
73 |Definition at line 90 of file portaudio.h.
77 || const char* PaVersionInfo::versionControlRevision | 84 |
This is currently the Git revision hash but may change in the future. The versionControlRevision is updated by running a script before compiling the library. If the update does not occur, this value may refer to an earlier revision.
88 | 89 |Definition at line 99 of file portaudio.h.
90 | 91 || const char* PaVersionInfo::versionText | 99 |
Version as a string, for example "PortAudio V19.5.0-devel, revision 1952M"
103 | 104 |Definition at line 101 of file portaudio.h.
105 | 106 |
116 | 1.8.2
117 |
118 |
119 |
120 |
--------------------------------------------------------------------------------
/Documentation/html/structPaWDMKSSpecificStreamInfo.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Data Fields | |
| 56 | PaWDMKSDirectionSpecificStreamInfo | input |
| 59 | PaWDMKSDirectionSpecificStreamInfo | output |
Definition at line 128 of file pa_win_wdmks.h.
65 |
73 | 1.8.2
74 |
75 |
76 |
77 |
--------------------------------------------------------------------------------
/Documentation/html/structPaWasapiJackDescription.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Data Fields | |
| 56 | unsigned long | channelMapping |
| 59 | unsigned long | color |
| 62 | PaWasapiJackConnectionType | connectionType |
| 65 | PaWasapiJackGeoLocation | geoLocation |
| 68 | PaWasapiJackGenLocation | genLocation |
| 71 | PaWasapiJackPortConnection | portConnection |
| 74 | unsigned int | isConnected |
Definition at line 192 of file pa_win_wasapi.h.
80 |
88 | 1.8.2
89 |
90 |
91 |
92 |
--------------------------------------------------------------------------------
/Documentation/html/structPaWinMmeDeviceAndChannelCount.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Data Fields | |
| 56 | PaDeviceIndex | device |
| 59 | int | channelCount |
Definition at line 76 of file pa_win_wmme.h.
65 |
73 | 1.8.2
74 |
75 |
76 |
77 |
--------------------------------------------------------------------------------
/Documentation/html/structPaWinWDMKSDeviceInfo.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Data Fields | |
| wchar_t | filterPath [MAX_PATH] |
| wchar_t | topologyPath [MAX_PATH] |
| 60 | PaWDMKSType | streamingType |
| GUID | deviceProductGuid |
Definition at line 111 of file pa_win_wdmks.h.
68 || GUID PaWinWDMKSDeviceInfo::deviceProductGuid | 75 |
The product GUID of the device (if supported)
79 | 80 |Definition at line 115 of file pa_win_wdmks.h.
81 | 82 || wchar_t PaWinWDMKSDeviceInfo::filterPath[MAX_PATH] | 90 |
KS filter path in Unicode!
94 | 95 |Definition at line 112 of file pa_win_wdmks.h.
96 | 97 || wchar_t PaWinWDMKSDeviceInfo::topologyPath[MAX_PATH] | 105 |
Topology filter path in Unicode!
109 | 110 |Definition at line 113 of file pa_win_wdmks.h.
111 | 112 |
122 | 1.8.2
123 |
124 |
125 |
126 |
--------------------------------------------------------------------------------
/Documentation/html/structPaWinWaveFormat.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Data Fields | |
| 56 | unsigned char | fields [PAWIN_SIZEOF_WAVEFORMATEXTENSIBLE] |
| 59 | unsigned long | extraLongForAlignment |
Definition at line 139 of file pa_win_waveformat.h.
65 |
73 | 1.8.2
74 |
75 |
76 |
77 |
--------------------------------------------------------------------------------
/Documentation/html/structPinkNoise.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
54 | Data Fields | |
| 56 | long | pink_Rows [PINK_MAX_RANDOM_ROWS] |
| 59 | long | pink_RunningSum |
| 62 | int | pink_Index |
| 65 | int | pink_IndexMask |
| 68 | float | pink_Scalar |
Definition at line 73 of file paex_ocean_shore.c.
74 |
83 | 1.8.2
84 |
85 |
86 |
87 |
--------------------------------------------------------------------------------
/Documentation/html/sync_off.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/sync_off.png
--------------------------------------------------------------------------------
/Documentation/html/sync_on.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/sync_on.png
--------------------------------------------------------------------------------
/Documentation/html/tab_a.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/tab_a.png
--------------------------------------------------------------------------------
/Documentation/html/tab_b.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/tab_b.png
--------------------------------------------------------------------------------
/Documentation/html/tab_h.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/tab_h.png
--------------------------------------------------------------------------------
/Documentation/html/tab_s.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Documentation/html/tab_s.png
--------------------------------------------------------------------------------
/Documentation/html/tabs.css:
--------------------------------------------------------------------------------
1 | .tabs, .tabs2, .tabs3 {
2 | background-image: url('tab_b.png');
3 | width: 100%;
4 | z-index: 101;
5 | font-size: 13px;
6 | font-family: 'Lucida Grande',Geneva,Helvetica,Arial,sans-serif;
7 | }
8 |
9 | .tabs2 {
10 | font-size: 10px;
11 | }
12 | .tabs3 {
13 | font-size: 9px;
14 | }
15 |
16 | .tablist {
17 | margin: 0;
18 | padding: 0;
19 | display: table;
20 | }
21 |
22 | .tablist li {
23 | float: left;
24 | display: table-cell;
25 | background-image: url('tab_b.png');
26 | line-height: 36px;
27 | list-style: none;
28 | }
29 |
30 | .tablist a {
31 | display: block;
32 | padding: 0 20px;
33 | font-weight: bold;
34 | background-image:url('tab_s.png');
35 | background-repeat:no-repeat;
36 | background-position:right;
37 | color: #283A5D;
38 | text-shadow: 0px 1px 1px rgba(255, 255, 255, 0.9);
39 | text-decoration: none;
40 | outline: none;
41 | }
42 |
43 | .tabs3 .tablist a {
44 | padding: 0 10px;
45 | }
46 |
47 | .tablist a:hover {
48 | background-image: url('tab_h.png');
49 | background-repeat:repeat-x;
50 | color: #fff;
51 | text-shadow: 0px 1px 1px rgba(0, 0, 0, 1.0);
52 | text-decoration: none;
53 | }
54 |
55 | .tablist li.current a {
56 | background-image: url('tab_a.png');
57 | background-repeat:repeat-x;
58 | color: #fff;
59 | text-shadow: 0px 1px 1px rgba(0, 0, 0, 1.0);
60 | }
61 |
--------------------------------------------------------------------------------
/Documentation/html/terminating_portaudio.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
When you are done with a stream, you should close it to free up resources:
45 |We've already mentioned this in Initializing PortAudio, but in case you forgot, be sure to terminate PortAudio when you are done:
48 |Previous: Starting, Stopping and Aborting a Stream | Next: Utility Functions
51 |
56 | 1.8.2
57 |
58 |
59 |
60 |
--------------------------------------------------------------------------------
/Documentation/html/tutorial_start.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | |
19 | PortAudio
20 | 2.0
21 |
22 | |
23 |
These tutorials takes you through a hands-on example of using PortAudio to make sound. If you'd prefer to start with a top-down overview of the PortAudio API, check out the PortAudio API Overview.
45 |First thing you need to do is download the PortAudio source code either as a tarball from the website, or from the Subversion Repository.
48 |Once you've downloaded PortAudio you'll need to compile it, which of course, depends on your environment:
51 |Many platforms with GCC/make can use the simple ./configure && make combination and simply use the resulting libraries in their code.
69 |Below are the steps to writing a PortAudio application using the callback technique:
72 |In addition to this "Callback" architecture, V19 also supports a "Blocking I/O" model which uses read and write calls which may be more familiar to non-audio programmers. Note that at this time, not all APIs support this functionality.
81 |In this tutorial, we'll show how to use the callback architecture to play a sawtooth wave. Much of the tutorial is taken from the file paex_saw.c, which is part of the PortAudio distribution. When you're done with this tutorial, you'll be armed with the basic knowledge you need to write an audio program. If you need more sample code, look in the "examples" and "test" directory of the PortAudio distribution. Another great source of info is the portaudio.h Doxygen page, which documents the entire V19 API. Also see the page for tips on programming PortAudio on the PortAudio wiki.
82 |If you are upgrading from V18, you may want to look at the Proposed Enhancements to PortAudio, which describes the differences between V18 and V19.
95 |Once you have a basic understanding of how to use PortAudio, you might be interested in Exploring PortAudio.
96 | 97 |
102 | 1.8.2
103 |
104 |
105 |
106 |
--------------------------------------------------------------------------------
/Examples/pa_devs/Project1.res:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Examples/pa_devs/Project1.res
--------------------------------------------------------------------------------
/Examples/paex_basic/Project1.dpr:
--------------------------------------------------------------------------------
1 | program Project1;
2 |
3 | {$APPTYPE CONSOLE}
4 |
5 | {$R *.res}
6 |
7 | uses
8 | System.SysUtils,
9 | portaudio in '..\..\Include\portaudio.pas';
10 |
11 | var
12 | i : integer;
13 | LPaHostApiCount: integer;
14 | LPaHostApiInfo: PPaHostApiInfo;
15 | LPaError : TPaError;
16 | begin
17 | try
18 | WriteLn('PA version int: ', IntToStr(Pa_GetVersion));
19 | WriteLn('PA version text: ', Pa_GetVersionText);
20 |
21 | // init PA
22 | LPaError := Pa_Initialize;
23 | try
24 | WriteLn('Doing PA init: ', Pa_GetErrorText(LPaError));
25 |
26 | // print some system information provided by PA
27 | LPaHostApiCount := Pa_GetHostApiCount;
28 | WriteLn('Host API count (OK if positive): ', IntToStr(LPaHostApiCount));
29 | WriteLn('Default host API: ', IntToStr(Pa_GetDefaultHostApi));
30 |
31 | for i := 0 to (LPaHostApiCount-1) do begin
32 | LPaHostApiInfo := Pa_GetHostApiInfo ( i );
33 | WriteLn('Found host API ', i, ' which is ', UTF8String(LPaHostApiInfo^.name),
34 | ' (devices: ', IntToStr(LPaHostApiInfo^.deviceCount), ')');
35 | end;
36 |
37 | WriteLn('Default output device: ', IntToStr(Pa_GetDefaultOutputDevice));
38 |
39 | finally
40 | LPaError := Pa_Terminate;
41 | // end all PA activity
42 | WriteLn('Doing PA termination: ' + Pa_GetErrorText(LPaError));
43 | end;
44 |
45 | except
46 | on E: Exception do
47 | Writeln(E.ClassName, ': ', E.Message);
48 | end;
49 | readln;
50 | end.
51 |
--------------------------------------------------------------------------------
/Examples/paex_basic/Project1.res:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Examples/paex_basic/Project1.res
--------------------------------------------------------------------------------
/Examples/paex_saw/Project1.dpr:
--------------------------------------------------------------------------------
1 | (** @file paex_saw.c
2 | @ingroup examples_src
3 | @brief Play a simple (aliasing) sawtooth wave.
4 | @author Phil Burk http://www.softsynth.com
5 | *)
6 | (*
7 | * $Id$
8 | *
9 | * This program uses the PortAudio Portable Audio Library.
10 | * For more information see: http://www.portaudio.com
11 | * Copyright (c) 1999-2000 Ross Bencina and Phil Burk
12 | *
13 | * Permission is hereby granted, free of charge, to any person obtaining
14 | * a copy of this software and associated documentation files
15 | * (the "Software"), to deal in the Software without restriction,
16 | * including without limitation the rights to use, copy, modify, merge,
17 | * publish, distribute, sublicense, and/or sell copies of the Software,
18 | * and to permit persons to whom the Software is furnished to do so,
19 | * subject to the following conditions:
20 | *
21 | * The above copyright notice and this permission notice shall be
22 | * included in all copies or substantial portions of the Software.
23 | *
24 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
25 | * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
26 | * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
27 | * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
28 | * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
29 | * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
30 | * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
31 | *)
32 |
33 | (*
34 | * The text above constitutes the entire PortAudio license; however,
35 | * the PortAudio community also makes the following non-binding requests:
36 | *
37 | * Any person wishing to distribute modifications to the Software is
38 | * requested to send the modifications to the original developer so that
39 | * they can be incorporated into the canonical version. It is also
40 | * requested that these non-binding requests be included along with the
41 | * license above.
42 | *)
43 |
44 | program Project1;
45 |
46 | {$APPTYPE CONSOLE}
47 |
48 | {$R *.res}
49 |
50 | uses
51 | System.SysUtils,
52 | System.Math,
53 | portaudio in '..\..\Include\portaudio.pas';
54 |
55 | const
56 | NUM_SECONDS = 4;
57 | SAMPLE_RATE = 44100;
58 |
59 |
60 |
type
61 | PPaTestData = ^TPaTestData;
62 | TPaTestData = record
63 | left_phase : double;
64 | right_phase : double;
65 | end;
66 |
67 | var
68 | LPaStream : PPaStream;
69 | LPaError : TPaError;
70 | Data : TPaTestData;
71 |
72 | (* This routine will be called by the PortAudio engine when audio is needed.
73 | ** It may called at interrupt level on some machines so don't do anything
74 | ** that could mess up the system like calling malloc() or free().
75 | *)
76 | function PaTestCallback(inputBuffer : pointer; OutputBuffer : pointer;
77 | framesPerBuffer : longword; timeInfo : PPaStreamCallbackTimeInfo;
78 | statusFlags : TPaStreamCallbackFlags; UserData : pointer) : integer;
79 | cdecl;
80 | var
81 | OutBuffer : PDouble;
82 | i : integer;
83 | data : PPaTestData;
84 | begin
85 | OutBuffer := PDouble(OutputBuffer);
86 | data := PPaTestData(UserData);
87 |
88 | // Fill the buffer...
89 | for i := 0 to (FramesPerBuffer-1) do
90 | begin
91 | OutBuffer^ := data^.left_phase;
92 | Inc(OutBuffer);
93 |
94 | OutBuffer^ := data^.right_phase;
95 | Inc(OutBuffer);
96 |
97 | data^.left_phase := data^.left_phase + 0.1;
98 | if (data^.left_phase >= 1.0 ) then data^.left_phase := data^.left_phase - 2.0;
99 |
100 | data^.right_phase := data^.right_phase + 0.3;
101 | if ( data^.right_phase >= 1.0 ) then data^.right_phase := data^.right_phase - 2.0;
102 | end;
103 |
104 | result := paContinue;
105 | end;
106 |
107 | procedure Error;
108 | begin
109 | Pa_Terminate();
110 | WriteLn('An error occured while using the portaudio Stream');
111 | WriteLn('Error number: ', LPaError );
112 | WriteLn('Error message: ', Pa_GetErrorText(LPaError));
113 | halt;
114 | end;
115 |
116 |
117 | begin
118 | try
119 | WriteLn('PortAudio Test: output sawtooth wave.');
120 |
121 | Data.left_phase := 0;
122 | Data.right_phase := 0;
123 |
124 | LPaError := Pa_Initialize;
125 | if not LPaError = 0 then Error;
126 |
127 | LPaError := Pa_OpenDefaultStream(LPaStream, 0, 2, paFloat32, SAMPLE_RATE, 256, @PaTestCallback, @Data);
128 | if not LPaError = 0 then Error;
129 |
130 | LPaError := Pa_StartStream(LPaStream);
131 | if not LPaError = 0 then Error;
132 |
133 | Pa_Sleep(NUM_SECONDS * 1000 );
134 |
135 | LPaError := Pa_StopStream(LPaStream);
136 | if not LPaError = 0 then Error;
137 |
138 | LPaError := Pa_CloseStream(LPaStream);
139 | if not LPaError = 0 then Error;
140 |
141 | Pa_Terminate;
142 | WriteLn('Test finished.');
143 | except
144 | on E: Exception do
145 | Writeln(E.ClassName, ': ', E.Message);
146 | end;
147 | readln;
148 | end.
149 |
--------------------------------------------------------------------------------
/Examples/paex_saw/Project1.res:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/DelphiForBroadcasting/portaudio-delphi/de957923e704f1466dbab1ccdcad6906ec6f6901/Examples/paex_saw/Project1.res
--------------------------------------------------------------------------------
/Examples/paex_sine/Project1.dpr:
--------------------------------------------------------------------------------
1 | (** @file paex_sine.c
2 | @ingroup examples_src
3 | @brief Play a sine wave for several seconds.
4 | @author Ross Bencina