Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AU_DEVOUT(3)		     Library Functions Manual		    AU_DEVOUT(3)

NAME
     AU_DevOut -- agar audio output interface

SYNOPSIS
     #include <agar/au.h>

DESCRIPTION
     The  AU_DevOut  interface	provides basic audio output functionality, using
     different drivers to interface with different audio systems.

INTERFACE
     AU_DevOut * AU_OpenOut(const char *path, int rate, int channels)

     void AU_CloseOut(AU_DevOut *dev)

     int AU_AddChannel(AU_DevOut *dev)

     int AU_DelChannel(AU_DevOut *dev, int channel)

     void AU_WriteFloat(AU_DevOut *dev, float *data, Uint nFrames)

     The AU_OpenOut() function opens the specified output device.  The path  ar-
     gument  should  contain  the name of the output driver, with optional argu-
     ments in round brackets.  For example, `pa' opens the PortAudio output dri-
     ver, if available.  The `file(foo.wav)' argument specifies the "file"  dri-
     ver  with	an output filename argument.  The rate argument is the requested
     sampling rate in Hz, and channels is the requested number of  channels  (if
     the  device  is  unable  to handle those settings, the call will fail).  On
     success, a device handle is returned.

     AU_CloseOut() closes the specified output device.

     Every output device has an associated set of virtual channels, which is in-
     dependent from the number of channels supported by  the  underlying  device
     (software	mixing is done if necessary).  The AU_AddChannel() function adds
     a new virtual channel to the given output device.	AU_DelChannel()  deletes
     the specified channel.

     The  AU_WriteFloat() routine writes nFrames frames to the output device.  A
     single frame should contain one float per channel.

SEE ALSO
     AU(3), AU_Wave(3)

HISTORY
     The AU(3) library and the AU_DevOut interface first appeared in Agar 1.5.0.

Agar 1.7			December 21, 2022		    AU_DEVOUT(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=AU_DevOut&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help