audioquality.h

Go to the documentation of this file.

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


#ifndef AUDIOQUALITY_H
#define AUDIOQUALITY_H


#include "tdsystem.h"
#include "randomizer.h"
#include "audioqualityinterface.h"


class AudioQuality : virtual public AdjustableAudioQualityInterface
{
   // ====== Constructors ===================================================
   public:
   AudioQuality();

   AudioQuality(const card16 samplingRate,
                const card8  bits,
                const card8  channels,
                const card16 byteOrder = BYTE_ORDER);

   AudioQuality(const AudioQualityInterface& quality);


   // ====== Quality functions ==============================================
   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);


   inline bool isLowest() const;

   inline bool isHighest() const;


   void increase(const cardinal steps);

   void decrease(const cardinal setps);


   bool prevSamplingRate();

   bool nextSamplingRate();


   inline card64 bytesToTime(const size_t bytes) const;

   inline size_t timeToBytes(const card64 microseconds) const;


   // ====== Operators ======================================================
   AudioQuality& operator=(const AudioQualityInterface& quality);

   AudioQuality operator++(int);

   AudioQuality operator--(int);


   // ====== Static functions ===============================================
   public:
   static AudioQuality getQualityForByteRate(const cardinal bps);

   static AudioQuality getRandomQuality(Randomizer* randomizer);


   static const card16* ValidRatesTable;

   static const cardinal ValidRates;

   static const card8* ValidBitsTable;

   static const cardinal ValidBits;

   static const card8* ValidChannelsTable;

   static const cardinal ValidChannels;


   static const AudioQuality LowestQuality;

   static const AudioQuality HighestQuality;

   static const card16 LowestSamplingRate;

   static const card16 HighestSamplingRate;

   static const card8 LowestBits;

   static const card8 HighestBits;

   static const card8 LowestChannels;

   static const card8 HighestChannels;

   static const cardinal QualityLevels = 23;


   // ====== Private data ===================================================
   private:
   card16 SamplingRate;
   card8  Bits;
   card8  Channels;
   card16 ByteOrder;
};


std::ostream& operator<<(std::ostream& out, const AudioQualityInterface& quality);

AudioQuality operator+(const AudioQualityInterface& q1, const AudioQualityInterface& q2);

AudioQuality operator-(const AudioQualityInterface& q1, const AudioQualityInterface& q2);

AudioQuality operator-(const AudioQualityInterface& q1, const cardinal bytesPerSecond);


#include "audioquality.icc"


#endif