~ubuntu-branches/ubuntu/gutsy/audacity/gutsy-backports

Additionally, the user may define a "channel mapping" by calling

paSetupMacCoreChannelMap() on their stream info structure before opening

the stream with it. See below for creating a channel map.

wrong since patest_sine_time often reports negative latency numbers. Also,

there are currently issues with some devices whehn plugging/unplugging

devices.

- blocking interface: should work fine.

from MOTU: traveler and 896HD. Also Presonus firepod and others. It is

believed to work with all Core Audio devices, including virtual devices

such as soundflower.

render quyality property is used to set the sample rate conversion quality

- x86/Universal Binary: to build a universal binary, be sure to use

the darwin makefile and not the usual configure && make combo.

 

 

 

Creating a channel map:

 

How to create the map array -  Text taken From AUHAL.rtfd :

[3] Channel Maps

Clients can tell the AUHAL units which channels of the device they are interested in.  For example, the client may be processing stereo data, but outputting to a six-channel device.  This is done by using the kAudioOutputUnitProperty_ChannelMap property.  To use this property:

 

For Output:

Create an array of SInt32 that is the size of the number of channels of the device (Get the Format of the AUHAL's output Element == 0)

Initialize each of the array's values to -1 (-1 indicates that that channel is NOT to be presented in the conversion.)

 

Next, for each channel of your app's output, set:

channelMapArray[deviceOutputChannel] = desiredAppOutputChannel.

 

For example: we have a 6 channel output device and our application has a stereo source it wants to provide to the device.  Suppose we want that stereo source to go to the 3rd and 4th channels of the device. The channel map would look like this: { -1, -1, 0, 1, -1, -1 }

 

Where the formats are:

Input Element == 0: 2 channels (- client format - settable)

Output Element == 0: 6 channels (- device format - NOT settable)

 

So channel 2 (zero-based) of the device will take the first channel of output and channel 3 will take the second channel of output. (This translates to the 3rd and 4th plugs of the 6 output plugs of the device of course!)

 

For Input:

Create an array of SInt32 that is the size of the number of channels of the format you require for input.  Get (or Set in this case as needed) the AUHAL's output Element == 1.

 

Next, for each channel of input you require, set:

channelMapArray[desiredAppInputChannel] = deviceOutputChannel;

 

For example: we have a 6 channel input device from which we wish to receive stereo input from the 3rd and 4th channels. The channel map looks like this: { 2, 3 }

 

Where the formats are:

Input Element == 0: 2 channels (- device format - NOT settable)

Output Element == 0: 6 channels (- client format - settable)

 

 

 

----------------------------------------

 

Notes on Original implementation:

 

by Phil Burk and Darren Gibbs

 

Last updated March 20, 2002

 

WHAT WORKS

 

Output with very low latency, <10 msec.

Half duplex input or output.

Full duplex on the same CoreAudio device.

The paFLoat32, paInt16, paInt8, paUInt8 sample formats.

Pa_GetCPULoad()

Pa_StreamTime()

 

KNOWN BUGS OR LIMITATIONS

 

We do not yet support simultaneous input and output on different 

devices. Note that some CoreAudio devices like the Roland UH30 look 

like one device but are actually two different CoreAudio devices. The 

Built-In audio is typically one CoreAudio device.

 

Mono doesn't work.

 

DEVICE MAPPING

 

CoreAudio devices can support both input and output. But the sample 

rates supported may be different. So we have map one or two PortAudio 

device to each CoreAudio device depending on whether it supports 

input, output or both.

 

When we query devices, we first get a list of CoreAudio devices. Then 

we scan the list and add a PortAudio device for each CoreAudio device 

that supports input. Then we make a scan for output devices.