advancedaudiodecoder.h

Go to the documentation of this file.

// ##########################################################################
// ####                                                                  ####
// ####                      RTP Audio Server Project                    ####
// ####                    ============================                  ####
// ####                                                                  ####
// #### Advanced Audio Decoder                                           ####
// ####                                                                  ####
// ####           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: advancedaudiodecoder.h 1286 2011-12-18 13:43:16Z dreibh $


#ifndef ADVANCEDAUDIODECODER_H
#define ADVANCEDAUDIODECODER_H


#include "tdsystem.h"
#include "audiowriterinterface.h"
#include "audiodecoderinterface.h"
#include "timedthread.h"
#include "seqnumvalidator.h"
#include "audioquality.h"
#include "advancedaudiopacket.h"


#include <set>
#include <map>


class AdvancedAudioDecoder : public AudioDecoderInterface,
                             public TimedThread
{
   // ====== Constructor/Destructor =========================================
   public:
   AdvancedAudioDecoder(AudioWriterInterface* audioWriter);

   ~AdvancedAudioDecoder();


   // ====== DecoderInterface implementation ================================
   const card16 getTypeID() const;

   const char* getTypeName() const;

   void activate();

   void deactivate();

   void reset();

   void getMediaInfo(MediaInfo& mediaInfo) const;

   card8 getErrorCode() const;

   card64 getPosition() const;

   card64 getMaxPosition() const;

   bool checkNextPacket(DecoderPacket* decoderPacket);

   void handleNextPacket(const DecoderPacket* decoderPacket);


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

   card8 getBits() const;

   card8 getChannels() const;

   card16 getByteOrder() const;


   cardinal getBytesPerSecond() const;

   cardinal getBitsPerSample() const;


   AudioQuality getWantedQuality() const;

   void setWantedQuality(const AudioQualityInterface& wantedQuality);


   // ====== Private data ===================================================
   private:
   void timerEvent();

   struct FrameFragment {
      cardinal Length;
      card16   Fragment;
      char     Data[0];
   };

   struct FrameNode {
      card64                                     Position;
      card64                                     MaxPosition;
      cardinal                                   FrameSize;
      card16                                     SamplingRate;
      card8                                      Channels;
      card8                                      Bits;
      card8                                      ErrorCode;
      card8                                      pad;
      std::multimap<const card16,FrameFragment*> FragmentSetLL;
      std::multimap<const card16,FrameFragment*> FragmentSetRL;
      std::multimap<const card16,FrameFragment*> FragmentSetLU;
      std::multimap<const card16,FrameFragment*> FragmentSetRU;
   };

   struct FrameNodeItem {
      card64     Position;
      FrameNode* Node;

      inline int operator<(const FrameNodeItem& item) const {
         return(Position < item.Position);
      }
   };

   card64 checkFragmentSeqNum(std::multimap<const card16,FrameFragment*>* set,
                              const card64                                last) const;
   void deleteFragments(std::multimap<const card16,FrameFragment*>* set);
   FrameFragment* getFragment(std::multimap<const card16, FrameFragment*>* set,
                              const card16                                 fragmentNumber);


   static const cardinal FrameBufferSize =
      2 * ((AdvancedAudioPacket::AdvancedAudioFramesPerSecond /
           (16000 / AdvancedAudioPacket::AdvancedAudioMaxTransferDelay)) + 1);

   static const card64 BufferCleanUpDifference =
      (4 * FrameBufferSize * PositionStepsPerSecond) /
         AdvancedAudioPacket::AdvancedAudioFramesPerSecond;


   std::multiset<FrameNodeItem> FrameSet;
   AudioWriterInterface*        Device;
   AudioQuality                 WantedQuality;
   card64                       Position;
   card64                       MaxPosition;

   SeqNumValidator              SeqNumber[AdvancedAudioPacket::AdvancedAudioMaxQualityLayers];
   MediaInfo                    Media;
   card16                       AudioSamplingRate;
   card8                        AudioBits;
   card8                        AudioChannels;
   card8                        ErrorCode;
};


#endif