<pre style='margin:0'>

Ryan Schmidt (ryandesign) pushed a commit to branch master

in repository macports-ports.

</pre>

<p><a href="https://github.com/macports/macports-ports/commit/9363797c5a7c2e4b945bfbfc78c250caa5bd53a3">https://github.com/macports/macports-ports/commit/9363797c5a7c2e4b945bfbfc78c250caa5bd53a3</a></p>

<pre style="white-space: pre; background: #F8F8F8">The following commit(s) were added to refs/heads/master by this push:

<span style='display:block; white-space:pre;color:#404040;'>     new 9363797c5a7 espeak: Simplify how portaudio.h is updated

</span>9363797c5a7 is described below

<span style='display:block; white-space:pre;color:#808000;'>commit 9363797c5a7c2e4b945bfbfc78c250caa5bd53a3

</span>Author: Ryan Schmidt <ryandesign@macports.org>

AuthorDate: Sat Jun 27 07:52:36 2020 -0500

<span style='display:block; white-space:pre;color:#404040;'>    espeak: Simplify how portaudio.h is updated

</span><span style='display:block; white-space:pre;color:#404040;'>    

</span><span style='display:block; white-space:pre;color:#404040;'>    The enormous portaudio.h patch was just replacing portaudio.h with

<span style='display:block; white-space:pre;color:#404040;'>    portaudio19.h so remove that patch and just copy the file.

</span><span style='display:block; white-space:pre;color:#404040;'>    

</span><span style='display:block; white-space:pre;color:#404040;'>    See #7507

</span>---

 audio/espeak/Portfile                    |    8 +-

 audio/espeak/files/patch-espeak-mac.diff | 1414 ------------------------------

 2 files changed, 6 insertions(+), 1416 deletions(-)

<span style='display:block; white-space:pre;color:#808080;'>diff --git a/audio/espeak/Portfile b/audio/espeak/Portfile

</span><span style='display:block; white-space:pre;color:#808080;'>index f2b5502b87b..03a76de0174 100644

</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/audio/espeak/Portfile

</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/audio/espeak/Portfile

</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -26,6 +26,12 @@ checksums           rmd160  95f45d86c86756c3bd3b359aaba3c844f4a1c23c \

</span>                     sha256  bf9a17673adffcc28ff7ea18764f06136547e97bbd9edf2ec612f09b207f0659 \

                     size    3019245

<span style='display:block; white-space:pre;background:#e0ffe0;'>+build.dir           ${worksrcpath}/src

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+pre-patch {

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    copy -force ${build.dir}/portaudio19.h ${build.dir}/portaudio.h

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+}

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+

</span> patchfiles          patch-espeak-mac.diff

 if {${os.platform} eq "darwin" && ${os.major} >= 10} {

<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -36,8 +42,6 @@ if {${os.platform} eq "darwin" && ${os.major} >= 10} {

</span> compiler.cxx_standard 1998

 configure.cxxflags-append -std=c++98

<span style='display:block; white-space:pre;background:#ffe0e0;'>-build.dir           ${worksrcpath}/src

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-

</span> makefile.override   PREFIX

 build.args          DATADIR=${prefix}/share/espeak-data

<span style='display:block; white-space:pre;color:#808080;'>diff --git a/audio/espeak/files/patch-espeak-mac.diff b/audio/espeak/files/patch-espeak-mac.diff

</span><span style='display:block; white-space:pre;color:#808080;'>index a7e7bb10afb..4a3809a1ec0 100644

</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/audio/espeak/files/patch-espeak-mac.diff

</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/audio/espeak/files/patch-espeak-mac.diff

</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -77,1420 +77,6 @@

</span>   # Install development headers

        $(INSTALL) -pm 644 speak_lib.h $(DESTDIR)$(INCDIR)

        # Install data files

<span style='display:block; white-space:pre;background:#ffe0e0;'>---- src/portaudio.h.orig        2014-03-04 10:47:15.000000000 -0600

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+++ src/portaudio.h        2020-06-26 14:07:39.000000000 -0500

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-@@ -1,21 +1,14 @@

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--// NOTE: Copy this file to  portaudio.h  in order to compile with V18 portaudio

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#ifndef PORT_AUDIO_H

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define PORT_AUDIO_H

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#ifdef __cplusplus

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--extern "C"

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--{

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#endif /* __cplusplus */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+// NOTE: Copy this file to  portaudio.h  in order to compile with V19 portaudio

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#ifndef PORTAUDIO_H

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define PORTAUDIO_H

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- /*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- * $Id: portaudio.h,v 1.5 2002/03/26 18:04:22 philburk Exp $

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ * $Id: portaudio.h 1061 2006-06-19 22:46:41Z lschwardt $

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  * PortAudio Portable Real-Time Audio Library

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  * PortAudio API Header File

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- * Latest version available at: http://www.audiomulch.com/portaudio/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ * Latest version available at: http://www.portaudio.com/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  *

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- * Copyright (c) 1999-2000 Ross Bencina and Phil Burk

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ * Copyright (c) 1999-2002 Ross Bencina and Phil Burk

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  *

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  * Permission is hereby granted, free of charge, to any person obtaining

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  * a copy of this software and associated documentation files

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-@@ -39,17 +32,45 @@

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION

<span style='display:block; white-space:pre;background:#ffe0e0;'>-  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- *

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** @file

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @brief The PortAudio API.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#ifdef __cplusplus

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+extern "C"

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+{

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#endif /* __cplusplus */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve the release number of the currently running PortAudio build,

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ eg 1900.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+int Pa_GetVersion( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve a textual description of the current PortAudio build,

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ eg "PortAudio V19-devel 13 October 2002".

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+const char* Pa_GetVersionText( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Error codes returned by PortAudio functions.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Note that with the exception of paNoError, all PaErrorCodes are negative.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- typedef int PaError;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--typedef enum {

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef enum PaErrorCode

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+{

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     paNoError = 0,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    paHostError = -10000,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paNotInitialized = -10000,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paUnanticipatedHostError,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     paInvalidChannelCount,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     paInvalidSampleRate,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    paInvalidDeviceId,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paInvalidDevice,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     paInvalidFlag,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     paSampleFormatNotSupported,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     paBadIODeviceCombination,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-@@ -60,407 +81,1047 @@

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     paBadStreamPtr,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     paTimedOut,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     paInternalError,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    paDeviceUnavailable

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--} PaErrorNum;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paDeviceUnavailable,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paIncompatibleHostApiSpecificStreamInfo,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paStreamIsStopped,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paStreamIsNotStopped,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paInputOverflowed,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paOutputUnderflowed,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paHostApiNotFound,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paInvalidHostApi,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paCanNotReadFromACallbackStream,      /**< @todo review error code name */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paCanNotWriteToACallbackStream,       /**< @todo review error code name */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paCanNotReadFromAnOutputOnlyStream,   /**< @todo review error code name */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paCanNotWriteToAnInputOnlyStream,     /**< @todo review error code name */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paIncompatibleStreamHostApi,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paBadBufferPtr

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+} PaErrorCode;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Translate the supplied PortAudio error code into a human readable

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ message.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+const char *Pa_GetErrorText( PaError errorCode );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Library initialization function - call this before using PortAudio.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ This function initialises internal data structures and prepares underlying

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ host APIs for use. This function MUST be called before using any other

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PortAudio API functions.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ If Pa_Initialize() is called multiple times, each successful 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ call must be matched with a corresponding call to Pa_Terminate(). 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pairs of calls to Pa_Initialize()/Pa_Terminate() may overlap, and are not 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ required to be fully nested.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_Initialize() is the library initialisation function - call this before

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- using the library.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Note that if Pa_Initialize() returns an error code, Pa_Terminate() should

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ NOT be called.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return paNoError if successful, otherwise an error code indicating the cause

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ of failure.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_Terminate

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- PaError Pa_Initialize( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_Terminate() is the library termination function - call this after

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- using the library.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--*/

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Library termination function - call this when finished using PortAudio.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ This function deallocates all resources allocated by PortAudio since it was

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ initializied by a call to Pa_Initialize(). In cases where Pa_Initialise() has

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ been called multiple times, each call must be matched with a corresponding call

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ to Pa_Terminate(). The final matching call to Pa_Terminate() will automatically

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ close any PortAudio streams that are still open.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pa_Terminate() MUST be called before exiting a program which uses PortAudio.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Failure to do so may result in serious resource leaks, such as audio devices

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ not being available until the next reboot.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return paNoError if successful, otherwise an error code indicating the cause

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ of failure.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_Initialize

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- PaError Pa_Terminate( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_GetHostError() returns a host specific error code.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- This can be called after receiving a PortAudio error code of paHostError.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** The type used to refer to audio devices. Values of this type usually

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ range from 0 to (Pa_DeviceCount-1), and may also take on the PaNoDevice

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ and paUseHostApiSpecificDeviceSpecification values.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_DeviceCount, paNoDevice, paUseHostApiSpecificDeviceSpecification

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef int PaDeviceIndex;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--long Pa_GetHostError( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_GetErrorText() translates the supplied PortAudio error number

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- into a human readable message.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** A special PaDeviceIndex value indicating that no device is available,

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ or should be used.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaDeviceIndex

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paNoDevice ((PaDeviceIndex)-1)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--const char *Pa_GetErrorText( PaError errnum );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Sample formats

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- These are formats used to pass sound data between the callback and the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- stream. Each device has a "native" format which may be used when optimum

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- efficiency or control over conversion is required.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Formats marked "always available" are supported (emulated) by all 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- PortAudio implementations.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- The floating point representation (paFloat32) uses +1.0 and -1.0 as the 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- maximum and minimum respectively.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** A special PaDeviceIndex value indicating that the device(s) to be used

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ are specified in the host api specific stream info structure.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- paUInt8 is an unsigned 8 bit format where 128 is considered "ground"

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaDeviceIndex

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paUseHostApiSpecificDeviceSpecification ((PaDeviceIndex)-2)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/* Host API enumeration mechanism */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** The type used to enumerate to host APIs at runtime. Values of this type

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ range from 0 to (Pa_GetHostApiCount()-1).

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_GetHostApiCount

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef int PaHostApiIndex;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--typedef unsigned long PaSampleFormat;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define paFloat32      ((PaSampleFormat) (1<<0)) /*always available*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define paInt16        ((PaSampleFormat) (1<<1)) /*always available*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define paInt32        ((PaSampleFormat) (1<<2)) /*always available*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define paInt24        ((PaSampleFormat) (1<<3))

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define paPackedInt24  ((PaSampleFormat) (1<<4))

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define paInt8         ((PaSampleFormat) (1<<5))

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define paUInt8        ((PaSampleFormat) (1<<6))

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define paCustomFormat ((PaSampleFormat) (1<<16))

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Device enumeration mechanism.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Device ids range from 0 to Pa_CountDevices()-1.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Devices may support input, output or both.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve the number of available host APIs. Even if a host API is

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ available it may have no devices available.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return A non-negative value indicating the number of available host APIs

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ or, a PaErrorCode (which are always negative) if PortAudio is not initialized

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ or an error is encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaHostApiIndex

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaHostApiIndex Pa_GetHostApiCount( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve the index of the default host API. The default host API will be

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the lowest common denominator host API on the current platform and is

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ unlikely to provide the best performance.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return A non-negative value ranging from 0 to (Pa_GetHostApiCount()-1)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ indicating the default host API index or, a PaErrorCode (which are always

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ negative) if PortAudio is not initialized or an error is encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaHostApiIndex Pa_GetDefaultHostApi( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Unchanging unique identifiers for each supported host API. This type

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ is used in the PaHostApiInfo structure. The values are guaranteed to be

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ unique and to never change, thus allowing code to be written that

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ conditionally uses host API specific extensions.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ New type ids will be allocated when support for a host API reaches

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ "public alpha" status, prior to that developers should use the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ paInDevelopment type id.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaHostApiInfo

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef enum PaHostApiTypeId

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+{

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paInDevelopment=0, /* use while developing support for a new host API */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paDirectSound=1,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paMME=2,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paASIO=3,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paSoundManager=4,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paCoreAudio=5,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paOSS=7,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paALSA=8,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paAL=9,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paBeOS=10,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paWDMKS=11,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paJACK=12,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paWASAPI=13,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paAudioScienceHPI=14

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+} PaHostApiTypeId;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--typedef int PaDeviceID;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define paNoDevice -1

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--int Pa_CountDevices( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** A structure containing information about a particular host API. */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--typedef struct

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef struct PaHostApiInfo

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- {

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** this is struct version 1 */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     int structVersion;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** The well known unique identifier of this host API @see PaHostApiTypeId */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaHostApiTypeId type;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** A textual description of the host API for display on user interfaces. */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-     const char *name;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    int maxInputChannels;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    int maxOutputChannels;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    /* Number of discrete rates, or -1 if range supported. */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    int numSampleRates;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    /* Array of supported sample rates, or {min,max} if range supported. */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    const double *sampleRates;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    PaSampleFormat nativeSampleFormats;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--}

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaDeviceInfo;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_GetDefaultInputDeviceID(), Pa_GetDefaultOutputDeviceID() return the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- default device ids for input and output respectively, or paNoDevice if

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- no device is available.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- The result can be passed to Pa_OpenStream().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /**  The number of devices belonging to this host API. This field may be

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     used in conjunction with Pa_HostApiDeviceIndexToDeviceIndex() to enumerate

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     all devices for this host API.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     @see Pa_HostApiDeviceIndexToDeviceIndex

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    int deviceCount;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** The default input device for this host API. The value will be a

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     device index ranging from 0 to (Pa_GetDeviceCount()-1), or paNoDevice

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     if no default input device is available.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaDeviceIndex defaultInputDevice;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** The default output device for this host API. The value will be a

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     device index ranging from 0 to (Pa_GetDeviceCount()-1), or paNoDevice

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     if no default output device is available.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaDeviceIndex defaultOutputDevice;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+} PaHostApiInfo;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve a pointer to a structure containing information about a specific

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ host Api.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param hostApi A valid host API index ranging from 0 to (Pa_GetHostApiCount()-1)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return A pointer to an immutable PaHostApiInfo structure describing

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ a specific host API. If the hostApi parameter is out of range or an error

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ is encountered, the function returns NULL.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ The returned structure is owned by the PortAudio implementation and must not

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ be manipulated or freed. The pointer is only guaranteed to be valid between

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ calls to Pa_Initialize() and Pa_Terminate().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+const PaHostApiInfo * Pa_GetHostApiInfo( PaHostApiIndex hostApi );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Convert a static host API unique identifier, into a runtime

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ host API index.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param type A unique host API identifier belonging to the PaHostApiTypeId

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ enumeration.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return A valid PaHostApiIndex ranging from 0 to (Pa_GetHostApiCount()-1) or,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ a PaErrorCode (which are always negative) if PortAudio is not initialized

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ or an error is encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ The paHostApiNotFound error code indicates that the host API specified by the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ type parameter is not available.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaHostApiTypeId

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaHostApiIndex Pa_HostApiTypeIdToHostApiIndex( PaHostApiTypeId type );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Convert a host-API-specific device index to standard PortAudio device index.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ This function may be used in conjunction with the deviceCount field of

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PaHostApiInfo to enumerate all devices for the specified host API.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param hostApi A valid host API index ranging from 0 to (Pa_GetHostApiCount()-1)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param hostApiDeviceIndex A valid per-host device index in the range

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ 0 to (Pa_GetHostApiInfo(hostApi)->deviceCount-1)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return A non-negative PaDeviceIndex ranging from 0 to (Pa_GetDeviceCount()-1)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ or, a PaErrorCode (which are always negative) if PortAudio is not initialized

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ or an error is encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ A paInvalidHostApi error code indicates that the host API index specified by

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the hostApi parameter is out of range.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ A paInvalidDevice error code indicates that the hostApiDeviceIndex parameter

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ is out of range.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaHostApiInfo

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaDeviceIndex Pa_HostApiDeviceIndexToDeviceIndex( PaHostApiIndex hostApi,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+        int hostApiDeviceIndex );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Structure used to return information about a host error condition.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef struct PaHostErrorInfo{

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaHostApiTypeId hostApiType;    /**< the host API which returned the error code */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    long errorCode;                 /**< the error code returned */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    const char *errorText;          /**< a textual description of the error if available, otherwise a zero-length string */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+}PaHostErrorInfo;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Return information about the last host error encountered. The error

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ information returned by Pa_GetLastHostErrorInfo() will never be modified

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ asyncronously by errors occurring in other PortAudio owned threads

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ (such as the thread that manages the stream callback.)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ This function is provided as a last resort, primarily to enhance debugging

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ by providing clients with access to all available error information.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return A pointer to an immutable structure constaining information about

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the host error. The values in this structure will only be valid if a

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PortAudio function has previously returned the paUnanticipatedHostError

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ error code.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+const PaHostErrorInfo* Pa_GetLastHostErrorInfo( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/* Device enumeration and capabilities */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve the number of available devices. The number of available devices

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ may be zero.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return A non-negative value indicating the number of available devices or,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ a PaErrorCode (which are always negative) if PortAudio is not initialized

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ or an error is encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaDeviceIndex Pa_GetDeviceCount( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve the index of the default input device. The result can be

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ used in the inputDevice parameter to Pa_OpenStream().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return The default input device index for the default host API, or paNoDevice

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ if no default input device is available or an error was encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaDeviceIndex Pa_GetDefaultInputDevice( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve the index of the default output device. The result can be

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ used in the outputDevice parameter to Pa_OpenStream().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return The default output device index for the defualt host API, or paNoDevice

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ if no default output device is available or an error was encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @note

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  On the PC, the user can specify a default device by

<span style='display:block; white-space:pre;background:#ffe0e0;'>-  setting an environment variable. For example, to use device #1.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--  set PA_RECOMMENDED_OUTPUT_DEVICE=1

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+<pre>

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ set PA_RECOMMENDED_OUTPUT_DEVICE=1

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+</pre>

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  The user should first determine the available device ids by using

<span style='display:block; white-space:pre;background:#ffe0e0;'>-  the supplied application "pa_devs".

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaDeviceIndex Pa_GetDefaultOutputDevice( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** The type used to represent monotonic time in seconds that can be used

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ for syncronisation. The type is used for the outTime argument to the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PaStreamCallback and as the result of Pa_GetStreamTime().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamCallback, Pa_GetStreamTime

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef double PaTime;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaDeviceID Pa_GetDefaultInputDeviceID( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaDeviceID Pa_GetDefaultOutputDeviceID( void );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** A type used to specify one or more sample formats. Each value indicates

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ a possible format for sound data passed to and from the stream callback,

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pa_ReadStream and Pa_WriteStream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ The standard formats paFloat32, paInt16, paInt32, paInt24, paInt8

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ and aUInt8 are usually implemented by all implementations.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_GetDeviceInfo() returns a pointer to an immutable PaDeviceInfo structure

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- for the device specified.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- If the device parameter is out of range the function returns NULL.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ The floating point representation (paFloat32) uses +1.0 and -1.0 as the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ maximum and minimum respectively.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- PortAudio manages the memory referenced by the returned pointer, the client

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- must not manipulate or free the memory. The pointer is only guaranteed to be

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- valid between calls to Pa_Initialize() and Pa_Terminate().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ paUInt8 is an unsigned 8 bit format where 128 is considered "ground"

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ The paNonInterleaved flag indicates that a multichannel buffer is passed

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ as a set of non-interleaved pointers.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_OpenStream, Pa_OpenDefaultStream, PaDeviceInfo

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see paFloat32, paInt16, paInt32, paInt24, paInt8

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see paUInt8, paCustomFormat, paNonInterleaved

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef unsigned long PaSampleFormat;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--const PaDeviceInfo* Pa_GetDeviceInfo( PaDeviceID device );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- PaTimestamp is used to represent a continuous sample clock with arbitrary

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- start time that can be used for syncronization. The type is used for the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- outTime argument to the PortAudioCallback and as the result of Pa_StreamTime()

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paFloat32        ((PaSampleFormat) 0x00000001) /**< @see PaSampleFormat */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paInt32          ((PaSampleFormat) 0x00000002) /**< @see PaSampleFormat */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paInt24          ((PaSampleFormat) 0x00000004) /**< Packed 24 bit format. @see PaSampleFormat */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paInt16          ((PaSampleFormat) 0x00000008) /**< @see PaSampleFormat */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paInt8           ((PaSampleFormat) 0x00000010) /**< @see PaSampleFormat */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paUInt8          ((PaSampleFormat) 0x00000020) /**< @see PaSampleFormat */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paCustomFormat   ((PaSampleFormat) 0x00010000)/**< @see PaSampleFormat */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paNonInterleaved ((PaSampleFormat) 0x80000000)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** A structure providing information and capabilities of PortAudio devices.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Devices may support input, output or both input and output.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef struct PaDeviceInfo

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+{

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    int structVersion;  /* this is struct version 2 */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    const char *name;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaHostApiIndex hostApi; /* note this is a host API index, not a type id*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    int maxInputChannels;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    int maxOutputChannels;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--typedef double PaTimestamp;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /* Default latency values for interactive performance. */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaTime defaultLowInputLatency;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaTime defaultLowOutputLatency;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /* Default latency values for robust non-interactive applications (eg. playing sound files). */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaTime defaultHighInputLatency;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaTime defaultHighOutputLatency;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- PortAudioCallback is implemented by PortAudio clients.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- inputBuffer and outputBuffer are arrays of interleaved samples,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- the format, packing and number of channels used by the buffers are

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- determined by parameters to Pa_OpenStream() (see below).

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- framesPerBuffer is the number of sample frames to be processed by the callback.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- outTime is the time in samples when the buffer(s) processed by

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- this callback will begin being played at the audio output.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- See also Pa_StreamTime()

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- userData is the value of a user supplied pointer passed to Pa_OpenStream()

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- intended for storing synthesis data etc.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- return value:

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- The callback can return a non-zero value to stop the stream. This may be

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- useful in applications such as soundfile players where a specific duration

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- of output is required. However, it is not necessary to utilise this mechanism

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- as StopStream() will also terminate the stream. A callback returning a

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- non-zero value must fill the entire outputBuffer.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- NOTE: None of the other stream functions may be called from within the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- callback function except for Pa_GetCPULoad().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    double defaultSampleRate;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+} PaDeviceInfo;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve a pointer to a PaDeviceInfo structure containing information

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ about the specified device.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return A pointer to an immutable PaDeviceInfo structure. If the device

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ parameter is out of range the function returns NULL.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param device A valid device index in the range 0 to (Pa_GetDeviceCount()-1)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @note PortAudio manages the memory referenced by the returned pointer,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the client must not manipulate or free the memory. The pointer is only

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ guaranteed to be valid between calls to Pa_Initialize() and Pa_Terminate().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaDeviceInfo, PaDeviceIndex

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+const PaDeviceInfo* Pa_GetDeviceInfo( PaDeviceIndex device );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--typedef int (PortAudioCallback)(

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    void *inputBuffer, void *outputBuffer,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    unsigned long framesPerBuffer,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    PaTimestamp outTime, void *userData );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Parameters for one direction (input or output) of a stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef struct PaStreamParameters

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+{

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** A valid device index in the range 0 to (Pa_GetDeviceCount()-1)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     specifying the device to be used or the special constant

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     paUseHostApiSpecificDeviceSpecification which indicates that the actual

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     device(s) to use are specified in hostApiSpecificStreamInfo.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     This field must not be set to paNoDevice.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaDeviceIndex device;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** The number of channels of sound to be delivered to the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     stream callback or accessed by Pa_ReadStream() or Pa_WriteStream().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     It can range from 1 to the value of maxInputChannels in the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     PaDeviceInfo record for the device specified by the device parameter.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    int channelCount;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** The sample format of the buffer provided to the stream callback,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     a_ReadStream() or Pa_WriteStream(). It may be any of the formats described

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     by the PaSampleFormat enumeration.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaSampleFormat sampleFormat;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** The desired latency in seconds. Where practical, implementations should

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     configure their latency based on these parameters, otherwise they may

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     choose the closest viable latency instead. Unless the suggested latency

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     is greater than the absolute upper limit for the device implementations

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     should round the suggestedLatency up to the next practial value - ie to

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     provide an equal or higher latency than suggestedLatency wherever possibe.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     Actual latency values for an open stream may be retrieved using the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     inputLatency and outputLatency fields of the PaStreamInfo structure

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     returned by Pa_GetStreamInfo().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     @see default*Latency in PaDeviceInfo, *Latency in PaStreamInfo

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaTime suggestedLatency;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** An optional pointer to a host api specific data structure

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     containing additional information for device setup and/or stream processing.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     hostApiSpecificStreamInfo is never required for correct operation,

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     if not used it should be set to NULL.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    void *hostApiSpecificStreamInfo;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+} PaStreamParameters;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Return code for Pa_IsFormatSupported indicating success. */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paFormatIsSupported (0)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Determine whether it would be possible to open a stream with the specified

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ parameters.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param inputParameters A structure that describes the input parameters used to

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ open a stream. The suggestedLatency field is ignored. See PaStreamParameters

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ for a description of these parameters. inputParameters must be NULL for

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ output-only streams.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param outputParameters A structure that describes the output parameters used

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ to open a stream. The suggestedLatency field is ignored. See PaStreamParameters

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ for a description of these parameters. outputParameters must be NULL for

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ input-only streams.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Stream flags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- These flags may be supplied (ored together) in the streamFlags argument to

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- the Pa_OpenStream() function.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param sampleRate The required sampleRate. For full-duplex streams it is the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ sample rate for both input and output

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return Returns 0 if the format is supported, and an error code indicating why

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the format is not supported otherwise. The constant paFormatIsSupported is

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ provided to compare with the return value for success.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see paFormatIsSupported, PaStreamParameters

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_IsFormatSupported( const PaStreamParameters *inputParameters,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                              const PaStreamParameters *outputParameters,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                              double sampleRate );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define   paNoFlag      (0)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define   paClipOff     (1<<0)   /* disable default clipping of out of range samples */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define   paDitherOff   (1<<1)   /* disable default dithering */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define   paPlatformSpecificFlags (0x00010000)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--typedef   unsigned long PaStreamFlags;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- A single PortAudioStream provides multiple channels of real-time

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- input and output audio streaming to a client application.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pointers to PortAudioStream objects are passed between PortAudio functions.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/* Streaming types and functions */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/**

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ A single PaStream can provide multiple channels of real-time

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ streaming audio input and output to a client application. A stream

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ provides access to audio hardware represented by one or more

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PaDevices. Depending on the underlying Host API, it may be possible 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ to open multiple streams using the same device, however this behavior 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ is implementation defined. Portable applications should assume that 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ a PaDevice may be simultaneously used by at most one PaStream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pointers to PaStream objects are passed between PortAudio functions that

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ operate on streams.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_OpenStream, Pa_OpenDefaultStream, Pa_OpenDefaultStream, Pa_CloseStream,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pa_StartStream, Pa_StopStream, Pa_AbortStream, Pa_IsStreamActive,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pa_GetStreamTime, Pa_GetStreamCpuLoad

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef void PaStream;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--typedef void PortAudioStream;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#define PaStream PortAudioStream

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_OpenStream() opens a stream for either input, output or both.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Can be passed as the framesPerBuffer parameter to Pa_OpenStream()

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ or Pa_OpenDefaultStream() to indicate that the stream callback will

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ accept buffers of any size.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paFramesPerBufferUnspecified  (0)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Flags used to control the behavior of a stream. They are passed as

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ parameters to Pa_OpenStream or Pa_OpenDefaultStream. Multiple flags may be

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ ORed together.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_OpenStream, Pa_OpenDefaultStream

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see paNoFlag, paClipOff, paDitherOff, paNeverDropInput,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+  paPrimeOutputBuffersUsingStreamCallback, paPlatformSpecificFlags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef unsigned long PaStreamFlags;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** @see PaStreamFlags */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define   paNoFlag          ((PaStreamFlags) 0)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Disable default clipping of out of range samples.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamFlags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define   paClipOff         ((PaStreamFlags) 0x00000001)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Disable default dithering.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamFlags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define   paDitherOff       ((PaStreamFlags) 0x00000002)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Flag requests that where possible a full duplex stream will not discard

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ overflowed input samples without calling the stream callback. This flag is

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ only valid for full duplex callback streams and only when used in combination

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ with the paFramesPerBufferUnspecified (0) framesPerBuffer parameter. Using

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ this flag incorrectly results in a paInvalidFlag error being returned from

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pa_OpenStream and Pa_OpenDefaultStream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamFlags, paFramesPerBufferUnspecified

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define   paNeverDropInput  ((PaStreamFlags) 0x00000004)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Call the stream callback to fill initial output buffers, rather than the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ default behavior of priming the buffers with zeros (silence). This flag has

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ no effect for input-only and blocking read/write streams.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- stream is the address of a PortAudioStream pointer which will receive

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamFlags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define   paPrimeOutputBuffersUsingStreamCallback ((PaStreamFlags) 0x00000008)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** A mask specifying the platform specific bits.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamFlags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define   paPlatformSpecificFlags ((PaStreamFlags)0xFFFF0000)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/**

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Timing information for the buffers passed to the stream callback.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef struct PaStreamCallbackTimeInfo{

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaTime inputBufferAdcTime;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaTime currentTime;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaTime outputBufferDacTime;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+} PaStreamCallbackTimeInfo;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/**

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Flag bit constants for the statusFlags to PaStreamCallback.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see paInputUnderflow, paInputOverflow, paOutputUnderflow, paOutputOverflow,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ paPrimingOutput

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef unsigned long PaStreamCallbackFlags;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** In a stream opened with paFramesPerBufferUnspecified, indicates that

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ input data is all silence (zeros) because no real data is available. In a

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ stream opened without paFramesPerBufferUnspecified, it indicates that one or

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ more zero samples have been inserted into the input buffer to compensate

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ for an input underflow.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamCallbackFlags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paInputUnderflow   ((PaStreamCallbackFlags) 0x00000001)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** In a stream opened with paFramesPerBufferUnspecified, indicates that data

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ prior to the first sample of the input buffer was discarded due to an

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ overflow, possibly because the stream callback is using too much CPU time.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Otherwise indicates that data prior to one or more samples in the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ input buffer was discarded.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamCallbackFlags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paInputOverflow    ((PaStreamCallbackFlags) 0x00000002)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Indicates that output data (or a gap) was inserted, possibly because the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ stream callback is using too much CPU time.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamCallbackFlags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paOutputUnderflow  ((PaStreamCallbackFlags) 0x00000004)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Indicates that output data will be discarded because no room is available.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamCallbackFlags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paOutputOverflow   ((PaStreamCallbackFlags) 0x00000008)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Some of all of the output data will be used to prime the stream, input

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ data may be zero.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamCallbackFlags

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#define paPrimingOutput    ((PaStreamCallbackFlags) 0x00000010)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/**

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Allowable return values for the PaStreamCallback.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamCallback

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef enum PaStreamCallbackResult

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+{

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paContinue=0,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paComplete=1,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    paAbort=2

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+} PaStreamCallbackResult;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/**

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Functions of type PaStreamCallback are implemented by PortAudio clients.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ They consume, process or generate audio in response to requests from an

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ active PortAudio stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param input and @param output are arrays of interleaved samples,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the format, packing and number of channels used by the buffers are

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ determined by parameters to Pa_OpenStream().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param frameCount The number of sample frames to be processed by

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the stream callback.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param timeInfo The time in seconds when the first sample of the input

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ buffer was received at the audio input, the time in seconds when the first

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ sample of the output buffer will begin being played at the audio output, and

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the time in seconds when the stream callback was called.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ See also Pa_GetStreamTime()

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param statusFlags Flags indicating whether input and/or output buffers

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ have been inserted or will be dropped to overcome underflow or overflow

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ conditions.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param userData The value of a user supplied pointer passed to

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pa_OpenStream() intended for storing synthesis data etc.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ The stream callback should return one of the values in the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PaStreamCallbackResult enumeration. To ensure that the callback continues

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ to be called, it should return paContinue (0). Either paComplete or paAbort

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ can be returned to finish stream processing, after either of these values is

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ returned the callback will not be called again. If paAbort is returned the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ stream will finish as soon as possible. If paComplete is returned, the stream

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ will continue until all buffers generated by the callback have been played.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ This may be useful in applications such as soundfile players where a specific

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ duration of output is required. However, it is not necessary to utilise this

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ mechanism as Pa_StopStream(), Pa_AbortStream() or Pa_CloseStream() can also

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ be used to stop the stream. The callback must always fill the entire output

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ buffer irrespective of its return value.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_OpenStream, Pa_OpenDefaultStream

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @note With the exception of Pa_GetStreamCpuLoad() it is not permissable to call

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PortAudio API functions from within the stream callback.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef int PaStreamCallback(

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    const void *input, void *output,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    unsigned long frameCount,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    const PaStreamCallbackTimeInfo* timeInfo,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaStreamCallbackFlags statusFlags,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    void *userData );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Opens a stream for either input, output or both.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param stream The address of a PaStream pointer which will receive

<span style='display:block; white-space:pre;background:#ffe0e0;'>-  a pointer to the newly opened stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param inputParameters A structure that describes the input parameters used by

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the opened stream. See PaStreamParameters for a description of these parameters.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ inputParameters must be NULL for output-only streams.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param outputParameters A structure that describes the output parameters used by

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the opened stream. See PaStreamParameters for a description of these parameters.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ outputParameters must be NULL for input-only streams.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- inputDevice is the id of the device used for input (see PaDeviceID above.)

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- inputDevice may be paNoDevice to indicate that an input device is not required.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- numInputChannels is the number of channels of sound to be delivered to the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- callback. It can range from 1 to the value of maxInputChannels in the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- PaDeviceInfo record for the device specified by the inputDevice parameter.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- If inputDevice is paNoDevice numInputChannels is ignored.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- inputSampleFormat is the sample format of inputBuffer provided to the callback

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- function. inputSampleFormat may be any of the formats described by the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- PaSampleFormat enumeration (see above). PortAudio guarantees support for

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- the device's native formats (nativeSampleFormats in the device info record)

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- and additionally 16 and 32 bit integer and 32 bit floating point formats.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Support for other formats is implementation defined.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- inputDriverInfo is a pointer to an optional driver specific data structure

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- containing additional information for device setup or stream processing.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- inputDriverInfo is never required for correct operation. If not used

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- inputDriverInfo should be NULL.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- outputDevice is the id of the device used for output (see PaDeviceID above.)

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- outputDevice may be paNoDevice to indicate that an output device is not required.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- numOutputChannels is the number of channels of sound to be supplied by the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- callback. See the definition of numInputChannels above for more details.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- outputSampleFormat is the sample format of the outputBuffer filled by the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- callback function. See the definition of inputSampleFormat above for more

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- details.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- outputDriverInfo is a pointer to an optional driver specific data structure

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- containing additional information for device setup or stream processing.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- outputDriverInfo is never required for correct operation. If not used

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- outputDriverInfo should be NULL.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- sampleRate is the desired sampleRate. For full-duplex streams it is the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param sampleRate The desired sampleRate. For full-duplex streams it is the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  sample rate for both input and output

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- framesPerBuffer is the length in sample frames of all internal sample buffers

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- used for communication with platform specific audio routines. Wherever

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- possible this corresponds to the framesPerBuffer parameter passed to the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- callback function.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- numberOfBuffers is the number of buffers used for multibuffered communication

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- with the platform specific audio routines. If you pass zero, then an optimum

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- value will be chosen for you internally. This parameter is provided only

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- as a guide - and does not imply that an implementation must use multibuffered

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- i/o when reliable double buffering is available (such as SndPlayDoubleBuffer()

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- on the Macintosh.)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- streamFlags may contain a combination of flags ORed together.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- These flags modify the behaviour of the streaming process. Some flags may only

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- be relevant to certain buffer formats.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- callback is a pointer to a client supplied function that is responsible

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- for processing and filling input and output buffers (see above for details.)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- userData is a client supplied pointer which is passed to the callback

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- function. It could for example, contain a pointer to instance data necessary

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- for processing the audio buffers.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- return value:

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Upon success Pa_OpenStream() returns PaNoError and places a pointer to a

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- valid PortAudioStream in the stream argument. The stream is inactive (stopped).

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- If a call to Pa_OpenStream() fails a non-zero error code is returned (see

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- PaError above) and the value of stream is invalid.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param framesPerBuffer The number of frames passed to the stream callback

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ function, or the preferred block granularity for a blocking read/write stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ The special value paFramesPerBufferUnspecified (0) may be used to request that

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the stream callback will recieve an optimal (and possibly varying) number of

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ frames based on host requirements and the requested latency settings.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Note: With some host APIs, the use of non-zero framesPerBuffer for a callback

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ stream may introduce an additional layer of buffering which could introduce

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ additional latency. PortAudio guarantees that the additional latency

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ will be kept to the theoretical minimum however, it is strongly recommended

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ that a non-zero framesPerBuffer value only be used when your algorithm

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ requires a fixed number of frames per stream callback.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param streamFlags Flags which modify the behaviour of the streaming process.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ This parameter may contain a combination of flags ORed together. Some flags may

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ only be relevant to certain buffer formats.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param streamCallback A pointer to a client supplied function that is responsible

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ for processing and filling input and output buffers. If this parameter is NULL

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the stream will be opened in 'blocking read/write' mode. In blocking mode,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the client can receive sample data using Pa_ReadStream and write sample data

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ using Pa_WriteStream, the number of samples that may be read or written

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ without blocking is returned by Pa_GetStreamReadAvailable and

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pa_GetStreamWriteAvailable respectively.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaError Pa_OpenStream( PortAudioStream** stream,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                       PaDeviceID inputDevice,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                       int numInputChannels,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                       PaSampleFormat inputSampleFormat,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                       void *inputDriverInfo,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                       PaDeviceID outputDevice,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                       int numOutputChannels,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                       PaSampleFormat outputSampleFormat,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                       void *outputDriverInfo,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param userData A client supplied pointer which is passed to the stream callback

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ function. It could for example, contain a pointer to instance data necessary

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ for processing the audio buffers. This parameter is ignored if streamCallback

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ is NULL.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Upon success Pa_OpenStream() returns paNoError and places a pointer to a

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ valid PaStream in the stream argument. The stream is inactive (stopped).

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ If a call to Pa_OpenStream() fails, a non-zero error code is returned (see

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PaError for possible error codes) and the value of stream is invalid.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamParameters, PaStreamCallback, Pa_ReadStream, Pa_WriteStream,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pa_GetStreamReadAvailable, Pa_GetStreamWriteAvailable

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_OpenStream( PaStream** stream,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                       const PaStreamParameters *inputParameters,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                       const PaStreamParameters *outputParameters,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-                        double sampleRate,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-                        unsigned long framesPerBuffer,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                       unsigned long numberOfBuffers,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-                        PaStreamFlags streamFlags,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                       PortAudioCallback *callback,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                       PaStreamCallback *streamCallback,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-                        void *userData );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_OpenDefaultStream() is a simplified version of Pa_OpenStream() that opens

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- the default input and/or output devices. Most parameters have identical meaning

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- to their Pa_OpenStream() counterparts, with the following exceptions:

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- If either numInputChannels or numOutputChannels is 0 the respective device

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- is not opened. This has the same effect as passing paNoDevice in the device

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- arguments to Pa_OpenStream().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** A simplified version of Pa_OpenStream() that opens the default input

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ and/or output devices.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param stream The address of a PaStream pointer which will receive

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ a pointer to the newly opened stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- sampleFormat applies to both the input and output buffers.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param numInputChannels  The number of channels of sound that will be supplied

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ to the stream callback or returned by Pa_ReadStream. It can range from 1 to

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the value of maxInputChannels in the PaDeviceInfo record for the default input

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ device. If 0 the stream is opened as an output-only stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param numOutputChannels The number of channels of sound to be delivered to the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ stream callback or passed to Pa_WriteStream. It can range from 1 to the value

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ of maxOutputChannels in the PaDeviceInfo record for the default output dvice.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ If 0 the stream is opened as an output-only stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param sampleFormat The sample format of both the input and output buffers

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ provided to the callback or passed to and from Pa_ReadStream and Pa_WriteStream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ sampleFormat may be any of the formats described by the PaSampleFormat

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ enumeration.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param sampleRate Same as Pa_OpenStream parameter of the same name.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param framesPerBuffer Same as Pa_OpenStream parameter of the same name.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param streamCallback Same as Pa_OpenStream parameter of the same name.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param userData Same as Pa_OpenStream parameter of the same name.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return As for Pa_OpenStream

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaError Pa_OpenDefaultStream( PortAudioStream** stream,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_OpenStream, PaStreamCallback

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_OpenDefaultStream( PaStream** stream,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-                               int numInputChannels,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-                               int numOutputChannels,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-                               PaSampleFormat sampleFormat,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-                               double sampleRate,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-                               unsigned long framesPerBuffer,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                              unsigned long numberOfBuffers,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--                              PortAudioCallback *callback,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                              PaStreamCallback *streamCallback,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-                               void *userData );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_CloseStream() closes an audio stream, flushing any pending buffers.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Closes an audio stream. If the audio stream is active it

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ discards any pending buffers as if Pa_AbortStream() had been called.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_CloseStream( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaError Pa_CloseStream( PortAudioStream* );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_StartStream() and Pa_StopStream() begin and terminate audio processing.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_StopStream() waits until all pending audio buffers have been played.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_AbortStream() stops playing immediately without waiting for pending

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Functions of type PaStreamFinishedCallback are implemented by PortAudio 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ clients. They can be registered with a stream using the Pa_SetStreamFinishedCallback

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ function. Once registered they are called when the stream becomes inactive

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ (ie once a call to Pa_StopStream() will not block).

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ A stream will become inactive after the stream callback returns non-zero,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ or when Pa_StopStream or Pa_AbortStream is called. For a stream providing audio

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ output, if the stream callback returns paComplete, or Pa_StopStream is called,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the stream finished callback will not be called until all generated sample data

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ has been played.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param userData The userData parameter supplied to Pa_OpenStream()

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_SetStreamFinishedCallback

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef void PaStreamFinishedCallback( void *userData );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Register a stream finished callback function which will be called when the 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ stream becomes inactive. See the description of PaStreamFinishedCallback for 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ further details about when the callback will be called.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param stream a pointer to a PaStream that is in the stopped state - if the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ stream is not stopped, the stream's finished callback will remain unchanged 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ and an error code will be returned.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param streamFinishedCallback a pointer to a function with the same signature

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ as PaStreamFinishedCallback, that will be called when the stream becomes

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ inactive. Passing NULL for this parameter will un-register a previously

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ registered stream finished callback function.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return on success returns paNoError, otherwise an error code indicating the cause

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ of the error.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamFinishedCallback

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_SetStreamFinishedCallback( PaStream *stream, PaStreamFinishedCallback* streamFinishedCallback ); 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Commences audio processing.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_StartStream( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Terminates audio processing. It waits until all pending

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ audio buffers have been played before it returns.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_StopStream( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Terminates audio processing immediately without waiting for pending

<span style='display:block; white-space:pre;background:#ffe0e0;'>-  buffers to complete.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_AbortStream( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaError Pa_StartStream( PortAudioStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaError Pa_StopStream( PortAudioStream *stream );

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Determine whether the stream is stopped.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ A stream is considered to be stopped prior to a successful call to

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pa_StartStream and after a successful call to Pa_StopStream or Pa_AbortStream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ If a stream callback returns a value other than paContinue the stream is NOT

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ considered to be stopped.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaError Pa_AbortStream( PortAudioStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return Returns one (1) when the stream is stopped, zero (0) when

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the stream is running or, a PaErrorCode (which are always negative) if

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PortAudio is not initialized or an error is encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_StreamActive() returns one (1) when the stream is active (ie playing

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- or recording audio), zero (0) when not playing, or a negative error number

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- if the stream is invalid.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- The stream is active between calls to Pa_StartStream() and Pa_StopStream(),

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- but may also become inactive if the callback returns a non-zero value.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- In the latter case, the stream is considered inactive after the last

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- buffer has finished playing.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_StopStream, Pa_AbortStream, Pa_IsStreamActive

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_IsStreamStopped( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaError Pa_StreamActive( PortAudioStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_StreamTime() returns the current output time in samples for the stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- This time may be used as a time reference (for example synchronizing audio to

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- MIDI).

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Determine whether the stream is active.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ A stream is active after a successful call to Pa_StartStream(), until it

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ becomes inactive either as a result of a call to Pa_StopStream() or

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ Pa_AbortStream(), or as a result of a return value other than paContinue from

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the stream callback. In the latter case, the stream is considered inactive

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ after the last buffer has finished playing.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return Returns one (1) when the stream is active (ie playing or recording

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ audio), zero (0) when not playing or, a PaErrorCode (which are always negative)

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ if PortAudio is not initialized or an error is encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_StopStream, Pa_AbortStream, Pa_IsStreamStopped

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_IsStreamActive( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--PaTimestamp Pa_StreamTime( PortAudioStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_GetCPULoad() returns the CPU Load for the stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- The "CPU Load" is a fraction of total CPU time consumed by the stream's

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** A structure containing unchanging information about an open stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see Pa_GetStreamInfo

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+typedef struct PaStreamInfo

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+{

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** this is struct version 1 */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    int structVersion;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** The input latency of the stream in seconds. This value provides the most

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     accurate estimate of input latency available to the implementation. It may

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     differ significantly from the suggestedLatency value passed to Pa_OpenStream().

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     The value of this field will be zero (0.) for output-only streams.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     @see PaTime

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaTime inputLatency;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** The output latency of the stream in seconds. This value provides the most

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     accurate estimate of output latency available to the implementation. It may

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     differ significantly from the suggestedLatency value passed to Pa_OpenStream().

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     The value of this field will be zero (0.) for input-only streams.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     @see PaTime

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    PaTime outputLatency;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    /** The sample rate of the stream in Hertz (samples per second). In cases

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     where the hardware sample rate is inaccurate and PortAudio is aware of it,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     the value of this field may be different from the sampleRate parameter

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     passed to Pa_OpenStream(). If information about the actual hardware sample

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     rate is not available, this field will have the same value as the sampleRate

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+     parameter passed to Pa_OpenStream().

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    double sampleRate;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+    

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+} PaStreamInfo;

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve a pointer to a PaStreamInfo structure containing information

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ about the specified stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return A pointer to an immutable PaStreamInfo structure. If the stream

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ parameter invalid, or an error is encountered, the function returns NULL.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param stream A pointer to an open stream previously created with Pa_OpenStream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @note PortAudio manages the memory referenced by the returned pointer,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the client must not manipulate or free the memory. The pointer is only

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ guaranteed to be valid until the specified stream is closed.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaStreamInfo

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+const PaStreamInfo* Pa_GetStreamInfo( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Determine the current time for the stream according to the same clock used

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ to generate buffer timestamps. This time may be used for syncronising other

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ events to the audio stream, for example synchronizing audio to MIDI.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                                        

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return The stream's current time in seconds, or 0 if an error occurred.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @see PaTime, PaStreamCallback

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaTime Pa_GetStreamTime( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve CPU usage information for the specified stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ The "CPU Load" is a fraction of total CPU time consumed by a callback stream's

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  audio processing routines including, but not limited to the client supplied

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- callback.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- A value of 0.5 would imply that PortAudio and the sound generating

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- callback was consuming roughly 50% of the available CPU time.

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- This function may be called from the callback function or the application.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ stream callback. This function does not work with blocking read/write streams.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ This function may be called from the stream callback function or the

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ application.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+     

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ A floating point value, typically between 0.0 and 1.0, where 1.0 indicates

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ that the stream callback is consuming the maximum number of CPU cycles possible

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ to maintain real-time operation. A value of 0.5 would imply that PortAudio and

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the stream callback was consuming roughly 50% of the available CPU time. The

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ return value may exceed 1.0. A value of 0.0 will always be returned for a

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ blocking read/write stream, or if an error occurrs.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+double Pa_GetStreamCpuLoad( PaStream* stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--double Pa_GetCPULoad( PortAudioStream* stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_GetMinNumBuffers() returns the minimum number of buffers required by

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- the current host based on minimum latency.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- On the PC, for the DirectSound implementation, latency can be optionally set

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- by user by setting an environment variable.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- For example, to set latency to 200 msec, put:

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--    set PA_MIN_LATENCY_MSEC=200

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- in the AUTOEXEC.BAT file and reboot.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- If the environment variable is not set, then the latency will be determined

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- based on the OS. Windows NT has higher latency than Win95.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Read samples from an input stream. The function doesn't return until

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ the entire buffer has been filled - this may involve waiting for the operating

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ system to supply the data.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param stream A pointer to an open stream previously created with Pa_OpenStream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-  

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param buffer A pointer to a buffer of sample frames. The buffer contains

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ samples in the format specified by the inputParameters->sampleFormat field

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ used to open the stream, and the number of channels specified by

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ inputParameters->numChannels. If non-interleaved samples were requested,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ buffer is a pointer to the first element of an array of non-interleaved

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ buffer pointers, one for each channel.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param frames The number of frames to be read into buffer. This parameter

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ is not constrained to a specific range, however high performance applications

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ will want to match this parameter to the framesPerBuffer parameter used

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ when opening the stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return On success PaNoError will be returned, or PaInputOverflowed if input

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ data was discarded by PortAudio after the previous call and before this call.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_ReadStream( PaStream* stream,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                       void *buffer,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                       unsigned long frames );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--int Pa_GetMinNumBuffers( int framesPerBuffer, double sampleRate );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_Sleep() puts the caller to sleep for at least 'msec' milliseconds.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- You may sleep longer than the requested time so don't rely on this for

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- accurate musical timing.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_Sleep() is provided as a convenience for authors of portable code (such as

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- the tests and examples in the PortAudio distribution.)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Write samples to an output stream. This function doesn't return until the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ entire buffer has been consumed - this may involve waiting for the operating

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ system to consume the data.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param stream A pointer to an open stream previously created with Pa_OpenStream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param buffer A pointer to a buffer of sample frames. The buffer contains

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ samples in the format specified by the outputParameters->sampleFormat field

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ used to open the stream, and the number of channels specified by

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ outputParameters->numChannels. If non-interleaved samples were requested,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ buffer is a pointer to the first element of an array of non-interleaved

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ buffer pointers, one for each channel.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @param frames The number of frames to be written from buffer. This parameter

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ is not constrained to a specific range, however high performance applications

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ will want to match this parameter to the framesPerBuffer parameter used

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ when opening the stream.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return On success PaNoError will be returned, or paOutputUnderflowed if

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ additional output data was inserted after the previous call and before this

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ call.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+PaError Pa_WriteStream( PaStream* stream,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                        const void *buffer,

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+                        unsigned long frames );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--void Pa_Sleep( long msec );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--/*

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- Pa_GetSampleSize() returns the size in bytes of a single sample in the

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-- supplied PaSampleFormat, or paSampleFormatNotSupported if the format is

<span style='display:block; white-space:pre;background:#ffe0e0;'>-- no supported.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--  

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve the number of frames that can be read from the stream without

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ waiting.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return Returns a non-negative value representing the maximum number of frames

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ that can be read from the stream without blocking or busy waiting or, a

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PaErrorCode (which are always negative) if PortAudio is not initialized or an

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ error is encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+signed long Pa_GetStreamReadAvailable( PaStream* stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve the number of frames that can be written to the stream without

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ waiting.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return Returns a non-negative value representing the maximum number of frames

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ that can be written to the stream without blocking or busy waiting or, a

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ PaErrorCode (which are always negative) if PortAudio is not initialized or an

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ error is encountered.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+signed long Pa_GetStreamWriteAvailable( PaStream* stream );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/* Miscellaneous utilities */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Retrieve the size of a given sample format in bytes.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ @return The size in bytes of a single sample in the specified format,

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ or paSampleFormatNotSupported if the format is not supported.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- PaError Pa_GetSampleSize( PaSampleFormat format );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- 

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+/** Put the caller to sleep for at least 'msec' milliseconds. This function is

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ provided only as a convenience for authors of portable code (such as the tests

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ and examples in the PortAudio distribution.)

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+ The function may sleep longer than requested so don't rely on this for accurate

<span style='display:block; white-space:pre;background:#ffe0e0;'>-+ musical timing.

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+*/

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+void Pa_Sleep( long msec );

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- #ifdef __cplusplus

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- }

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- #endif /* __cplusplus */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--#endif /* PORT_AUDIO_H */

</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-+#endif /* PORTAUDIO_H */

</span> --- src/speech.h.orig     2014-03-04 10:47:15.000000000 -0600

 +++ src/speech.h       2020-06-26 14:16:48.000000000 -0500

 @@ -47,8 +47,10 @@

</pre><pre style='margin:0'>

</pre>