<pre style='margin:0'>

Renee Otten (reneeotten) pushed a commit to branch master

in repository macports-ports.

</pre>

<p><a href="https://github.com/macports/macports-ports/commit/11f1d1839b5f44e7774b73ac0243eef3d48ac0f2">https://github.com/macports/macports-ports/commit/11f1d1839b5f44e7774b73ac0243eef3d48ac0f2</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 11f1d1839b5 espeak: new port, version 1.48.04

</span>11f1d1839b5 is described below

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

</span>Author: Daniel Bair <bair.daniel@gmail.com>

AuthorDate: Tue Jun 23 15:42:28 2020 +0700

<span style='display:block; white-space:pre;color:#404040;'>    espeak: new port, version 1.48.04

</span>---

 audio/espeak/Portfile                    |   64 ++

 audio/espeak/files/patch-espeak-mac.diff | 1489 ++++++++++++++++++++++++++++++

 2 files changed, 1553 insertions(+)

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

</span>new file mode 100644

<span style='display:block; white-space:pre;color:#808080;'>index 00000000000..eb4a91b2a1e

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

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

</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -0,0 +1,64 @@

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# -*- coding: utf-8; mode: tcl; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- vim:fenc=utf-8:ft=tcl:et:sw=4:ts=4:sts=4

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

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

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

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

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

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

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

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

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

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+description         eSpeak is a compact open source software speech synthesizer

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+long_description    eSpeak is a Text to Speech engine for English and many other\

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                    languages. Compact size with clear but artificial pronunciation.\

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                    Available as a command-line program with many options and a shared library

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+homepage            http://espeak.sourceforge.net/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+master_sites        sourceforge:project/espeak/espeak/espeak-1.48

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+distname            ${name}-${version}-source

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+checksums           ${distname}${extract.suffix} \

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

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

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+patchfiles          patch-espeak-mac.diff

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+if {${os.platform} eq "darwin" && ${os.major} >= 10} {

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    configure.args-append   --with-mictype=portaudio

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

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

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+build.args          PREFIX=${prefix} DATADIR=${prefix}/share/espeak-data \

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                    CC=${configure.cc} \

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                    CXX=${configure.cxx} \

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                    CPP=${configure.cpp}

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+destroot.args       PREFIX=${prefix} DATADIR=${prefix}/share/espeak-data

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+set docdir ${prefix}/share/doc/${name}

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    move ${worksrcpath}/docs ${destroot}${docdir}

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    xinstall -m 644 -W ${worksrcpath} \

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

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

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    system -W ${destroot}${prefix} \

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+        "install_name_tool -change libespeak.dylib  ${prefix}/lib/libespeak.dylib ./bin/espeak"

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

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

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

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+test.args           "Testing." -w out.wav

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+livecheck.url       http://sourceforge.net/projects/${name}/releases/rss

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+livecheck.regex     <title>${name}.* - (\[0-9.a-z\-\]+)</title>

</span><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>new file mode 100644

<span style='display:block; white-space:pre;color:#808080;'>index 00000000000..8da86753375

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

</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;'>@@ -0,0 +1,1489 @@

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+diff -ruEN orig/Makefile src/Makefile

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+--- orig/Makefile  2020-06-25 22:03:43.000000000 +0700

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++++ src/Makefile   2020-06-25 22:02:50.000000000 +0700

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

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

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

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

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

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

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ LIBTAG = $(LIB_VERSION).$(RELEASE)

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ # Use SONAME_OPT=-Wl,h, on Solaris

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

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ # Use EXTRA_LIBS=-lm on Solaris

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+@@ -114,11 +114,8 @@

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+   -I. -D LIBRARY -c -fno-exceptions  $<  -o x_$*.o

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ $(LIB_NAME): $(OBJS2)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-  $(CXX) $(LDFLAGS) -shared $(SONAME_OPT)$(LIB_NAME).$(LIB_VERSION) -o $@ \

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++  $(CXX) $(LDFLAGS) -shared $(SONAME_OPT)$(LIB_NAME) -o $@ \

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+   $(OBJS2) $(LIBS2)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-  mv $(LIB_NAME) $(LIB_NAME).$(LIBTAG)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-  $(LN_SF) $(LIB_NAME).$(LIBTAG) $(LIB_NAME).$(LIB_VERSION)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-  $(LN_SF) $(LIB_NAME).$(LIB_VERSION) $(LIB_NAME)

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ $(STATIC_LIB_NAME): $(OBJS2)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+   $(AR) cqs $(STATIC_LIB_NAME) $(OBJS2)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+@@ -138,14 +135,14 @@

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+   $(MKDIR) $(DESTDIR)$(LIBDIR)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+   $(MKDIR) $(DESTDIR)$(INCDIR)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+   $(MKDIR) $(DESTDIR)$(DATADIR)

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++  $(INSTALL) -m 755 $(BIN_NAME) $(DESTDIR)$(BINDIR)

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+   $(INSTALL) -m 755 $(BIN2_NAME) $(DESTDIR)$(BINDIR)

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-  $(INSTALL) -m 755 $(LIB_NAME).$(LIBTAG) $(DESTDIR)$(LIBDIR)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++  $(INSTALL) -m 755 $(LIB_NAME) $(DESTDIR)$(LIBDIR)

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+   $(INSTALL) -m 755 $(STATIC_LIB_NAME) $(DESTDIR)$(LIBDIR)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-  $(LN_SF) $(LIB_NAME).$(LIBTAG) $(DESTDIR)$(LIBDIR)/$(LIB_NAME).$(LIB_VERSION)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-  $(LN_SF) $(LIB_NAME).$(LIB_VERSION) $(DESTDIR)$(LIBDIR)/$(LIB_NAME)

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+   $(INSTALL) -pm 644 speak_lib.h $(DESTDIR)$(INCDIR)

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+diff -ruEN orig/portaudio.h src/portaudio.h

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+--- orig/portaudio.h       2020-06-25 22:03:43.000000000 +0700

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++++ src/portaudio.h        2020-06-25 22:25:46.000000000 +0700

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    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:#e0ffe0;'>++}PaHostErrorInfo;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ with the paFramesPerBufferUnspecified (0) framesPerBuffer parameter. Using

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ this flag incorrectly results in a paInvalidFlag error being returned from

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ Pa_OpenStream and Pa_OpenDefaultStream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamFlags, paFramesPerBufferUnspecified

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++#define   paNeverDropInput  ((PaStreamFlags) 0x00000004)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Call the stream callback to fill initial output buffers, rather than the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ default behavior of priming the buffers with zeros (silence). This flag has

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ no effect for input-only and blocking read/write streams.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+  

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- stream is the address of a PortAudioStream pointer which will receive

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamFlags

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++#define   paPrimeOutputBuffersUsingStreamCallback ((PaStreamFlags) 0x00000008)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

<span style='display:block; white-space:pre;background:#e0ffe0;'>++/** A mask specifying the platform specific bits.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamFlags

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++#define   paPlatformSpecificFlags ((PaStreamFlags)0xFFFF0000)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/**

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ Timing information for the buffers passed to the stream callback.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++typedef struct PaStreamCallbackTimeInfo{

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    PaTime inputBufferAdcTime;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    PaTime currentTime;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    PaTime outputBufferDacTime;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++} PaStreamCallbackTimeInfo;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/**

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ Flag bit constants for the statusFlags to PaStreamCallback.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see paInputUnderflow, paInputOverflow, paOutputUnderflow, paOutputOverflow,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ paPrimingOutput

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++typedef unsigned long PaStreamCallbackFlags;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** In a stream opened with paFramesPerBufferUnspecified, indicates that

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ input data is all silence (zeros) because no real data is available. In a

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ stream opened without paFramesPerBufferUnspecified, it indicates that one or

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ more zero samples have been inserted into the input buffer to compensate

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ for an input underflow.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamCallbackFlags

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++#define paInputUnderflow   ((PaStreamCallbackFlags) 0x00000001)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** In a stream opened with paFramesPerBufferUnspecified, indicates that data

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ prior to the first sample of the input buffer was discarded due to an

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ overflow, possibly because the stream callback is using too much CPU time.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ Otherwise indicates that data prior to one or more samples in the

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ input buffer was discarded.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamCallbackFlags

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++#define paInputOverflow    ((PaStreamCallbackFlags) 0x00000002)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Indicates that output data (or a gap) was inserted, possibly because the

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ stream callback is using too much CPU time.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamCallbackFlags

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++#define paOutputUnderflow  ((PaStreamCallbackFlags) 0x00000004)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

<span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Indicates that output data will be discarded because no room is available.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamCallbackFlags

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++#define paOutputOverflow   ((PaStreamCallbackFlags) 0x00000008)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Some of all of the output data will be used to prime the stream, input

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ data may be zero.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamCallbackFlags

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++#define paPrimingOutput    ((PaStreamCallbackFlags) 0x00000010)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/**

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ Allowable return values for the PaStreamCallback.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamCallback

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++typedef enum PaStreamCallbackResult

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++{

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    paContinue=0,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    paComplete=1,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    paAbort=2

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++} PaStreamCallbackResult;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/**

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ Functions of type PaStreamCallback are implemented by PortAudio clients.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ They consume, process or generate audio in response to requests from an

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ active PortAudio stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param input and @param output are arrays of interleaved samples,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the format, packing and number of channels used by the buffers are

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ determined by parameters to Pa_OpenStream().

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param frameCount The number of sample frames to be processed by

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ the stream callback.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param timeInfo The time in seconds when the first sample of the input

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ buffer was received at the audio input, the time in seconds when the first

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ sample of the output buffer will begin being played at the audio output, and

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ the time in seconds when the stream callback was called.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ See also Pa_GetStreamTime()

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param statusFlags Flags indicating whether input and/or output buffers

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ have been inserted or will be dropped to overcome underflow or overflow

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ conditions.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param userData The value of a user supplied pointer passed to

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ Pa_OpenStream() intended for storing synthesis data etc.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ The stream callback should return one of the values in the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ PaStreamCallbackResult enumeration. To ensure that the callback continues

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ to be called, it should return paContinue (0). Either paComplete or paAbort

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ can be returned to finish stream processing, after either of these values is

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ returned the callback will not be called again. If paAbort is returned the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ stream will finish as soon as possible. If paComplete is returned, the stream

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ will continue until all buffers generated by the callback have been played.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ This may be useful in applications such as soundfile players where a specific

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ duration of output is required. However, it is not necessary to utilise this

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ mechanism as Pa_StopStream(), Pa_AbortStream() or Pa_CloseStream() can also

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ be used to stop the stream. The callback must always fill the entire output

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ buffer irrespective of its return value.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see Pa_OpenStream, Pa_OpenDefaultStream

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @note With the exception of Pa_GetStreamCpuLoad() it is not permissable to call

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ PortAudio API functions from within the stream callback.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++typedef int PaStreamCallback(

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    const void *input, void *output,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    unsigned long frameCount,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    const PaStreamCallbackTimeInfo* timeInfo,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    PaStreamCallbackFlags statusFlags,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    void *userData );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

<span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Opens a stream for either input, output or both.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param stream The address of a PaStream pointer which will receive

<span style='display:block; white-space:pre;background:#e0ffe0;'>+  a pointer to the newly opened stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param inputParameters A structure that describes the input parameters used by

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ the opened stream. See PaStreamParameters for a description of these parameters.

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ inputParameters must be NULL for output-only streams.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param outputParameters A structure that describes the output parameters used by

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ the opened stream. See PaStreamParameters for a description of these parameters.

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ outputParameters must be NULL for input-only streams.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+  

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- inputDevice is the id of the device used for input (see PaDeviceID above.)

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- inputDevice may be paNoDevice to indicate that an input device is not required.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- numInputChannels is the number of channels of sound to be delivered to the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- callback. It can range from 1 to the value of maxInputChannels in the

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- PaDeviceInfo record for the device specified by the inputDevice parameter.

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- If inputDevice is paNoDevice numInputChannels is ignored.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- inputSampleFormat is the sample format of inputBuffer provided to the callback

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- function. inputSampleFormat may be any of the formats described by the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- PaSampleFormat enumeration (see above). PortAudio guarantees support for

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- the device's native formats (nativeSampleFormats in the device info record)

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- and additionally 16 and 32 bit integer and 32 bit floating point formats.

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- Support for other formats is implementation defined.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- inputDriverInfo is a pointer to an optional driver specific data structure

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- containing additional information for device setup or stream processing.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- inputDriverInfo is never required for correct operation. If not used

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- inputDriverInfo should be NULL.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- outputDevice is the id of the device used for output (see PaDeviceID above.)

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- outputDevice may be paNoDevice to indicate that an output device is not required.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- numOutputChannels is the number of channels of sound to be supplied by the

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- callback. See the definition of numInputChannels above for more details.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- outputSampleFormat is the sample format of the outputBuffer filled by the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- callback function. See the definition of inputSampleFormat above for more

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- details.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- outputDriverInfo is a pointer to an optional driver specific data structure

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- containing additional information for device setup or stream processing.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- outputDriverInfo is never required for correct operation. If not used

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- outputDriverInfo should be NULL.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- sampleRate is the desired sampleRate. For full-duplex streams it is the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param sampleRate The desired sampleRate. For full-duplex streams it is the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+  sample rate for both input and output

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- framesPerBuffer is the length in sample frames of all internal sample buffers

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- used for communication with platform specific audio routines. Wherever

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- possible this corresponds to the framesPerBuffer parameter passed to the

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- callback function.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- numberOfBuffers is the number of buffers used for multibuffered communication

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- with the platform specific audio routines. If you pass zero, then an optimum

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- value will be chosen for you internally. This parameter is provided only

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- as a guide - and does not imply that an implementation must use multibuffered

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- i/o when reliable double buffering is available (such as SndPlayDoubleBuffer()

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- on the Macintosh.)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- streamFlags may contain a combination of flags ORed together.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- These flags modify the behaviour of the streaming process. Some flags may only

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- be relevant to certain buffer formats.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- callback is a pointer to a client supplied function that is responsible

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- for processing and filling input and output buffers (see above for details.)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- userData is a client supplied pointer which is passed to the callback

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- function. It could for example, contain a pointer to instance data necessary

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- for processing the audio buffers.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- return value:

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- Upon success Pa_OpenStream() returns PaNoError and places a pointer to a

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- valid PortAudioStream in the stream argument. The stream is inactive (stopped).

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- If a call to Pa_OpenStream() fails a non-zero error code is returned (see

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- PaError above) and the value of stream is invalid.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param framesPerBuffer The number of frames passed to the stream callback

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ function, or the preferred block granularity for a blocking read/write stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ The special value paFramesPerBufferUnspecified (0) may be used to request that

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the stream callback will recieve an optimal (and possibly varying) number of

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ frames based on host requirements and the requested latency settings.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ Note: With some host APIs, the use of non-zero framesPerBuffer for a callback

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ stream may introduce an additional layer of buffering which could introduce

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ additional latency. PortAudio guarantees that the additional latency

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ will be kept to the theoretical minimum however, it is strongly recommended

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ that a non-zero framesPerBuffer value only be used when your algorithm

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ requires a fixed number of frames per stream callback.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ 

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param streamFlags Flags which modify the behaviour of the streaming process.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ This parameter may contain a combination of flags ORed together. Some flags may

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ only be relevant to certain buffer formats.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param streamCallback A pointer to a client supplied function that is responsible

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ for processing and filling input and output buffers. If this parameter is NULL

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the stream will be opened in 'blocking read/write' mode. In blocking mode,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the client can receive sample data using Pa_ReadStream and write sample data

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ using Pa_WriteStream, the number of samples that may be read or written

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ without blocking is returned by Pa_GetStreamReadAvailable and

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ Pa_GetStreamWriteAvailable respectively.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-PaError Pa_OpenStream( PortAudioStream** stream,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                       PaDeviceID inputDevice,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                       int numInputChannels,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                       PaSampleFormat inputSampleFormat,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                       void *inputDriverInfo,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                       PaDeviceID outputDevice,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                       int numOutputChannels,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                       PaSampleFormat outputSampleFormat,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                       void *outputDriverInfo,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param userData A client supplied pointer which is passed to the stream callback

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ function. It could for example, contain a pointer to instance data necessary

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ for processing the audio buffers. This parameter is ignored if streamCallback

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ is NULL.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ Upon success Pa_OpenStream() returns paNoError and places a pointer to a

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ valid PaStream in the stream argument. The stream is inactive (stopped).

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ If a call to Pa_OpenStream() fails, a non-zero error code is returned (see

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ PaError for possible error codes) and the value of stream is invalid.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamParameters, PaStreamCallback, Pa_ReadStream, Pa_WriteStream,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ Pa_GetStreamReadAvailable, Pa_GetStreamWriteAvailable

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_OpenStream( PaStream** stream,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++                       const PaStreamParameters *inputParameters,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++                       const PaStreamParameters *outputParameters,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                        double sampleRate,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                        unsigned long framesPerBuffer,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                       unsigned long numberOfBuffers,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                        PaStreamFlags streamFlags,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                       PortAudioCallback *callback,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++                       PaStreamCallback *streamCallback,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                        void *userData );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-/*

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_OpenDefaultStream() is a simplified version of Pa_OpenStream() that opens

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- the default input and/or output devices. Most parameters have identical meaning

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- to their Pa_OpenStream() counterparts, with the following exceptions:

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- If either numInputChannels or numOutputChannels is 0 the respective device

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- is not opened. This has the same effect as passing paNoDevice in the device

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- arguments to Pa_OpenStream().

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** A simplified version of Pa_OpenStream() that opens the default input

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ and/or output devices.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param stream The address of a PaStream pointer which will receive

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ a pointer to the newly opened stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+  

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- sampleFormat applies to both the input and output buffers.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param numInputChannels  The number of channels of sound that will be supplied

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ to the stream callback or returned by Pa_ReadStream. It can range from 1 to

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the value of maxInputChannels in the PaDeviceInfo record for the default input

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ device. If 0 the stream is opened as an output-only stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param numOutputChannels The number of channels of sound to be delivered to the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ stream callback or passed to Pa_WriteStream. It can range from 1 to the value

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ of maxOutputChannels in the PaDeviceInfo record for the default output dvice.

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ If 0 the stream is opened as an output-only stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param sampleFormat The sample format of both the input and output buffers

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ provided to the callback or passed to and from Pa_ReadStream and Pa_WriteStream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ sampleFormat may be any of the formats described by the PaSampleFormat

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ enumeration.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ 

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param sampleRate Same as Pa_OpenStream parameter of the same name.

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param framesPerBuffer Same as Pa_OpenStream parameter of the same name.

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param streamCallback Same as Pa_OpenStream parameter of the same name.

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param userData Same as Pa_OpenStream parameter of the same name.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return As for Pa_OpenStream

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-PaError Pa_OpenDefaultStream( PortAudioStream** stream,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see Pa_OpenStream, PaStreamCallback

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_OpenDefaultStream( PaStream** stream,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                               int numInputChannels,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                               int numOutputChannels,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                               PaSampleFormat sampleFormat,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                               double sampleRate,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                               unsigned long framesPerBuffer,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                              unsigned long numberOfBuffers,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-                              PortAudioCallback *callback,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++                              PaStreamCallback *streamCallback,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+                               void *userData );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-/*

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_CloseStream() closes an audio stream, flushing any pending buffers.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Closes an audio stream. If the audio stream is active it

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ discards any pending buffers as if Pa_AbortStream() had been called.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_CloseStream( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-PaError Pa_CloseStream( PortAudioStream* );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-/*

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_StartStream() and Pa_StopStream() begin and terminate audio processing.

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_StopStream() waits until all pending audio buffers have been played.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_AbortStream() stops playing immediately without waiting for pending

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Functions of type PaStreamFinishedCallback are implemented by PortAudio 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ clients. They can be registered with a stream using the Pa_SetStreamFinishedCallback

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ function. Once registered they are called when the stream becomes inactive

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ (ie once a call to Pa_StopStream() will not block).

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ A stream will become inactive after the stream callback returns non-zero,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ or when Pa_StopStream or Pa_AbortStream is called. For a stream providing audio

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ output, if the stream callback returns paComplete, or Pa_StopStream is called,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the stream finished callback will not be called until all generated sample data

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ has been played.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param userData The userData parameter supplied to Pa_OpenStream()

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see Pa_SetStreamFinishedCallback

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++typedef void PaStreamFinishedCallback( void *userData );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Register a stream finished callback function which will be called when the 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ stream becomes inactive. See the description of PaStreamFinishedCallback for 

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ further details about when the callback will be called.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param stream a pointer to a PaStream that is in the stopped state - if the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ stream is not stopped, the stream's finished callback will remain unchanged 

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ and an error code will be returned.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param streamFinishedCallback a pointer to a function with the same signature

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ as PaStreamFinishedCallback, that will be called when the stream becomes

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ inactive. Passing NULL for this parameter will un-register a previously

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ registered stream finished callback function.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return on success returns paNoError, otherwise an error code indicating the cause

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ of the error.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamFinishedCallback

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_SetStreamFinishedCallback( PaStream *stream, PaStreamFinishedCallback* streamFinishedCallback ); 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

<span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Commences audio processing.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_StartStream( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Terminates audio processing. It waits until all pending

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ audio buffers have been played before it returns.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_StopStream( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Terminates audio processing immediately without waiting for pending

<span style='display:block; white-space:pre;background:#e0ffe0;'>+  buffers to complete.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-    

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_AbortStream( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-PaError Pa_StartStream( PortAudioStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-PaError Pa_StopStream( PortAudioStream *stream );

<span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Determine whether the stream is stopped.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ A stream is considered to be stopped prior to a successful call to

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ Pa_StartStream and after a successful call to Pa_StopStream or Pa_AbortStream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ If a stream callback returns a value other than paContinue the stream is NOT

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ considered to be stopped.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-PaError Pa_AbortStream( PortAudioStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return Returns one (1) when the stream is stopped, zero (0) when

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the stream is running or, a PaErrorCode (which are always negative) if

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ PortAudio is not initialized or an error is encountered.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-/*

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_StreamActive() returns one (1) when the stream is active (ie playing

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- or recording audio), zero (0) when not playing, or a negative error number

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- if the stream is invalid.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- The stream is active between calls to Pa_StartStream() and Pa_StopStream(),

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- but may also become inactive if the callback returns a non-zero value.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- In the latter case, the stream is considered inactive after the last

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- buffer has finished playing.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see Pa_StopStream, Pa_AbortStream, Pa_IsStreamActive

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_IsStreamStopped( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-PaError Pa_StreamActive( PortAudioStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-/*

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_StreamTime() returns the current output time in samples for the stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- This time may be used as a time reference (for example synchronizing audio to

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- MIDI).

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

<span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Determine whether the stream is active.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ A stream is active after a successful call to Pa_StartStream(), until it

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ becomes inactive either as a result of a call to Pa_StopStream() or

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ Pa_AbortStream(), or as a result of a return value other than paContinue from

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the stream callback. In the latter case, the stream is considered inactive

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ after the last buffer has finished playing.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return Returns one (1) when the stream is active (ie playing or recording

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ audio), zero (0) when not playing or, a PaErrorCode (which are always negative)

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ if PortAudio is not initialized or an error is encountered.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see Pa_StopStream, Pa_AbortStream, Pa_IsStreamStopped

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_IsStreamActive( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-PaTimestamp Pa_StreamTime( PortAudioStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-/*

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_GetCPULoad() returns the CPU Load for the stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- The "CPU Load" is a fraction of total CPU time consumed by the stream's

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

<span style='display:block; white-space:pre;background:#e0ffe0;'>++/** A structure containing unchanging information about an open stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see Pa_GetStreamInfo

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++typedef struct PaStreamInfo

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++{

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    /** this is struct version 1 */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    int structVersion;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    /** The input latency of the stream in seconds. This value provides the most

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     accurate estimate of input latency available to the implementation. It may

<span style='display:block; white-space:pre;background:#e0ffe0;'>++     differ significantly from the suggestedLatency value passed to Pa_OpenStream().

<span style='display:block; white-space:pre;background:#e0ffe0;'>++     The value of this field will be zero (0.) for output-only streams.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     @see PaTime

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    PaTime inputLatency;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    /** The output latency of the stream in seconds. This value provides the most

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     accurate estimate of output latency available to the implementation. It may

<span style='display:block; white-space:pre;background:#e0ffe0;'>++     differ significantly from the suggestedLatency value passed to Pa_OpenStream().

<span style='display:block; white-space:pre;background:#e0ffe0;'>++     The value of this field will be zero (0.) for input-only streams.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     @see PaTime

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    PaTime outputLatency;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    /** The sample rate of the stream in Hertz (samples per second). In cases

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     where the hardware sample rate is inaccurate and PortAudio is aware of it,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     the value of this field may be different from the sampleRate parameter

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     passed to Pa_OpenStream(). If information about the actual hardware sample

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     rate is not available, this field will have the same value as the sampleRate

<span style='display:block; white-space:pre;background:#e0ffe0;'>++     parameter passed to Pa_OpenStream().

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    double sampleRate;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++    

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++} PaStreamInfo;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Retrieve a pointer to a PaStreamInfo structure containing information

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ about the specified stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return A pointer to an immutable PaStreamInfo structure. If the stream

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ parameter invalid, or an error is encountered, the function returns NULL.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param stream A pointer to an open stream previously created with Pa_OpenStream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @note PortAudio manages the memory referenced by the returned pointer,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the client must not manipulate or free the memory. The pointer is only

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ guaranteed to be valid until the specified stream is closed.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaStreamInfo

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++const PaStreamInfo* Pa_GetStreamInfo( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Determine the current time for the stream according to the same clock used

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ to generate buffer timestamps. This time may be used for syncronising other

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ events to the audio stream, for example synchronizing audio to MIDI.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++                                        

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return The stream's current time in seconds, or 0 if an error occurred.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @see PaTime, PaStreamCallback

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaTime Pa_GetStreamTime( PaStream *stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

<span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Retrieve CPU usage information for the specified stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ 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:#e0ffe0;'>+  audio processing routines including, but not limited to the client supplied

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- callback.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- A value of 0.5 would imply that PortAudio and the sound generating

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- callback was consuming roughly 50% of the available CPU time.

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- This function may be called from the callback function or the application.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ stream callback. This function does not work with blocking read/write streams.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ This function may be called from the stream callback function or the

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ application.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++     

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ A floating point value, typically between 0.0 and 1.0, where 1.0 indicates

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ that the stream callback is consuming the maximum number of CPU cycles possible

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ to maintain real-time operation. A value of 0.5 would imply that PortAudio and

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the stream callback was consuming roughly 50% of the available CPU time. The

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ 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:#e0ffe0;'>++ blocking read/write stream, or if an error occurrs.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++double Pa_GetStreamCpuLoad( PaStream* stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-double Pa_GetCPULoad( PortAudioStream* stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-/*

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_GetMinNumBuffers() returns the minimum number of buffers required by

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- the current host based on minimum latency.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- On the PC, for the DirectSound implementation, latency can be optionally set

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- by user by setting an environment variable.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- For example, to set latency to 200 msec, put:

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-    set PA_MIN_LATENCY_MSEC=200

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- in the AUTOEXEC.BAT file and reboot.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- If the environment variable is not set, then the latency will be determined

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- based on the OS. Windows NT has higher latency than Win95.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Read samples from an input stream. The function doesn't return until

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ the entire buffer has been filled - this may involve waiting for the operating

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ system to supply the data.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param stream A pointer to an open stream previously created with Pa_OpenStream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+  

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param buffer A pointer to a buffer of sample frames. The buffer contains

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ samples in the format specified by the inputParameters->sampleFormat field

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ used to open the stream, and the number of channels specified by

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ inputParameters->numChannels. If non-interleaved samples were requested,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ buffer is a pointer to the first element of an array of non-interleaved

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ buffer pointers, one for each channel.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param frames The number of frames to be read into buffer. This parameter

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ is not constrained to a specific range, however high performance applications

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ will want to match this parameter to the framesPerBuffer parameter used

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ when opening the stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return On success PaNoError will be returned, or PaInputOverflowed if input

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ data was discarded by PortAudio after the previous call and before this call.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_ReadStream( PaStream* stream,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++                       void *buffer,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++                       unsigned long frames );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-int Pa_GetMinNumBuffers( int framesPerBuffer, double sampleRate );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-/*

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_Sleep() puts the caller to sleep for at least 'msec' milliseconds.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- You may sleep longer than the requested time so don't rely on this for

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- accurate musical timing.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_Sleep() is provided as a convenience for authors of portable code (such as

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- the tests and examples in the PortAudio distribution.)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Write samples to an output stream. This function doesn't return until the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ entire buffer has been consumed - this may involve waiting for the operating

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ system to consume the data.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param stream A pointer to an open stream previously created with Pa_OpenStream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param buffer A pointer to a buffer of sample frames. The buffer contains

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ samples in the format specified by the outputParameters->sampleFormat field

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ used to open the stream, and the number of channels specified by

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ outputParameters->numChannels. If non-interleaved samples were requested,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ buffer is a pointer to the first element of an array of non-interleaved

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ buffer pointers, one for each channel.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @param frames The number of frames to be written from buffer. This parameter

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ is not constrained to a specific range, however high performance applications

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ will want to match this parameter to the framesPerBuffer parameter used

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ when opening the stream.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return On success PaNoError will be returned, or paOutputUnderflowed if

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ additional output data was inserted after the previous call and before this

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ call.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++PaError Pa_WriteStream( PaStream* stream,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++                        const void *buffer,

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++                        unsigned long frames );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-void Pa_Sleep( long msec );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-/*

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- Pa_GetSampleSize() returns the size in bytes of a single sample in the

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+- supplied PaSampleFormat, or paSampleFormatNotSupported if the format is

<span style='display:block; white-space:pre;background:#e0ffe0;'>+- no supported.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-  

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Retrieve the number of frames that can be read from the stream without

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ waiting.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return Returns a non-negative value representing the maximum number of frames

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ that can be read from the stream without blocking or busy waiting or, a

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ PaErrorCode (which are always negative) if PortAudio is not initialized or an

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ error is encountered.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++signed long Pa_GetStreamReadAvailable( PaStream* stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Retrieve the number of frames that can be written to the stream without

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ waiting.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return Returns a non-negative value representing the maximum number of frames

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ that can be written to the stream without blocking or busy waiting or, a

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ PaErrorCode (which are always negative) if PortAudio is not initialized or an

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ error is encountered.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++signed long Pa_GetStreamWriteAvailable( PaStream* stream );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/* Miscellaneous utilities */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

<span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Retrieve the size of a given sample format in bytes.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ @return The size in bytes of a single sample in the specified format,

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ or paSampleFormatNotSupported if the format is not supported.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ PaError Pa_GetSampleSize( PaSampleFormat format );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++/** Put the caller to sleep for at least 'msec' milliseconds. This function is

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ provided only as a convenience for authors of portable code (such as the tests

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ and examples in the PortAudio distribution.)

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++ The function may sleep longer than requested so don't rely on this for accurate

<span style='display:block; white-space:pre;background:#e0ffe0;'>++ musical timing.

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++*/

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++void Pa_Sleep( long msec );

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ #ifdef __cplusplus

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ }

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ #endif /* __cplusplus */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-#endif /* PORT_AUDIO_H */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++#endif /* PORTAUDIO_H */

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+diff -ruEN orig/speech.h src/speech.h

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+--- orig/speech.h  2020-06-25 22:03:43.000000000 +0700

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++++ src/speech.h   2020-06-23 13:38:50.000000000 +0700

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+@@ -47,7 +47,7 @@

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ //#define ESPEAK_API  extern "C"

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ #ifdef LIBRARY

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-#define USE_ASYNC

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++//#define USE_ASYNC

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ #endif

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ #ifdef _ESPEAKEDIT

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+diff -ruEN orig/synthdata.cpp src/synthdata.cpp

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+--- orig/synthdata.cpp     2020-06-25 22:03:43.000000000 +0700

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++++ src/synthdata.cpp      2020-06-23 13:38:50.000000000 +0700

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+@@ -35,7 +35,7 @@

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ #include "translate.h"

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ #include "wave.h"

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-const char *version_string = "1.48.03  04.Mar.14";

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>++const char *version_string = "1.48.04  06.04.2014";

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ const int version_phdata  = 0x014801;

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 

</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ int option_device_number = -1;

</span></pre><pre style='margin:0'>

</pre>