The cl-portaudio Reference Manual

Table of Contents

Next: , Previous: , Up: (dir)   [Contents][Index]

The cl-portaudio Reference Manual

This is the cl-portaudio Reference Manual, version 1.0.0, generated automatically by Declt version 2.4 "Will Decker" on Wed Jun 20 11:19:21 2018 GMT+0.


Next: , Previous: , Up: Top   [Contents][Index]

1 Introduction

CL-PortAudio

This package contains bindings to http://portaudio.com/. PortAudio is a free, cross-platform, open-source, audio I/O library.

Installation:
(ql:quickload :cl-portaudio)

Test:
(ql:quickload :cl-portaudio-tests)
(portaudio-tests:test-read-write-echo)

Depends on:
cffi
ffa

It probably works on all systems, that are supported by cffi (cl), ffa (cl), and portaudio.

Tested on:
SBCL 1.0.54 mt, archlinux x86_64
SBCL 1.0.54 mswinmt, windows 7 x86_64 (vbox)
SBCL 1.0.55 mt, Mac OS X 10.6.8 x86 (thanks Žiga Lenarčič).

See doc/documentation.pdf|index.html or WIKI.

Binary PortAudio packages can be downloaded from here (thanks a lot, racket developers): 
http://planet.plt-scheme.org/display.ss?package=portaudio.plt&owner=clements  -> source browse -> directories lib

Licence: MIT

Author: Michael Filonenko
E-mail: filonenko.mikhail at gmail dot com


Next: , Previous: , Up: Top   [Contents][Index]

2 Systems

The main system appears first, followed by any subsystem dependency.


Previous: , Up: Systems   [Contents][Index]

2.1 cl-portaudio

Author

Michael Filonenko <filonenko.mikhail@gmail.com>

License

MIT

Description

This package contains bindings to @a[http://portaudio.com/]{PortAudio}. PortAudio is a free, cross-platform, open-source, audio I/O library.

Version

1.0.0

Dependencies
Source

cl-portaudio.asd (file)

Component

src (module)


Next: , Previous: , Up: Top   [Contents][Index]

3 Modules

Modules are listed depth-first from the system components tree.


Previous: , Up: Modules   [Contents][Index]

3.1 cl-portaudio/src

Parent

cl-portaudio (system)

Location

src/

Components

Next: , Previous: , Up: Top   [Contents][Index]

4 Files

Files are sorted by type and then listed depth-first from the systems components trees.


Previous: , Up: Files   [Contents][Index]

4.1 Lisp


Next: , Previous: , Up: Lisp files   [Contents][Index]

4.1.1 cl-portaudio.asd

Location

cl-portaudio.asd

Systems

cl-portaudio (system)


Next: , Previous: , Up: Lisp files   [Contents][Index]

4.1.2 cl-portaudio/src/package.lisp

Parent

src (module)

Location

src/package.lisp

Packages

portaudio


Previous: , Up: Lisp files   [Contents][Index]

4.1.3 cl-portaudio/src/portaudio.lisp

Dependency

package.lisp (file)

Parent

src (module)

Location

src/portaudio.lisp

Exported Definitions
Internal Definitions

Next: , Previous: , Up: Top   [Contents][Index]

5 Packages

Packages are listed by definition order.


Previous: , Up: Packages   [Contents][Index]

5.1 portaudio

This package contains bindings to @a[http://portaudio.com/]{PortAudio}. PortAudio is a free, cross-platform, open-source, audio I/O library.

Binary PortAudio packages can be founded here:
@a{http://planet.plt-scheme.org/display.ss?package=portaudio.plt&owner=clements} -> source browse -> directories lib

@begin[Installation and Usage]{section}
@begin{pre}
git clone –depth 1 https://github.com/filonenko-mikhail/cl-portaudio.git
emacs
M+x slime
(ql:quickload :cl-portaudio)
(ql:quickload :cl-portaudio-tests)
(portaudio-tests:test-read-write-echo)
@end{pre}
@end{section}

@begin[Example]{section}
@begin{pre}
(use-package :portaudio)

(defconstant +frames-per-buffer+ 1024)
(defconstant +sample-rate+ 44100d0)
(defconstant +seconds+ 15)
(defconstant +sample-format+ :float)
(defconstant +num-channels+ 2)

(defun test-read-write-converted-echo ()
"Record input into an array; Separate array to channels; Merge channels into array; Play last array."
(with-audio
(format t "~%=== Wire on. Will run ~D seconds . ===~%" +seconds+)
(with-default-audio-stream (astream +num-channels+ +num-channels+ :sample-format +sample-format+ :sample-rate +sample-rate+ :frames-per-buffer +frames-per-buffer+)
(dotimes (i (round (/ (* +seconds+ +sample-rate+) +frames-per-buffer+)))
(write-stream astream
(merge-channels-into-array astream
(separate-array-to-channels astream
(read-stream astream))))))))
@end{pre}

@aboutfun{with-audio}
@aboutfun{with-default-audio-stream}
@aboutfun{read-stream}
@aboutfun{separate-array-to-channels}
@aboutfun{merge-channels-into-array}
@aboutfun{write-stream}

@b{Note}
ignore-errors is used for ignoring output-underflowed error.

@end{section}
@begin[Introduction]{section}
PortAudio provides a uniform application programming interface (API) across all supported platforms. You can think of the PortAudio library as a wrapper that converts calls to the PortAudio API into calls to platform-specific native audio APIs. Operating systems often offer more than one native audio API and some APIs (such as JACK) may be available on multiple target operating systems. PortAudio supports all the major native audio APIs on each supported platform. The diagram below illustrates the relationship between your application, PortAudio, and the supported native audio APIs:

@a[./img/portaudio-external-architecture-diagram.png]{Image}

PortAudio provides a uniform interface to native audio APIs. However, it doesn’t always provide totally uniform functionality. There are cases where PortAudio is limited by the capabilities of the underlying native audio API. For example, PortAudio doesn’t provide sample rate conversion if you request a sample rate that is not supported by the native audio API. Another example is that the ASIO SDK only allows one device to be open at a time, so PortAudio/ASIO doesn’t currently support opening multiple ASIO devices simultaneously.
@end{section}
@begin[Key abstractions: Host APIs, Devices and Streams]{section}
The PortAudio processing model includes three main abstractions: Host APIs, audio Devices and audio Streams.

Host APIs represent platform-specific native audio APIs. Some examples of Host APIs are Core Audio on Mac OS, WMME and DirectSound on Windows and OSS and ALSA on Linux. The diagram in the previous section shows many of the supported native APIs. Sometimes it’s useful to know which Host APIs you’re dealing with, but it is easy to use PortAudio without ever interacting directly with the Host API abstraction.

Devices represent individual hardware audio interfaces or audio ports on the host platform. Devices have names and certain capabilities such as supported sample rates and the number of supported input and output channels. PortAudio provides functions to enumerate available Devices and to query for Device capabilities.

Streams manage active audio input and output from and to Devices. Streams may be half duplex (input or output) or full duplex (simultaneous input and output). Streams operate at a specific sample rate with particular sample formats, buffer sizes and internal buffering latencies. You specify these parameters when you open the Stream. Audio data is communicated between a Stream and your application via a user provided asynchronous callback function or by invoking synchronous read and write functions.

PortAudio supports audio input and output in a variety of sample formats: 8, 16, 24 and 32 bit integer formats and 32 bit floating point, irrespective of the formats supported by the native audio API. PortAudio also supports multichannel buffers in both interleaved and non-interleaved (separate buffer per channel) formats and automatically performs conversion when necessary. If requested, PortAudio can clamp out-of range samples and/or dither to a native format.

The PortAudio API offers the following functionality:
@begin{itemize}
@item{Initialize and terminate the library}
@item{Enumerate available Host APIs}
@item{Enumerate available Devices either globally, or within each Host API}
@item{Discover default or recommended Devices and Device settings}
@item{Discover Device capabilities such as supported audio data formats and sample rates}
@item{Create and control audio Streams to acquire audio from and output audio to Devices}
@item{Provide Stream timing information to support synchronising audio with other parts of your application}
@item{Retrieve version and error information.}
@end{itemize}
These functions are described in more detail below.

@end{section}
@begin[Initialisation, termination and utility functions]{section}
The PortAudio library must be initialized before it can be used and terminated to clean up afterwards. You initialize PortAudio by calling @fun{initialize} and clean up by calling @fun{terminate}. There is @fun{with-audio} macro that does environment.

You can query PortAudio for version information using @fun{get-version} to get a numeric version number and @fun{get-version-text} to get a string.

The size in bytes of the various sample formats represented by the sample-format enumeration can be obtained using @fun{get-sample-size}.

@fun{pa-sleep} sleeps for a specified number of milliseconds. This isn’t intended for use in production systems; it’s provided only as a simple portable way to implement tests and examples where the main thread sleeps while audio is acquired or played by an asynchronous callback function.
@end{section}
@begin[Host APIs]{section}
A Host API acts as a top-level grouping for all of the Devices offered by a single native platform audio API. Each Host API has a unique type identifier, a name, zero or more Devices, and nominated default input and output Devices.

Host APIs are usually referenced by index: an integer of type host-api-index that ranges between zero and @code{(- (@fun{get-host-api-count}) 1)}. You can enumerate all available Host APIs by counting across this range.

You can retrieve the index of the default Host API by calling @fun{get-default-host-api}.

Information about a Host API, such as it’s name and default devices, is stored in a @class{host-api-info} structure. You can retrieve a pointer to a particular Host API’s @class{host-api-info} structure by calling @fun{get-host-api-info} with the Host API’s index as a parameter.

Most PortAudio functions reference Host APIs by @fun{host-api-index} indices. Each Host API also has a unique type identifier defined in the host-api-type-id enumeration. You can call @fun{host-api-type-id-to-host-api-index} to retrieve the current host-api-index for a particular host-api-type-id.
@end{section}
@begin[Devices]{section}
A Device represents an audio endpoint provided by a particular native audio API. This usually corresponds to a specific input or output port on a hardware audio interface, or to the interface as a whole. Each Host API operates independently, so a single physical audio port may be addressable via different Devices exposed by different Host APIs.

A Device has a name, is associated with a Host API, and has a maximum number of supported input and output channels. PortAudio provides recommended default latency values and a default sample rate for each Device. To obtain more detailed information about device capabilities you can call @fun{is-format-supported} to query whether it is possible to open a Stream using particular Devices, parameters and sample rate.

Although each Device conceptually belongs to a specific Host API, most PortAudio functions and data structures refer to Devices using a global, Host API-independent index of type device-index – an integer of that ranges between zero and @code{(- (@fun{get-device-count}) 1)}. The reasons for this are partly historical but it also makes it easy for applications to ignore the Host API abstraction and just work with Devices and Streams.

If you want to enumerate Devices belonging to a particular Host API you can count between 0 and @code{(- (@fun{host-api-info-device-count}) 1)}. You can convert this Host API-specific index value to a global device-index value by calling @fun{host-api-device-index-to-device-index}.

Information about a Device is stored in a PaDeviceInfo structure. You can retrieve @class{device-info} structure by calling @fun{get-device-info} with the Device’s index as a parameter.

You can retrieve the indices of the global default input and output devices using @fun{get-default-input-device} and @fun{get-default-output-device}. Default Devices for each Host API are stored in the Host API’s @class{host-api-info} structures.

For an example of enumerating devices and printing information about their capabilities see the @fun{print-devices} function.
@end{section}
@begin[Streams]{section}
A Stream represents an active flow of audio data between your application and one or more audio Devices. A Stream operates at a specific sample rate with specific sample formats and buffer sizes.
@end{section}
@begin[Opening and Closing Streams]{section}
You call @fun{open-stream} to open a Stream, specifying the Device(s) to use, the number of input and output channels, sample formats, suggested latency values and flags that control dithering, clipping and overflow handling. You specify many of these parameters in two @class{stream-parameters} structures, one for input and one for output.

Devices may be full duplex (supporting simultaneous input and output) or half duplex (supporting input or output) – usually this reflects the structure of the underlying native audio API. When opening a Stream you can specify one full duplex Device for both input and output, or two different Devices for input and output. Some Host APIs only support full-duplex operation with a full-duplex device (e.g. ASIO) but most are able to aggregate two half duplex devices into a full duplex Stream. PortAudio requires that all devices specified in a call to @fun{open-stream} belong to the same Host API.

A successful call to @fun{open-stream} creates a pointer to a @class{pa-stream} – an opaque handle representing the open Stream. All PortAudio API functions that operate on open Streams take a pointer to a @class{pa-stream} as their first parameter.

PortAudio also provides @fun{open-default-stream} – a simpler alternative to @fun{open-stream} which you can use when you want to open the default audio Device(s) with default latency parameters.

You call @fun{close-stream} close a Stream when you’ve finished using it.

There are two macros to simplify work with stream: @fun{with-audio-stream} and @fun{with-default-audio-stream}. These macros open and start stream at the beginning and stop and close stream at the end. Body is protected by unwind-protect.
@end{section}
@begin[Starting and Stopping Streams]{section}
Newly opened Streams are initially stopped. You call @fun{start-stream} to start a Stream. You can stop a running Stream using @fun{stop-stream} or @fun{abort-stream} (the Stop function plays out all internally queued audio data, while Abort tries to stop as quickly as possible). An open Stream can be started and stopped multiple times. You can call @fun{is-stream-stopped} to query whether a Stream is running or stopped.
@end{section}
@begin[The Read/Write I/O Method]{section}
PortAudio provides a synchronous read/write interface for acquiring and playing audio.

To write audio data to a Stream call @fun{write-stream} and to read data call @fun{read-stream}. These functions will block if the internal buffers are full, making them safe to call in a tight loop. If you want to avoid blocking you can query the amount of available read or write space using @fun{get-stream-read-available} or @fun{get-stream-write-available}.

For examples of the read/write I/O method see the following examples in the /t directory of the PortAudio distribution: tests.lisp (@fun{portaudio-tests:test-read-write-converted-echo}).
@end{section}
@begin[Retreiving Stream Information]{section}
You can retrieve information about an open Stream by calling @fun{get-stream-info}. This returns a @class{stream-info} structure containing the actual input and output latency and sample rate of the stream. It’s possible for these values to be different from the suggested values passed to @fun{open-stream}.
@end{section}
@begin[Error Handling]{section}
Most PortAudio functions invokes signal. Possible conditions are described in pa-error enum. Some functions return values greater than or equal to zero for normal results.

PortAudio usually tries to translate error conditions into portable pa-error error codes. However if an unexpected error is encountered the unanticipated-host-error code may be returned. In this case a further mechanism is provided to query for Host API-specific error information. If PortAudio throws unanticipated-host-error you can call @fun{get-last-host-error-info} to retrieve a @class{host-error-info} structure that provides more information, including the Host API that encountered the error, a native API error code and error text.
@end{section}
@begin[Conditions]{section}
There are conditions, that are translated from PaError.
@begin{itemize}
@item{not-anticipated}
@item{unanticipated-host-error}
@item{invalid-channel-count}
@item{invalid-sample-rate}
@item{invalid-device}
@item{invalid-flag}
@item{sample-format-not-supported}
@item{bad-i-o-device-combination}
@item{insufficient-memory}
@item{buffer-too-big}
@item{buffer-too-small}
@item{null-callback}
@item{bad-stream-ptr}
@item{timed-out}
@item{internal-error}
@item{device-unavailable}
@item{incompatible-host-api-specific-stream-info}
@item{stream-is-stopped}
@item{stream-is-not-stopped}
@item{input-overflowed}
@item{output-underflowed}
@item{host-api-not-found}
@item{invalid-host-api}
@item{can-not-read-from-a-callback-stream}
@item{can-not-write-to-a-callback-stream}
@item{can-not-read-from-an-output-only-stream}
@item{can-not-write-to-an-input-only-stream}
@item{incompatible-stream-host-api}
@item{bad-buffer-ptr}
@end{itemize}
@end{section}
@begin[Bitfields]{section}
@b{sample-format}
@begin{itemize}
@item{:float}
@end{itemize}
@b{stream-flags}
@begin{itemize}
@item{:no-flag}
@item{:clip-off}
@item{:dither-off}
@end{itemize}
@end{section}
@begin[Enums]{section}
@b{host-api-type-id}
@begin{itemize}
@item{:in-development}
@item{:direct-sound}
@item{:mme}
@item{:asio}
@item{:sound-manager}
@item{:core-audio}
@item{:oss}
@item{:alsa}
@item{:al}
@item{:be-os}
@item{:wdmks}
@item{:jack}
@item{:wasapi}
@item{:audio-science-hpi}
@end{itemize}
@end{section}

Source

package.lisp (file)

Nickname

pa

Use List
Exported Definitions
Internal Definitions

Next: , Previous: , Up: Top   [Contents][Index]

6 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.


Next: , Previous: , Up: Definitions   [Contents][Index]

6.1 Exported definitions


Next: , Previous: , Up: Exported definitions   [Contents][Index]

6.1.1 Macros

Macro: with-audio &body BODY

Execute body in PortAudio initialize/terminate environment.

Package

portaudio

Source

portaudio.lisp (file)

Macro: with-audio-stream (VAR INPUT-PARAMETERS OUTPUT-PARAMETERS &key SAMPLE-RATE FRAMES-PER-BUFFER STREAM-FLAGS) &body BODY

Execute body with opened and started stream VAR and shut down
the stream after it is done. It is required use these macro in with-audio or initialize/terminate environment.

Package

portaudio

Source

portaudio.lisp (file)

Macro: with-default-audio-stream (VAR NUM-INPUT NUM-OUTPUT &key SAMPLE-FORMAT SAMPLE-RATE FRAMES-PER-BUFFER) &body BODY

Execute body with opened and started stream VAR and shut down
the stream after it is done. It is required use these macro in with-audio or initialize/terminate environment.

Package

portaudio

Source

portaudio.lisp (file)


Next: , Previous: , Up: Exported definitions   [Contents][Index]

6.1.2 Functions

Function: abort-stream PA-STREAM

Terminates audio processing immediately without waiting for pending buffers to complete.

Package

portaudio

Source

portaudio.lisp (file)

Function: close-stream PA-STREAM

Closes an audio stream. If the audio stream is active it discards any pending buffers as if @fun{abort-stream} had been called.

Package

portaudio

Source

portaudio.lisp (file)

Function: get-default-host-api ()

Retrieve the index of the default host API. The default host API will be the lowest common denominator host API on
the current platform and is unlikely to provide the best performance.

@begin{return}
A non-negative value ranging from 0 to @code{(- (@fun{get-host-api-count}) 1)} indicating the default host API index or, raises an error if PortAudio is not initialized or an error is encountered. @end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-default-input-device ()

Retrieve the index of the default input device. The result can be used in the inputDevice parameter to @fun{open-stream}.
@begin{return}
The default input device index for the default host API, or raise no-device if no default input device is available or an error was encountered. @end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-default-output-device ()

Retrieve the index of the default output device. The result can be used in the outputDevice parameter to @fun{open-stream}.

@b{Note}

On the PC, the user can specify a default device by setting an environment variable. For example, to use device #1.

@pre{set PA_RECOMMENDED_OUTPUT_DEVICE=1}

The user should first determine the available device ids by using @code{(@fun{print-devices})}.

@begin{return}
The default output device index for the default host API, or raise no-device if no default output device is available or an error was encountered. @end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-device-count ()

Retrieve the number of available devices.The number of available devices may be zero.
@begin{return}
A non-negative value indicating the number of available devices or, raises an error if PortAudio is not initialized or an error is encountered. @end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-device-info DEVICE

Retrieve @class{device-info} structure containing information about the specified device.

@begin{return}
A object of @class{device-info}. If the device parameter is out of range the function returns NIL. @end{return}

@arg[device]{A valid device index in the range 0 to @code{(- (@fun{get-device-count}) 1)}}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-host-api-count ()

Retrieve the number of available host APIs. Even if a host API is available it may have no devices available.
@begin{return}
A non-negative value indicating the number of available host APIs or, raises an error if PortAudio is not initialized or an error is encountered. @end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-host-api-info HOST-API

Retrieve a pointer to a structure containing information about a specific host Api.

@begin[host-api]{arg}
A valid host API index ranging from 0 to @code{(- (@fun{get-host-api-count}) 1)}
@end{arg}

@begin{return}
An object of @class{host-api-info} describing a specific host API. If the hostApi parameter is out of range or an error is encountered, the function returns NIL. @end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-sample-size FORMAT

Retrieve the size of a given sample format in bytes.
@result{The size in bytes of a single sample in the specified format, or paSampleFormatNotSupported if the format is not supported.}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-stream-info PA-STREAM

Retrieve a object of class @class{stream-info} containing information about the specified stream.

@begin{return}
A object of @class{stream-info} structure. If the stream parameter invalid, or an error is encountered, the function returns NIL. @end{return}

@arg[pa-stream]{A object of stream previously created with @fun{open-stream}.}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-stream-read-available PA-STREAM

Retrieve the number of frames that can be read from the stream without waiting.

@begin{return}
Returns a non-negative value representing the maximum number of frames that can be read from the stream without blocking or busy waiting or, raises an error if PortAudio is not initialized or an error is encountered. @end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-stream-time PA-STREAM

Returns valid time values for the entire life of the stream, from when the stream is opened until it is closed. Starting and stopping the stream does not affect the passage of time returned by get-stream-time.

This time may be used for synchronizing other events to the audio stream, for example synchronizing audio to MIDI.

@result{The stream’s current time in seconds, or 0 if an error occurred.}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-stream-write-available PA-STREAM

Retrieve the number of frames that can be written to the stream without waiting.

@begin{return}
A non-negative value representing the maximum number of frames that can be written to the stream without blocking or busy waiting or, raises an error if PortAudio is not initialized or an error is encountered. @end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: get-version ()

Retrieve the release number of the currently running PortAudio build, eg 1900.

Package

portaudio

Source

portaudio.lisp (file)

Function: get-version-text ()

Retrieve a textual description of the current PortAudio build, eg "PortAudio V19-devel 13 October 2002".

Package

portaudio

Source

portaudio.lisp (file)

Function: host-api-device-index-to-device-index HOST-API HOST-API-DEVICE-INDEX

Convert a host-API-specific device index to standard PortAudio device index. This function may be used in conjunction with the deviceCount field of PaHostApiInfo to enumerate all devices for the specified host API.

@arg[host-api]{A valid host API index ranging from 0 to @code{(- (@fun{get-host-api-count}) 1)}}
@arg[host-api-device-index]{A valid per-host device index in the range 0 to @code{(- (@fun{host-api-info-device-count} (@fun{get-host-api-info} host-api)) 1)}}

@begin{return}
A non-negative index ranging from 0 to @code{(- (@fun{get-device-count}) 1)} or, raises an error if PortAudio is not initialized or an error is encountered.
@end{return}

A invalid-host-api error indicates that the host API index specified by the hostApi parameter is out of range.

A invalid-device error indicates that the host-api-device-index parameter is out of range.

Package

portaudio

Source

portaudio.lisp (file)

Function: host-api-type-id-to-host-api-index TYPE

Convert a static host API unique identifier, into a runtime host API index.
@arg[type]{A unique host API identifier belonging to the PaHostApiTypeId enumeration.}

@begin{return}
A valid host-api-idnex ranging from 0 to @code{(- (@fun{get-host-api-count}) 1)} or, raises an error if PortAudio is not initialized or @end{return}

The host-api-not-found error indicates that the host API specified by the type parameter is not available.

Package

portaudio

Source

portaudio.lisp (file)

Function: initialize ()

Library initialization function - call this before using PortAudio. This function initializes internal data structures and prepares underlying host APIs for use. With the exception of @fun{get-version}, @fun{get-version-text}, and @fun{get-error-text}, this function MUST be called before using any other PortAudio API functions.

If initialize is called multiple times, each successful call must be matched with a corresponding call to @fun{terminate}. Pairs of calls to initialize/@fun{terminate} may overlap, and are not required to be fully nested.

Note that if initialize raises an error, @fun{terminate} should NOT be called.

@result{NIL if successful, otherwise raises an error indicating the cause of failure.}

Package

portaudio

Source

portaudio.lisp (file)

Function: is-stream-active PA-STREAM

Determine whether the stream is active. A stream is active after a successful call to @fun{start-stream}, until it becomes inactive either as a result of a call to @fun{stop-stream} or @fun{abort-stream}. In the latter case, the stream is considered inactive after the last buffer has finished playing.

@begin{return}
Returns one (1) when the stream is active (ie playing or recording audio), zero (0) when not playing or, raises an error if PortAudio is not initialized or an error is encountered.
@end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: is-stream-stopped PA-STREAM

Determine whether the stream is stopped. A stream is considered to be stopped prior to a successful call to @fun{start-stream} and after a successful call to @fun{stop-stream} or @fun{abort-stream}.

@begin{return}
Returns one (1) when the stream is stopped, zero (0) when the stream is running or, raises an error if PortAudio is not initialized or an error is encountered.
@end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: make-stream-parameters ()

Make stream-parameters object

Package

portaudio

Source

portaudio.lisp (file)

Function: merge-channels-into-array PA-STREAM CHANNELS

Merge subarrays of (channelcount)-dimensional array to flat array.

@arg[pa-stream]{A object of stream previously created with @fun{open-stream}.} @arg[channels]{Vector of vectors of floats, that contains data for all sound channels.}

@begin{return}
Vector of data, that can be used with @fun{write-stream}.
@end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: open-default-stream NUM-INPUT NUM-OUTPUT SAMPLE-FORMAT SAMPLE-RATE FRAMES-PER-BUFFER

A simplified version of @fun{open-stream} that opens the default input and/or output devices.

@arg[num-input-channels]{The number of channels of sound that will be returned by @fun{read-stream}. It can range from 1 to the value of max-input-channels in the @class{device-info} class for the default input device. If 0 the stream is opened as an output-only stream.} @arg[num-output-channels]{The number of channels of sound to be passed to @fun{write-stream}. It can range from 1 to the value of max-output-channels in the @class{device-info} class for the default output device. If 0 the stream is opened as an output-only stream.} @arg[sample-format]{The sample format of both the input and output buffers passed to and from @fun{read-stream} and @fun{write-stream}. sample-format may be any of the formats described by the sample-format enumeration.}
@arg[sample-rate]{Same as @fun{open-stream} parameter of the same name.}
@arg[frames-per-buffer]{Same as @fun{open-stream} parameter of the same name.}

@result{As for @fun{open-stream}}

Package

portaudio

Source

portaudio.lisp (file)

Function: open-stream INPUT-PARAMETERS OUTPUT-PARAMETERS SAMPLE-RATE FRAMES-PER-BUFFER STREAM-FLAGS

Opens a stream for either input, output or both.

@arg[input-parameters]{A structure that describes the input parameters used by the opened stream. See @class{stream-parameters} for a description of these parameters. input-parameters must be NIL for output-only streams.} @arg[output-parameters]{A structure that describes the output parameters used by the opened stream. See @class{stream-parameters} for a description of these parameters. output-parameters must be NIL for input-only streams.} @arg[sample-rate]{The desired sample-rate. For full-duplex streams it is the sample rate for both input and output}
@arg[frames-per-buffer]{Preferred block granularity for a blocking read/write stream.}
@arg[stream-flags]{List of flags which modify the behavior of the streaming process. Some flags may only be relevant to certain buffer formats.}

@begin{return}
Upon success pen-stream returns object of @class{pa-stream} class. The stream is inactive (stopped). If a call to open-stream fails, an error code is raised and the value of stream is NIL.
@end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: pa-sleep MSEC

Put the caller to sleep for at least ’msec’ milliseconds. This function is provided only as a convenience for authors of portable code (such as the tests and examples in the PortAudio distribution.)

The function may sleep longer than requested so don’t rely on this for accurate musical timing.

Package

portaudio

Source

portaudio.lisp (file)

Function: print-devices ()

List available sound devices, including device information.

Package

portaudio

Source

portaudio.lisp (file)

Function: read-stream PA-STREAM

Read samples from an input stream. The function doesn’t return until the entire buffer has been filled - this may involve waiting for the operating system to supply the data. Size of returned array equal to @code{(* frames-per-buffer channel-count)}.

@arg[pa-stream]{A object of stream previously created with @fun{open-stream}.}

@begin{return}
On success array of data will be returned, or :input-overflowed if input data was discarded by PortAudio after the previous call and before this call.
@end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: read-stream-into-array PA-STREAM ARRAY

Read samples from an input stream. The function doesn’t return until the entire buffer has been filled - this may involve waiting for the operating system to supply the data.

@arg[pa-stream]{A object of stream previously created with @fun{open-stream}.}
@arg[array]{Simple array with has element-type equal to sample-format from @fun{open-stream}. Size of array equal to @code{(* frames-per-buffer channel-count)}.}

@begin{return}
On success NIL will be returned, or :input-overflowed if input data was discarded by PortAudio after the previous call and before this call.
@end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: separate-array-to-channels PA-STREAM ARRAY

Separate flat array

@arg[pa-stream]{A object of stream previously created with @fun{open-stream}.} @arg[array]{Flat array, that is received from @fun{read-stream}.}

@begin{return}
(channelcount)-dimensional array of single-floats
@end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: start-stream PA-STREAM

Commences audio processing.

Package

portaudio

Source

portaudio.lisp (file)

Function: terminate ()

Library termination function - call this when finished using PortAudio. This function deallocates all resources allocated by PortAudio since it was initialized by a call to @fun{initialize}. In cases where @fun{initialize} has been called multiple times, each call must be matched with a corresponding call to terminate. The final matching call to terminate will automatically close any PortAudio streams that are still open.

terminate MUST be called before exiting a program which uses PortAudio. Failure to do so may result in serious resource leaks, such as audio devices not being available until the next reboot.

@begin{return}
NIL if successful, otherwise raises an error indicating the cause of failure.
@end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: write-stream PA-STREAM BUFFER

Write samples to an output stream. This function doesn’t return until the entire buffer has been consumed - this may involve waiting for the operating system to consume the data. Size of buffer should be equal to @code{(* frames-per-buffer channel-count)}.

@arg[pa-stream]{A object of stream previously created with @fun{open-stream}.}
@arg[buffer]{A array of sample frames. The buffer contains samples in the format specified by the @code{(stream-parameters-sample-format output-parameters)} field used to open the stream, and the number of channels specified by @code{(stream-parameters-num-channels output-parameters)}.}

@begin{return}
On success NIL will be returned, or :output-underflowed if additional output data was inserted after the previous call and before this call.
@end{return}

Package

portaudio

Source

portaudio.lisp (file)


Next: , Previous: , Up: Exported definitions   [Contents][Index]

6.1.3 Generic functions

Generic Function: device-info-default-high-input-latency INSTANCE

Default latency values for robust non-interactive applications (eg. playing sound files).

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: device-info-default-high-input-latency (DEVICE-INFO device-info)

Default latency values for robust non-interactive applications (eg. playing sound files).

Generic Function: device-info-default-high-output-latency INSTANCE
Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: device-info-default-high-output-latency (DEVICE-INFO device-info)
Generic Function: device-info-default-low-input-latency INSTANCE

Default latency values for interactive performance.

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: device-info-default-low-input-latency (DEVICE-INFO device-info)

Default latency values for interactive performance.

Generic Function: device-info-default-low-output-latency INSTANCE
Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: device-info-default-low-output-latency (DEVICE-INFO device-info)
Generic Function: device-info-default-sample-rate INSTANCE

Sample rate

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: device-info-default-sample-rate (DEVICE-INFO device-info)

Sample rate

Generic Function: device-info-host-api INSTANCE

note this is a host API index, not a type id.

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: device-info-host-api (DEVICE-INFO device-info)

note this is a host API index, not a type id.

Generic Function: device-info-max-input-channels INSTANCE

maximum number of input channels

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: device-info-max-input-channels (DEVICE-INFO device-info)
Generic Function: device-info-max-output-channels INSTANCE

maximum number of output channels

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: device-info-max-output-channels (DEVICE-INFO device-info)

automatically generated reader method

Generic Function: device-info-name INSTANCE

device name

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: device-info-name (DEVICE-INFO device-info)

Device name.

Generic Function: host-api-info-default-input-device INSTANCE

The default input device for this host API. The value will be a device index ranging from 0 to (- (get-device-count) 1), or no-device if no default input device is available.

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: host-api-info-default-input-device (HOST-API-INFO host-api-info)

The default input device for this host API. The value will be a device index ranging from 0 to (- (get-device-count) 1), or no-device if no default input device is available.

Generic Function: host-api-info-default-output-device INSTANCE

The default output device for this host API. The value will be a device index ranging from 0 to (- (get-device-count) 1), or paNoDevice if no default output device is available.

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: host-api-info-default-output-device (HOST-API-INFO host-api-info)

The default output device for this host API. The value will be a device index ranging from 0 to (- (get-device-count) 1), or paNoDevice if no default output device is available.

Generic Function: host-api-info-device-count INSTANCE

The number of devices belonging to this host API. This field may be used in conjunction with host-api-device-index-to-device-index to enumerate all devices for this host API.

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: host-api-info-device-count (HOST-API-INFO host-api-info)

The number of devices belonging to this host API. This field may be used in conjunction with host-api-device-index-to-device-index to enumerate all devices for this host API.

Generic Function: host-api-info-name INSTANCE

A textual description of the host API for display on user interfaces.

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: host-api-info-name (HOST-API-INFO host-api-info)

A textual description of the host API for display on user interfaces.

Generic Function: host-api-info-type INSTANCE

The well known unique identifier of this host API.

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: host-api-info-type (HOST-API-INFO host-api-info)

The well known unique identifier of this host API.

Generic Function: host-error-info-error-code INSTANCE

the error code returned

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: host-error-info-error-code (HOST-ERROR-INFO host-error-info)

the error code returned

Generic Function: host-error-info-error-text INSTANCE

a textual description of the error if available, otherwise a zero-length string

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: host-error-info-error-text (HOST-ERROR-INFO host-error-info)

a textual description of the error if available, otherwise a zero-length string

Generic Function: host-error-info-host-api-type INSTANCE

the host API which returned the error code

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: host-error-info-host-api-type (HOST-ERROR-INFO host-error-info)

the host API which returned the error code

Generic Function: pa-stream-frames-per-buffer INSTANCE

Frames per buffer for current stream

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: pa-stream-frames-per-buffer (PA-STREAM pa-stream)

Frames per buffer

Generic Function: pa-stream-input-channels INSTANCE

Number of input channels

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: pa-stream-input-channels (PA-STREAM pa-stream)

Number of input channels

Generic Function: pa-stream-input-sample-format INSTANCE

value of sample-format for input channel

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: pa-stream-input-sample-format (PA-STREAM pa-stream)

Format of input samples

Generic Function: pa-stream-output-channels INSTANCE

Number of output channels

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: pa-stream-output-channels (PA-STREAM pa-stream)

Number of output channels

Generic Function: pa-stream-output-sample-format INSTANCE

value of sample-format for output channel

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: pa-stream-output-sample-format (PA-STREAM pa-stream)

Format of output samples

Generic Function: stream-info-input-latency INSTANCE

The input latency of the stream in seconds. This value provides the most accurate estimate of input latency available to the implementation. It may differ significantly from the suggestedLatency value passed to open-stream. The value of this field will be zero (0.) for output-only streams.

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: stream-info-input-latency (STREAM-INFO stream-info)

The input latency of the stream in seconds. This value provides the most accurate estimate of input latency available to the implementation. It may differ significantly from the suggestedLatency value passed to open-stream. The value of this field will be zero (0.) for output-only streams.

Generic Function: stream-info-output-latency INSTANCE

The output latency of the stream in seconds. This value provides the most accurate estimate of output latency available to the implementation. It may differ significantly from the suggestedLatency value passed to open-stream. The value of this field will be zero (0.) for input-only streams.

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: stream-info-output-latency (STREAM-INFO stream-info)

The output latency of the stream in seconds. This value provides the most accurate estimate of output latency available to the implementation. It may differ significantly from the suggestedLatency value passed to open-stream. The value of this field will be zero (0.) for input-only streams.

Generic Function: stream-info-sample-rate INSTANCE

The sample rate of the stream in Hertz (samples per second). In cases where the hardware sample rate is inaccurate and PortAudio is aware of it, the value of this field may be different from the sample-rate parameter passed to open-stream. If information about the actual hardware sample rate is not available, this field will have the same value as the sample-rate parameter passed to open-stream.

Package

portaudio

Source

portaudio.lisp (file)

Methods
Method: stream-info-sample-rate (STREAM-INFO stream-info)

The sample rate of the stream in Hertz (samples per second). In cases where the hardware sample rate is inaccurate and PortAudio is aware of it, the value of this field may be different from the sample-rate parameter passed to open-stream. If information about the actual hardware sample rate is not available, this field will have the same value as the sample-rate parameter passed to open-stream.

Generic Function: stream-parameters-channel-count INSTANCE

The number of channels of sound to be delivered to the stream callback.

Package

portaudio

Source

portaudio.lisp (file)

Writer

(setf stream-parameters-channel-count) (generic function)

Methods
Method: stream-parameters-channel-count (STREAM-PARAMETERS stream-parameters)

The number of channels of sound to be delivered to the stream callback.

Generic Function: (setf stream-parameters-channel-count) NEW-VALUE OBJECT
Package

portaudio

Reader

stream-parameters-channel-count (generic function)

Methods
Method: (setf stream-parameters-channel-count) NEW-VALUE (STREAM-PARAMETERS stream-parameters)

The number of channels of sound to be delivered to the stream callback.

Source

portaudio.lisp (file)

Generic Function: stream-parameters-device INSTANCE

A valid device index in the range 0 to @code{(- (@fun{get-device-count}) 1)} specifying the device to be used. This field must not be set to paNoDevice.

Package

portaudio

Source

portaudio.lisp (file)

Writer

(setf stream-parameters-device) (generic function)

Methods
Method: stream-parameters-device (STREAM-PARAMETERS stream-parameters)

A valid device index in the range 0 to (- get-device-count 1) specifying the device to be used. This field must not be set to paNoDevice.

Generic Function: (setf stream-parameters-device) NEW-VALUE OBJECT
Package

portaudio

Reader

stream-parameters-device (generic function)

Methods
Method: (setf stream-parameters-device) NEW-VALUE (STREAM-PARAMETERS stream-parameters)

A valid device index in the range 0 to (- get-device-count 1) specifying the device to be used. This field must not be set to paNoDevice.

Source

portaudio.lisp (file)

Generic Function: stream-parameters-sample-format INSTANCE

The sample format of the buffer provided to read-stream or write-stream.

Package

portaudio

Source

portaudio.lisp (file)

Writer

(setf stream-parameters-sample-format) (generic function)

Methods
Method: stream-parameters-sample-format (STREAM-PARAMETERS stream-parameters)

The sample format of the buffer provided to read-stream or write-stream.

Generic Function: (setf stream-parameters-sample-format) NEW-VALUE OBJECT
Package

portaudio

Reader

stream-parameters-sample-format (generic function)

Methods
Method: (setf stream-parameters-sample-format) NEW-VALUE (STREAM-PARAMETERS stream-parameters)

The sample format of the buffer provided to read-stream or write-stream.

Source

portaudio.lisp (file)

Generic Function: stream-parameters-suggested-latency INSTANCE

The desired latency in seconds. Where practical, implementations should configure their latency based on these parameters, otherwise they may choose the closest viable latency instead. Unless the suggested latency is greater than the absolute upper limit for the device implementations should round the suggestedLatency up to the next practical value - ie to provide an equal or higher latency than suggestedLatency wherever possible.

Package

portaudio

Source

portaudio.lisp (file)

Writer

(setf stream-parameters-suggested-latency) (generic function)

Methods
Method: stream-parameters-suggested-latency (STREAM-PARAMETERS stream-parameters)

The desired latency in seconds. Where practical, implementations should configure their latency based on these parameters, otherwise they may choose the closest viable latency instead. Unless the suggested latency is greater than the absolute upper limit for the device implementations should round the suggestedLatency up to the next practical value - ie to provide an equal or higher latency than suggestedLatency wherever possible.

Generic Function: (setf stream-parameters-suggested-latency) NEW-VALUE OBJECT
Package

portaudio

Reader

stream-parameters-suggested-latency (generic function)

Methods
Method: (setf stream-parameters-suggested-latency) NEW-VALUE (STREAM-PARAMETERS stream-parameters)

The desired latency in seconds. Where practical, implementations should configure their latency based on these parameters, otherwise they may choose the closest viable latency instead. Unless the suggested latency is greater than the absolute upper limit for the device implementations should round the suggestedLatency up to the next practical value - ie to provide an equal or higher latency than suggestedLatency wherever possible.

Source

portaudio.lisp (file)


Previous: , Up: Exported definitions   [Contents][Index]

6.1.4 Classes

Class: device-info ()

A structure providing information and capabilities of PortAudio devices. Devices may support input, output or both input and output.

Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

standard-object (class)

Direct methods
Direct slots
Slot: struct-version

Structure version.

Readers

device-info-struct-version (generic function)

Slot: name

Device name.

Readers

device-info-name (generic function)

Slot: host-api

note this is a host API index, not a type id.

Readers

device-info-host-api (generic function)

Slot: max-input-channels
Readers

device-info-max-input-channels (generic function)

Slot: max-output-channels
Readers

device-info-max-output-channels (generic function)

Slot: default-low-input-latency

Default latency values for interactive performance.

Readers

device-info-default-low-input-latency (generic function)

Slot: default-low-output-latency
Readers

device-info-default-low-output-latency (generic function)

Slot: default-high-input-latency

Default latency values for robust non-interactive applications (eg. playing sound files).

Readers

device-info-default-high-input-latency (generic function)

Slot: p
Slot: default-high-output-latency
Readers

device-info-default-high-output-latency (generic function)

Slot: default-sample-rate

Sample rate

Readers

device-info-default-sample-rate (generic function)

Class: host-api-info ()

A structure containing information about a particular host API.

Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

standard-object (class)

Direct methods
Direct slots
Slot: struct-version

Struct version.

Readers

host-api-info-struct-version (generic function)

Slot: type

The well known unique identifier of this host API.

Readers

host-api-info-type (generic function)

Slot: name

A textual description of the host API for display on user interfaces.

Readers

host-api-info-name (generic function)

Slot: device-count

The number of devices belonging to this host API. This field may be used in conjunction with host-api-device-index-to-device-index to enumerate all devices for this host API.

Readers

host-api-info-device-count (generic function)

Slot: default-input-device

The default input device for this host API. The value will be a device index ranging from 0 to (- (get-device-count) 1), or no-device if no default input device is available.

Readers

host-api-info-default-input-device (generic function)

Slot: default-output-device

The default output device for this host API. The value will be a device index ranging from 0 to (- (get-device-count) 1), or paNoDevice if no default output device is available.

Readers

host-api-info-default-output-device (generic function)

Class: host-error-info ()

Structure used to return information about a host error condition.

Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

standard-object (class)

Direct methods
Direct slots
Slot: host-api-type

the host API which returned the error code

Readers

host-error-info-host-api-type (generic function)

Slot: error-code

the error code returned

Readers

host-error-info-error-code (generic function)

Slot: error-text

a textual description of the error if available, otherwise a zero-length string

Readers

host-error-info-error-text (generic function)

Class: pa-stream ()

A single PaStream can provide multiple channels of real-time streaming audio input and output to a client application. A stream provides access to audio hardware represented by one or more devices. Depending on the underlying Host API, it may be possible to open multiple streams using the same device, however this behavior is implementation defined. Portable applications should assume that a device may be simultaneously used by at most one stream.

Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

standard-object (class)

Direct methods
Direct slots
Slot: handle

Foreign pointer to pa-stream

Initargs

:handle

Initform

(cffi-sys:null-pointer)

Readers

pa-stream-handle (generic function)

Writers

(setf pa-stream-handle) (generic function)

Slot: input-sample-format

Format of input samples

Initargs

:input-sample-format

Readers

pa-stream-input-sample-format (generic function)

Slot: input-channels

Number of input channels

Initargs

:input-channels

Readers

pa-stream-input-channels (generic function)

Slot: output-sample-format

Format of output samples

Initargs

:output-sample-format

Readers

pa-stream-output-sample-format (generic function)

Slot: output-channels

Number of output channels

Initargs

:output-channels

Readers

pa-stream-output-channels (generic function)

Slot: frames-per-buffer

Frames per buffer

Initargs

:frames-per-buffer

Readers

pa-stream-frames-per-buffer (generic function)

Class: stream-info ()

A structure containing unchanging information about an open stream.

Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

standard-object (class)

Direct methods
Direct slots
Slot: struct-version

Struct version

Readers

stream-info-struct-version (generic function)

Slot: input-latency

The input latency of the stream in seconds. This value provides the most accurate estimate of input latency available to the implementation. It may differ significantly from the suggestedLatency value passed to open-stream. The value of this field will be zero (0.) for output-only streams.

Readers

stream-info-input-latency (generic function)

Slot: output-latency

The output latency of the stream in seconds. This value provides the most accurate estimate of output latency available to the implementation. It may differ significantly from the suggestedLatency value passed to open-stream. The value of this field will be zero (0.) for input-only streams.

Readers

stream-info-output-latency (generic function)

Slot: sample-rate

The sample rate of the stream in Hertz (samples per second). In cases where the hardware sample rate is inaccurate and PortAudio is aware of it, the value of this field may be different from the sample-rate parameter passed to open-stream. If information about the actual hardware sample rate is not available, this field will have the same value as the sample-rate parameter passed to open-stream.

Readers

stream-info-sample-rate (generic function)

Class: stream-parameters ()

Parameters for one direction (input or output) of a stream.

Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

standard-object (class)

Direct methods
Direct slots
Slot: device

A valid device index in the range 0 to (- get-device-count 1) specifying the device to be used. This field must not be set to paNoDevice.

Readers

stream-parameters-device (generic function)

Writers

(setf stream-parameters-device) (generic function)

Slot: channel-count

The number of channels of sound to be delivered to the stream callback.

Readers

stream-parameters-channel-count (generic function)

Writers

(setf stream-parameters-channel-count) (generic function)

Slot: sample-format

The sample format of the buffer provided to read-stream or write-stream.

Readers

stream-parameters-sample-format (generic function)

Writers

(setf stream-parameters-sample-format) (generic function)

Slot: suggested-latency

The desired latency in seconds. Where practical, implementations should configure their latency based on these parameters, otherwise they may choose the closest viable latency instead. Unless the suggested latency is greater than the absolute upper limit for the device implementations should round the suggestedLatency up to the next practical value - ie to provide an equal or higher latency than suggestedLatency wherever possible.

Readers

stream-parameters-suggested-latency (generic function)

Writers

(setf stream-parameters-suggested-latency) (generic function)


Previous: , Up: Definitions   [Contents][Index]

6.2 Internal definitions


Next: , Previous: , Up: Internal definitions   [Contents][Index]

6.2.1 Constants

Constant: +format-is-supported+
Package

portaudio

Source

portaudio.lisp (file)

Constant: +frames-per-buffer-unspecified+
Package

portaudio

Source

portaudio.lisp (file)

Constant: +no-device+
Package

portaudio

Source

portaudio.lisp (file)

Constant: +use-host-api-specific-device-specification
Package

portaudio

Source

portaudio.lisp (file)


Next: , Previous: , Up: Internal definitions   [Contents][Index]

6.2.2 Macros

Macro: make-errors &rest SYMBOLS
Package

portaudio

Source

portaudio.lisp (file)


Next: , Previous: , Up: Internal definitions   [Contents][Index]

6.2.3 Functions

Function: %abort-stream PA-STREAM
Package

portaudio

Source

portaudio.lisp (file)

Function: %close-stream PA-STREAM
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-default-host-api ()
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-default-input-device ()
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-default-output-device ()
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-device-count ()
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-device-info DEVICE
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-error-text ERROR-CODE
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-host-api-count ()
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-host-api-info HOST-API
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-last-host-error-info ()
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-sample-size FORMAT
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-stream-info PA-STREAM
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-stream-read-available PA-STREAM
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-stream-time PA-STREAM
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-stream-write-available PA-STREAM
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-version ()
Package

portaudio

Source

portaudio.lisp (file)

Function: %get-version-text ()
Package

portaudio

Source

portaudio.lisp (file)

Function: %host-api-device-index-to-device-index HOST-API HOST-API-DEVICE-INDEX
Package

portaudio

Source

portaudio.lisp (file)

Function: %host-api-type-id-to-host-api-index TYPE
Package

portaudio

Source

portaudio.lisp (file)

Function: %initialize ()
Package

portaudio

Source

portaudio.lisp (file)

Function: %is-format-supported INPUT-PARAMETERS OUTPUT-PARAMETERS SAMPLE-RATE
Package

portaudio

Source

portaudio.lisp (file)

Function: %is-stream-active PA-STREAM
Package

portaudio

Source

portaudio.lisp (file)

Function: %is-stream-stopped PA-STREAM
Package

portaudio

Source

portaudio.lisp (file)

Function: %open-default-stream PA-STREAM NUM-INPUT-CHANNELS NUM-OUTPUT-CHANNELS SAMPLE-FORMAT SAMPLE-RATE FRAMES-PER-BUFFER STREAM-CALLBACK USER-DATA
Package

portaudio

Source

portaudio.lisp (file)

Function: %open-stream PA-STREAM INPUT-PARAMETERS OUTPUT-PARAMETERS SAMPLE-RATE FRAMES-PER-BUFFER STREAM-FLAGS STREAM-CALLBACK USER-DATA
Package

portaudio

Source

portaudio.lisp (file)

Function: %pa-sleep MSEC
Package

portaudio

Source

portaudio.lisp (file)

Function: %read-stream PA-STREAM BUFFER FRAMES
Package

portaudio

Source

portaudio.lisp (file)

Function: %start-stream PA-STREAM
Package

portaudio

Source

portaudio.lisp (file)

Function: %stop-stream PA-STREAM
Package

portaudio

Source

portaudio.lisp (file)

Function: %terminate ()
Package

portaudio

Source

portaudio.lisp (file)

Function: %write-stream PA-STREAM BUFFER FRAMES
Package

portaudio

Source

portaudio.lisp (file)

Function: cffi-type-to-lisp CFFI-TYPE
Package

portaudio

Source

portaudio.lisp (file)

Function: get-last-host-error-info ()

Return information about the last host error encountered. The error information returned by @fun{get-last-host-error-info} will never be modified asynchronously by errors occurring in other PortAudio owned threads.

This function is provided as a last resort, primarily to enhance debugging by providing clients with access to all available error information.

@begin{return}
A structure constraining information about the host error. The values in this structure will only be valid if a PortAudio function has previously raise the unanticipated-host-error error code.
@end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: is-format-supported INPUT-PARAMETERS OUTPUT-PARAMETERS SAMPLE-RATE

Determine whether it would be possible to open a stream with the specified parameters.

@arg[input-parameters]{A structure that describes the input parameters used to open a stream. The suggested-latency slot is ignored. See @class{stream-parameters} for a description of these parameters. input-parameters must be NIL for output-only streams.} @arg[output-parameters]{A structure that describes the output parameters used to open a stream. The suggested-latency field is ignored. See @class{stream-parameters} for a description of these parameters. output-parameters must be NIL for input-only streams.} @arg[sample-rate]{The required sampleRate. For full-duplex streams it is the sample rate for both input and output.}

@begin{return}
Returns 0 if the format is supported, and raises an error indicating why the format is not supported otherwise. The constant @variable{+format-is-supported+} is provided to compare with the return value for success.
@end{return}

Package

portaudio

Source

portaudio.lisp (file)

Function: print-supported-standard-sample-rates INPUT-PARAMS OUTPUT-PARAMS
Package

portaudio

Source

portaudio.lisp (file)

Function: raise-if-error ERR

Check err and raise condition if it is needed

Package

portaudio

Source

portaudio.lisp (file)

Function: stop-stream PA-STREAM

Terminates audio processing. It waits until all pending audio buffers have been played before it returns.

Package

portaudio

Source

portaudio.lisp (file)


Next: , Previous: , Up: Internal definitions   [Contents][Index]

6.2.4 Generic functions

Generic Function: device-info-struct-version OBJECT
Package

portaudio

Methods
Method: device-info-struct-version (DEVICE-INFO device-info)

Structure version.

Source

portaudio.lisp (file)

Generic Function: host-api-info-struct-version OBJECT
Package

portaudio

Methods
Method: host-api-info-struct-version (HOST-API-INFO host-api-info)

Struct version.

Source

portaudio.lisp (file)

Generic Function: pa-stream-handle OBJECT
Generic Function: (setf pa-stream-handle) NEW-VALUE OBJECT
Package

portaudio

Methods
Method: pa-stream-handle (PA-STREAM pa-stream)
Method: (setf pa-stream-handle) NEW-VALUE (PA-STREAM pa-stream)

Foreign pointer to pa-stream

Source

portaudio.lisp (file)

Generic Function: stream-info-struct-version OBJECT
Package

portaudio

Methods
Method: stream-info-struct-version (STREAM-INFO stream-info)

Struct version

Source

portaudio.lisp (file)


Previous: , Up: Internal definitions   [Contents][Index]

6.2.5 Classes

Class: device-info-tclass ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses
  • translatable-foreign-type (class)
  • foreign-struct-type (class)
Class: host-api-info-tclass ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses
  • translatable-foreign-type (class)
  • foreign-struct-type (class)
Class: host-error-info-tclass ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses
  • translatable-foreign-type (class)
  • foreign-struct-type (class)
Class: p-device-info ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

enhanced-foreign-type (class)

Direct methods

translate-from-foreign (method)

Direct Default Initargs
InitargValue
:actual-type(quote (:pointer))
Class: p-host-api-info ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

enhanced-foreign-type (class)

Direct methods

translate-from-foreign (method)

Direct Default Initargs
InitargValue
:actual-type(quote (:pointer))
Class: p-host-error-info ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

enhanced-foreign-type (class)

Direct methods

translate-from-foreign (method)

Direct Default Initargs
InitargValue
:actual-type(quote (:pointer))
Class: p-pa-stream ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

enhanced-foreign-type (class)

Direct methods

translate-to-foreign (method)

Direct Default Initargs
InitargValue
:actual-type(quote (:pointer))
Class: p-stream-info ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

enhanced-foreign-type (class)

Direct methods

translate-from-foreign (method)

Direct Default Initargs
InitargValue
:actual-type(quote (:pointer))
Class: p-stream-parameters ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses

enhanced-foreign-type (class)

Direct methods
  • free-translated-object (method)
  • translate-to-foreign (method)
  • translate-from-foreign (method)
Direct Default Initargs
InitargValue
:actual-type(quote (:pointer))
Class: stream-info-tclass ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses
  • translatable-foreign-type (class)
  • foreign-struct-type (class)
Class: stream-parameters-tclass ()
Package

portaudio

Source

portaudio.lisp (file)

Direct superclasses
  • translatable-foreign-type (class)
  • foreign-struct-type (class)

Previous: , Up: Top   [Contents][Index]

Appendix A Indexes


Next: , Previous: , Up: Indexes   [Contents][Index]

A.1 Concepts

Jump to:   C   F   L   M  
Index Entry  Section

C
cl-portaudio.asd: The cl-portaudio<dot>asd file
cl-portaudio/src: The cl-portaudio/src module
cl-portaudio/src/package.lisp: The cl-portaudio/src/package<dot>lisp file
cl-portaudio/src/portaudio.lisp: The cl-portaudio/src/portaudio<dot>lisp file

F
File, Lisp, cl-portaudio.asd: The cl-portaudio<dot>asd file
File, Lisp, cl-portaudio/src/package.lisp: The cl-portaudio/src/package<dot>lisp file
File, Lisp, cl-portaudio/src/portaudio.lisp: The cl-portaudio/src/portaudio<dot>lisp file

L
Lisp File, cl-portaudio.asd: The cl-portaudio<dot>asd file
Lisp File, cl-portaudio/src/package.lisp: The cl-portaudio/src/package<dot>lisp file
Lisp File, cl-portaudio/src/portaudio.lisp: The cl-portaudio/src/portaudio<dot>lisp file

M
Module, cl-portaudio/src: The cl-portaudio/src module

Jump to:   C   F   L   M  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.2 Functions

Jump to:   %   (  
A   C   D   F   G   H   I   M   O   P   R   S   T   W  
Index Entry  Section

%
%abort-stream: Internal functions
%close-stream: Internal functions
%get-default-host-api: Internal functions
%get-default-input-device: Internal functions
%get-default-output-device: Internal functions
%get-device-count: Internal functions
%get-device-info: Internal functions
%get-error-text: Internal functions
%get-host-api-count: Internal functions
%get-host-api-info: Internal functions
%get-last-host-error-info: Internal functions
%get-sample-size: Internal functions
%get-stream-info: Internal functions
%get-stream-read-available: Internal functions
%get-stream-time: Internal functions
%get-stream-write-available: Internal functions
%get-version: Internal functions
%get-version-text: Internal functions
%host-api-device-index-to-device-index: Internal functions
%host-api-type-id-to-host-api-index: Internal functions
%initialize: Internal functions
%is-format-supported: Internal functions
%is-stream-active: Internal functions
%is-stream-stopped: Internal functions
%open-default-stream: Internal functions
%open-stream: Internal functions
%pa-sleep: Internal functions
%read-stream: Internal functions
%start-stream: Internal functions
%stop-stream: Internal functions
%terminate: Internal functions
%write-stream: Internal functions

(
(setf pa-stream-handle): Internal generic functions
(setf pa-stream-handle): Internal generic functions
(setf stream-parameters-channel-count): Exported generic functions
(setf stream-parameters-channel-count): Exported generic functions
(setf stream-parameters-device): Exported generic functions
(setf stream-parameters-device): Exported generic functions
(setf stream-parameters-sample-format): Exported generic functions
(setf stream-parameters-sample-format): Exported generic functions
(setf stream-parameters-suggested-latency): Exported generic functions
(setf stream-parameters-suggested-latency): Exported generic functions

A
abort-stream: Exported functions

C
cffi-type-to-lisp: Internal functions
close-stream: Exported functions

D
device-info-default-high-input-latency: Exported generic functions
device-info-default-high-input-latency: Exported generic functions
device-info-default-high-output-latency: Exported generic functions
device-info-default-high-output-latency: Exported generic functions
device-info-default-low-input-latency: Exported generic functions
device-info-default-low-input-latency: Exported generic functions
device-info-default-low-output-latency: Exported generic functions
device-info-default-low-output-latency: Exported generic functions
device-info-default-sample-rate: Exported generic functions
device-info-default-sample-rate: Exported generic functions
device-info-host-api: Exported generic functions
device-info-host-api: Exported generic functions
device-info-max-input-channels: Exported generic functions
device-info-max-input-channels: Exported generic functions
device-info-max-output-channels: Exported generic functions
device-info-max-output-channels: Exported generic functions
device-info-name: Exported generic functions
device-info-name: Exported generic functions
device-info-struct-version: Internal generic functions
device-info-struct-version: Internal generic functions

F
Function, %abort-stream: Internal functions
Function, %close-stream: Internal functions
Function, %get-default-host-api: Internal functions
Function, %get-default-input-device: Internal functions
Function, %get-default-output-device: Internal functions
Function, %get-device-count: Internal functions
Function, %get-device-info: Internal functions
Function, %get-error-text: Internal functions
Function, %get-host-api-count: Internal functions
Function, %get-host-api-info: Internal functions
Function, %get-last-host-error-info: Internal functions
Function, %get-sample-size: Internal functions
Function, %get-stream-info: Internal functions
Function, %get-stream-read-available: Internal functions
Function, %get-stream-time: Internal functions
Function, %get-stream-write-available: Internal functions
Function, %get-version: Internal functions
Function, %get-version-text: Internal functions
Function, %host-api-device-index-to-device-index: Internal functions
Function, %host-api-type-id-to-host-api-index: Internal functions
Function, %initialize: Internal functions
Function, %is-format-supported: Internal functions
Function, %is-stream-active: Internal functions
Function, %is-stream-stopped: Internal functions
Function, %open-default-stream: Internal functions
Function, %open-stream: Internal functions
Function, %pa-sleep: Internal functions
Function, %read-stream: Internal functions
Function, %start-stream: Internal functions
Function, %stop-stream: Internal functions
Function, %terminate: Internal functions
Function, %write-stream: Internal functions
Function, abort-stream: Exported functions
Function, cffi-type-to-lisp: Internal functions
Function, close-stream: Exported functions
Function, get-default-host-api: Exported functions
Function, get-default-input-device: Exported functions
Function, get-default-output-device: Exported functions
Function, get-device-count: Exported functions
Function, get-device-info: Exported functions
Function, get-host-api-count: Exported functions
Function, get-host-api-info: Exported functions
Function, get-last-host-error-info: Internal functions
Function, get-sample-size: Exported functions
Function, get-stream-info: Exported functions
Function, get-stream-read-available: Exported functions
Function, get-stream-time: Exported functions
Function, get-stream-write-available: Exported functions
Function, get-version: Exported functions
Function, get-version-text: Exported functions
Function, host-api-device-index-to-device-index: Exported functions
Function, host-api-type-id-to-host-api-index: Exported functions
Function, initialize: Exported functions
Function, is-format-supported: Internal functions
Function, is-stream-active: Exported functions
Function, is-stream-stopped: Exported functions
Function, make-stream-parameters: Exported functions
Function, merge-channels-into-array: Exported functions
Function, open-default-stream: Exported functions
Function, open-stream: Exported functions
Function, pa-sleep: Exported functions
Function, print-devices: Exported functions
Function, print-supported-standard-sample-rates: Internal functions
Function, raise-if-error: Internal functions
Function, read-stream: Exported functions
Function, read-stream-into-array: Exported functions
Function, separate-array-to-channels: Exported functions
Function, start-stream: Exported functions
Function, stop-stream: Internal functions
Function, terminate: Exported functions
Function, write-stream: Exported functions

G
Generic Function, (setf pa-stream-handle): Internal generic functions
Generic Function, (setf stream-parameters-channel-count): Exported generic functions
Generic Function, (setf stream-parameters-device): Exported generic functions
Generic Function, (setf stream-parameters-sample-format): Exported generic functions
Generic Function, (setf stream-parameters-suggested-latency): Exported generic functions
Generic Function, device-info-default-high-input-latency: Exported generic functions
Generic Function, device-info-default-high-output-latency: Exported generic functions
Generic Function, device-info-default-low-input-latency: Exported generic functions
Generic Function, device-info-default-low-output-latency: Exported generic functions
Generic Function, device-info-default-sample-rate: Exported generic functions
Generic Function, device-info-host-api: Exported generic functions
Generic Function, device-info-max-input-channels: Exported generic functions
Generic Function, device-info-max-output-channels: Exported generic functions
Generic Function, device-info-name: Exported generic functions
Generic Function, device-info-struct-version: Internal generic functions
Generic Function, host-api-info-default-input-device: Exported generic functions
Generic Function, host-api-info-default-output-device: Exported generic functions
Generic Function, host-api-info-device-count: Exported generic functions
Generic Function, host-api-info-name: Exported generic functions
Generic Function, host-api-info-struct-version: Internal generic functions
Generic Function, host-api-info-type: Exported generic functions
Generic Function, host-error-info-error-code: Exported generic functions
Generic Function, host-error-info-error-text: Exported generic functions
Generic Function, host-error-info-host-api-type: Exported generic functions
Generic Function, pa-stream-frames-per-buffer: Exported generic functions
Generic Function, pa-stream-handle: Internal generic functions
Generic Function, pa-stream-input-channels: Exported generic functions
Generic Function, pa-stream-input-sample-format: Exported generic functions
Generic Function, pa-stream-output-channels: Exported generic functions
Generic Function, pa-stream-output-sample-format: Exported generic functions
Generic Function, stream-info-input-latency: Exported generic functions
Generic Function, stream-info-output-latency: Exported generic functions
Generic Function, stream-info-sample-rate: Exported generic functions
Generic Function, stream-info-struct-version: Internal generic functions
Generic Function, stream-parameters-channel-count: Exported generic functions
Generic Function, stream-parameters-device: Exported generic functions
Generic Function, stream-parameters-sample-format: Exported generic functions
Generic Function, stream-parameters-suggested-latency: Exported generic functions
get-default-host-api: Exported functions
get-default-input-device: Exported functions
get-default-output-device: Exported functions
get-device-count: Exported functions
get-device-info: Exported functions
get-host-api-count: Exported functions
get-host-api-info: Exported functions
get-last-host-error-info: Internal functions
get-sample-size: Exported functions
get-stream-info: Exported functions
get-stream-read-available: Exported functions
get-stream-time: Exported functions
get-stream-write-available: Exported functions
get-version: Exported functions
get-version-text: Exported functions

H
host-api-device-index-to-device-index: Exported functions
host-api-info-default-input-device: Exported generic functions
host-api-info-default-input-device: Exported generic functions
host-api-info-default-output-device: Exported generic functions
host-api-info-default-output-device: Exported generic functions
host-api-info-device-count: Exported generic functions
host-api-info-device-count: Exported generic functions
host-api-info-name: Exported generic functions
host-api-info-name: Exported generic functions
host-api-info-struct-version: Internal generic functions
host-api-info-struct-version: Internal generic functions
host-api-info-type: Exported generic functions
host-api-info-type: Exported generic functions
host-api-type-id-to-host-api-index: Exported functions
host-error-info-error-code: Exported generic functions
host-error-info-error-code: Exported generic functions
host-error-info-error-text: Exported generic functions
host-error-info-error-text: Exported generic functions
host-error-info-host-api-type: Exported generic functions
host-error-info-host-api-type: Exported generic functions

I
initialize: Exported functions
is-format-supported: Internal functions
is-stream-active: Exported functions
is-stream-stopped: Exported functions

M
Macro, make-errors: Internal macros
Macro, with-audio: Exported macros
Macro, with-audio-stream: Exported macros
Macro, with-default-audio-stream: Exported macros
make-errors: Internal macros
make-stream-parameters: Exported functions
merge-channels-into-array: Exported functions
Method, (setf pa-stream-handle): Internal generic functions
Method, (setf stream-parameters-channel-count): Exported generic functions
Method, (setf stream-parameters-device): Exported generic functions
Method, (setf stream-parameters-sample-format): Exported generic functions
Method, (setf stream-parameters-suggested-latency): Exported generic functions
Method, device-info-default-high-input-latency: Exported generic functions
Method, device-info-default-high-output-latency: Exported generic functions
Method, device-info-default-low-input-latency: Exported generic functions
Method, device-info-default-low-output-latency: Exported generic functions
Method, device-info-default-sample-rate: Exported generic functions
Method, device-info-host-api: Exported generic functions
Method, device-info-max-input-channels: Exported generic functions
Method, device-info-max-output-channels: Exported generic functions
Method, device-info-name: Exported generic functions
Method, device-info-struct-version: Internal generic functions
Method, host-api-info-default-input-device: Exported generic functions
Method, host-api-info-default-output-device: Exported generic functions
Method, host-api-info-device-count: Exported generic functions
Method, host-api-info-name: Exported generic functions
Method, host-api-info-struct-version: Internal generic functions
Method, host-api-info-type: Exported generic functions
Method, host-error-info-error-code: Exported generic functions
Method, host-error-info-error-text: Exported generic functions
Method, host-error-info-host-api-type: Exported generic functions
Method, pa-stream-frames-per-buffer: Exported generic functions
Method, pa-stream-handle: Internal generic functions
Method, pa-stream-input-channels: Exported generic functions
Method, pa-stream-input-sample-format: Exported generic functions
Method, pa-stream-output-channels: Exported generic functions
Method, pa-stream-output-sample-format: Exported generic functions
Method, stream-info-input-latency: Exported generic functions
Method, stream-info-output-latency: Exported generic functions
Method, stream-info-sample-rate: Exported generic functions
Method, stream-info-struct-version: Internal generic functions
Method, stream-parameters-channel-count: Exported generic functions
Method, stream-parameters-device: Exported generic functions
Method, stream-parameters-sample-format: Exported generic functions
Method, stream-parameters-suggested-latency: Exported generic functions

O
open-default-stream: Exported functions
open-stream: Exported functions

P
pa-sleep: Exported functions
pa-stream-frames-per-buffer: Exported generic functions
pa-stream-frames-per-buffer: Exported generic functions
pa-stream-handle: Internal generic functions
pa-stream-handle: Internal generic functions
pa-stream-input-channels: Exported generic functions
pa-stream-input-channels: Exported generic functions
pa-stream-input-sample-format: Exported generic functions
pa-stream-input-sample-format: Exported generic functions
pa-stream-output-channels: Exported generic functions
pa-stream-output-channels: Exported generic functions
pa-stream-output-sample-format: Exported generic functions
pa-stream-output-sample-format: Exported generic functions
print-devices: Exported functions
print-supported-standard-sample-rates: Internal functions

R
raise-if-error: Internal functions
read-stream: Exported functions
read-stream-into-array: Exported functions

S
separate-array-to-channels: Exported functions
start-stream: Exported functions
stop-stream: Internal functions
stream-info-input-latency: Exported generic functions
stream-info-input-latency: Exported generic functions
stream-info-output-latency: Exported generic functions
stream-info-output-latency: Exported generic functions
stream-info-sample-rate: Exported generic functions
stream-info-sample-rate: Exported generic functions
stream-info-struct-version: Internal generic functions
stream-info-struct-version: Internal generic functions
stream-parameters-channel-count: Exported generic functions
stream-parameters-channel-count: Exported generic functions
stream-parameters-device: Exported generic functions
stream-parameters-device: Exported generic functions
stream-parameters-sample-format: Exported generic functions
stream-parameters-sample-format: Exported generic functions
stream-parameters-suggested-latency: Exported generic functions
stream-parameters-suggested-latency: Exported generic functions

T
terminate: Exported functions

W
with-audio: Exported macros
with-audio-stream: Exported macros
with-default-audio-stream: Exported macros
write-stream: Exported functions

Jump to:   %   (  
A   C   D   F   G   H   I   M   O   P   R   S   T   W  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.3 Variables

Jump to:   +  
C   D   E   F   H   I   M   N   O   P   S   T  
Index Entry  Section

+
+format-is-supported+: Internal constants
+frames-per-buffer-unspecified+: Internal constants
+no-device+: Internal constants
+use-host-api-specific-device-specification: Internal constants

C
channel-count: Exported classes
Constant, +format-is-supported+: Internal constants
Constant, +frames-per-buffer-unspecified+: Internal constants
Constant, +no-device+: Internal constants
Constant, +use-host-api-specific-device-specification: Internal constants

D
default-high-input-latency: Exported classes
default-high-output-latency: Exported classes
default-input-device: Exported classes
default-low-input-latency: Exported classes
default-low-output-latency: Exported classes
default-output-device: Exported classes
default-sample-rate: Exported classes
device: Exported classes
device-count: Exported classes

E
error-code: Exported classes
error-text: Exported classes

F
frames-per-buffer: Exported classes

H
handle: Exported classes
host-api: Exported classes
host-api-type: Exported classes

I
input-channels: Exported classes
input-latency: Exported classes
input-sample-format: Exported classes

M
max-input-channels: Exported classes
max-output-channels: Exported classes

N
name: Exported classes
name: Exported classes

O
output-channels: Exported classes
output-latency: Exported classes
output-sample-format: Exported classes

P
p: Exported classes

S
sample-format: Exported classes
sample-rate: Exported classes
Slot, channel-count: Exported classes
Slot, default-high-input-latency: Exported classes
Slot, default-high-output-latency: Exported classes
Slot, default-input-device: Exported classes
Slot, default-low-input-latency: Exported classes
Slot, default-low-output-latency: Exported classes
Slot, default-output-device: Exported classes
Slot, default-sample-rate: Exported classes
Slot, device: Exported classes
Slot, device-count: Exported classes
Slot, error-code: Exported classes
Slot, error-text: Exported classes
Slot, frames-per-buffer: Exported classes
Slot, handle: Exported classes
Slot, host-api: Exported classes
Slot, host-api-type: Exported classes
Slot, input-channels: Exported classes
Slot, input-latency: Exported classes
Slot, input-sample-format: Exported classes
Slot, max-input-channels: Exported classes
Slot, max-output-channels: Exported classes
Slot, name: Exported classes
Slot, name: Exported classes
Slot, output-channels: Exported classes
Slot, output-latency: Exported classes
Slot, output-sample-format: Exported classes
Slot, p: Exported classes
Slot, sample-format: Exported classes
Slot, sample-rate: Exported classes
Slot, struct-version: Exported classes
Slot, struct-version: Exported classes
Slot, struct-version: Exported classes
Slot, suggested-latency: Exported classes
Slot, type: Exported classes
struct-version: Exported classes
struct-version: Exported classes
struct-version: Exported classes
suggested-latency: Exported classes

T
type: Exported classes

Jump to:   +  
C   D   E   F   H   I   M   N   O   P   S   T  

Previous: , Up: Indexes   [Contents][Index]

A.4 Data types

Jump to:   C   D   H   P   S  
Index Entry  Section

C
cl-portaudio: The cl-portaudio system
Class, device-info: Exported classes
Class, device-info-tclass: Internal classes
Class, host-api-info: Exported classes
Class, host-api-info-tclass: Internal classes
Class, host-error-info: Exported classes
Class, host-error-info-tclass: Internal classes
Class, p-device-info: Internal classes
Class, p-host-api-info: Internal classes
Class, p-host-error-info: Internal classes
Class, p-pa-stream: Internal classes
Class, p-stream-info: Internal classes
Class, p-stream-parameters: Internal classes
Class, pa-stream: Exported classes
Class, stream-info: Exported classes
Class, stream-info-tclass: Internal classes
Class, stream-parameters: Exported classes
Class, stream-parameters-tclass: Internal classes

D
device-info: Exported classes
device-info-tclass: Internal classes

H
host-api-info: Exported classes
host-api-info-tclass: Internal classes
host-error-info: Exported classes
host-error-info-tclass: Internal classes

P
p-device-info: Internal classes
p-host-api-info: Internal classes
p-host-error-info: Internal classes
p-pa-stream: Internal classes
p-stream-info: Internal classes
p-stream-parameters: Internal classes
pa-stream: Exported classes
Package, portaudio: The portaudio package
portaudio: The portaudio package

S
stream-info: Exported classes
stream-info-tclass: Internal classes
stream-parameters: Exported classes
stream-parameters-tclass: Internal classes
System, cl-portaudio: The cl-portaudio system

Jump to:   C   D   H   P   S