summaryrefslogtreecommitdiff
path: root/portaudio/doc/src/tutorial/tutorial_start.dox
diff options
context:
space:
mode:
authorsanine <sanine.not@pm.me>2022-08-27 23:52:56 -0500
committersanine <sanine.not@pm.me>2022-08-27 23:52:56 -0500
commita4dd0ad63c00f4dee3b86dfd3075d1d61b2b3180 (patch)
tree13bd5bfa15e6fea2a12f176bae79adf9c6fd0933 /portaudio/doc/src/tutorial/tutorial_start.dox
parentbde3e4f1bb7b8f8abca0884a7d994ee1c17a66b1 (diff)
add plibsys
Diffstat (limited to 'portaudio/doc/src/tutorial/tutorial_start.dox')
-rw-r--r--portaudio/doc/src/tutorial/tutorial_start.dox61
1 files changed, 0 insertions, 61 deletions
diff --git a/portaudio/doc/src/tutorial/tutorial_start.dox b/portaudio/doc/src/tutorial/tutorial_start.dox
deleted file mode 100644
index 42fa4bf..0000000
--- a/portaudio/doc/src/tutorial/tutorial_start.dox
+++ /dev/null
@@ -1,61 +0,0 @@
-/** @page tutorial_start PortAudio Tutorials
-@ingroup tutorial
-
-These tutorials takes you through a hands-on example of using PortAudio to make sound. If you'd prefer to start with a top-down overview of the PortAudio API, check out the @ref api_overview.
-
-@section tut_start1 Downloading
-
-First thing you need to do is download the PortAudio source code either <a href="http://www.portaudio.com/download.html">as a tarball from the website</a>, or <a href="http://www.portaudio.com/usingsvn.html">from the Subversion Repository</a>.
-
-@section tut_start2 Compiling
-
-Once you've downloaded PortAudio you'll need to compile it, which of course, depends on your environment:
-
- - Windows
- - \ref compile_windows
- - \ref compile_windows_mingw
- - \ref compile_windows_asio_msvc
- - Mac OS X
- - \ref compile_mac_coreaudio
- - POSIX
- - \ref compile_linux
-
-You can also use CMake to generate project files for PortAudio on Windows, OS X or Linux or include PortAudio easily in your own CMake project. See \ref compile_cmake.
-
-Many platforms with GCC/make can use the simple ./configure && make combination and simply use the resulting libraries in their code.
-
-@section tut_start3 Programming with PortAudio
-
-Below are the steps to writing a PortAudio application using the callback technique:
-
- - Write a callback function that will be called by PortAudio when audio processing is needed.
- - Initialize the PA library and open a stream for audio I/O.
- - Start the stream. Your callback function will be now be called repeatedly by PA in the background.
- - In your callback you can read audio data from the inputBuffer and/or write data to the outputBuffer.
- - Stop the stream by returning 1 from your callback, or by calling a stop function.
- - Close the stream and terminate the library.
-
-In addition to this "Callback" architecture, V19 also supports a "Blocking I/O" model which uses read and write calls which may be more familiar to non-audio programmers. Note that at this time, not all APIs support this functionality.
-
-In this tutorial, we'll show how to use the callback architecture to play a sawtooth wave. Much of the tutorial is taken from the file paex_saw.c, which is part of the PortAudio distribution. When you're done with this tutorial, you'll be armed with the basic knowledge you need to write an audio program. If you need more sample code, look in the "examples" and "test" directory of the PortAudio distribution. Another great source of info is the portaudio.h Doxygen page, which documents the entire V19 API.
-Also see the page for <a href="https://github.com/PortAudio/portaudio/wiki/Tips">tips on programming PortAudio</a>
-on the PortAudio wiki.
-
-@section tut_start4 Programming Tutorial Contents
-
-- \ref writing_a_callback
-- \ref initializing_portaudio
-- \ref open_default_stream
-- \ref start_stop_abort
-- \ref terminating_portaudio
-- \ref utility_functions
-- \ref querying_devices
-- \ref blocking_read_write
-
-If you are upgrading from V18, you may want to look at the <a href="http://www.portaudio.com/docs/proposals/index.html">Proposed Enhancements to PortAudio</a>, which describes the differences between V18 and V19.
-
-Once you have a basic understanding of how to use PortAudio, you might be interested in \ref exploring.
-
-Next: \ref writing_a_callback
-
-*/