audiodevice.h

Go to the documentation of this file.

// ##########################################################################
// ####                                                                  ####
// ####                      RTP Audio Server Project                    ####
// ####                    ============================                  ####
// ####                                                                  ####
// #### Audio Device                                                     ####
// ####                                                                  ####
// ####           Copyright (C) 1999-2012 by Thomas Dreibholz            ####
// ####                                                                  ####
// #### Contact:                                                         ####
// ####    EMail: dreibh@iem.uni-due.de                                  ####
// ####    WWW:   https://www.nntb.no/~dreibh/rtpaudio                ####
// ####                                                                  ####
// #### ---------------------------------------------------------------- ####
// ####                                                                  ####
// #### This program is free software: you can redistribute it and/or    ####
// #### modify it under the terms of the GNU General Public License as   ####
// #### published by the Free Software Foundation, either version 3 of   ####
// #### the License, or (at your option) any later version.              ####
// ####                                                                  ####
// #### 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 General Public License for more details.                     ####
// ####                                                                  ####
// #### You should have received a copy of the GNU General Public        ####
// #### License along with this program.  If not, see                    ####
// #### <http://www.gnu.org/licenses/>.                                  ####
// ####                                                                  ####
// ##########################################################################
// $Id: audiodevice.h 1329 2011-12-23 22:06:51Z dreibh $


#ifndef AUDIODEVICE_H
#define AUDIODEVICE_H


#include "tdsystem.h"
#include "audiowriterinterface.h"

#ifdef HAVE_PULSEAUDIO
#include <pulse/thread-mainloop.h>
#include <pulse/context.h>
#include <pulse/stream.h>
#else
#include "thread.h"
#include "ringbuffer.h"
#endif


class AudioDevice : virtual public AudioWriterInterface
#ifndef HAVE_PULSEAUDIO
                    , public Thread
#endif
{
   // ====== Constructor/Destructor =========================================
   public:
   AudioDevice(const char* name = "/dev/dsp");

   ~AudioDevice();


   // ====== Status functions ===============================================
   inline cardinal getSyncCount() const;

   inline void resetSyncCount();


   // ====== AudioQualityInterface implementation ===========================
   card16 getSamplingRate() const;

   card8 getBits() const;

   card8 getChannels() const;


   card16 getByteOrder() const;


   cardinal getBytesPerSecond() const;

   cardinal getBitsPerSample() const;


   card16 setSamplingRate(const card16 samplingRate);

   card8 setBits(const card8 bits);

   card8 setChannels(const card8 channels);


   card16 setByteOrder(const card16 byteOrder);


   // ====== AudioInterface implementation ==================================
   bool ready() const;

   void sync();

   bool write(const void* data, const size_t length);

   cardinal getCurrentCapacity();


   // ====== Constants ======================================================
   static const cardinal RingBufferSize = 128 * 1024;

   static const cardinal ResizeThresholdPercent = 75;

   static const cardinal ResizeModulo = 4;


   // ====== Internal data ==================================================
   private:
   void run();
#ifdef HAVE_PULSEAUDIO
   bool openStream();
   void closeStream();
   static void context_state_callback(pa_context* context, void* userData);
#endif

   bool                  IsReady;
   cardinal              SyncCount;
   cardinal              JitterCompensationLatency;

   card16                AudioSamplingRate;  // Format of data written to AudioDevice.
   card8                 AudioBits;
   card8                 AudioChannels;
   card16                AudioByteOrder;

   card16                DeviceSamplingRate; // Format of data written to real device.
   card8                 DeviceBits;
   card8                 DeviceChannels;
   card16                DeviceByteOrder;

#ifdef HAVE_PULSEAUDIO
   friend class          AudioMixer;
   pa_threaded_mainloop* MainLoop;
   pa_mainloop_api*      MainLoopAPI;
   pa_context*           Context;
   pa_stream*            Stream;
#else
   int                   DeviceFD;           // Device and its properties.
   int                   DeviceCapabilities;
   int                   DeviceFormats;
   integer               DeviceBlockSize;
   integer               DeviceFragmentSize;
   integer               DeviceOSpace;

   RingBuffer            Buffer;             // Jitter buffer and jitter compensation
   cardinal              ResizeThreshold;
   card64                LastWriteTimeStamp;
   integer               Balance;
   bool                  IsFillingBuffer;
#endif
};


#include "audiodevice.icc"


#endif