///
/// @file audio.h   @brief Audio module headerfile
///
/// Copyright (c) 2009 - 2014 by Johns.  All Rights Reserved.
///
/// Contributor(s):
///
/// License: AGPLv3
///
/// This program is free software: you can redistribute it and/or modify
/// it under the terms of the GNU Affero General Public License as
/// published by the Free Software Foundation, either version 3 of the
/// License.
///
/// This program is distributed in the hope that it will be useful,
/// but WITHOUT ANY WARRANTY; without even the implied warranty of
/// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
/// GNU Affero General Public License for more details.
///
/// $Id: da055758af70cfdb9ab1989d5fcfb218c5d6a366 $
//////////////////////////////////////////////////////////////////////////////

/// @addtogroup Audio
/// @{

//----------------------------------------------------------------------------
//  Prototypes
//----------------------------------------------------------------------------

extern void AudioEnqueue(const void *, int);    ///< buffer audio samples
extern void AudioFlushBuffers(void);    ///< flush audio buffers
extern void AudioPoller(void);          ///< poll audio events/handling
extern int AudioFreeBytes(void);        ///< free bytes in audio output
extern int AudioUsedBytes(void);        ///< used bytes in audio output
extern int64_t AudioGetDelay(void);     ///< get current audio delay
extern void AudioSetClock(int64_t);     ///< set audio clock base
extern int64_t AudioGetClock();         ///< get current audio clock
extern void AudioSetVolume(int);        ///< set volume
extern int AudioSetup(int *, int *, int);   ///< setup audio output

extern void AudioPlay(void);            ///< play audio
extern void AudioPause(void);           ///< pause audio

extern void AudioSetBufferTime(int);    ///< set audio buffer time
extern void AudioSetSoftvol(int);       ///< enable/disable softvol
extern void AudioSetNormalize(int, int);    ///< set normalize parameters
extern void AudioSetCompression(int, int);  ///< set compression parameters
extern void AudioSetStereoDescent(int); ///< set stereo loudness descent

extern void AudioSetDevice(const char *);   ///< set PCM audio device

    /// set pass-through device
extern void AudioSetPassthroughDevice(const char *);
extern void AudioSetChannel(const char *);  ///< set mixer channel
extern void AudioSetAutoAES(int);       ///< set automatic AES flag handling
extern void AudioInit(void);            ///< setup audio module
extern void AudioExit(void);            ///< cleanup and exit audio module

//----------------------------------------------------------------------------
//  Variables
//----------------------------------------------------------------------------

extern char AudioAlsaDriverBroken;      ///< disable broken driver message
extern char AudioAlsaNoCloseOpen;       ///< disable alsa close/open fix
extern char AudioAlsaCloseOpenDelay;    ///< enable alsa close/open delay fix

/// @}