advancedaudiopacket.h

Go to the documentation of this file.

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


#ifndef ADVANCEDAUDIOPACKET_H
#define ADVANCEDAUDIOPACKET_H


#include "tdsystem.h"
#include "mediainfo.h"
#include "audioquality.h"


struct AdvancedAudioPacket
{
   // ====== Constructor ====================================================
   public:
   AdvancedAudioPacket();

   // ====== Byte order translation =========================================
   void translate();


   // ====== Status functions ===============================================
   void reset();


   // ====== Constants and static members ===================================
   static const card16 AdvancedAudioTypeID = 0x2961;

   static const char AdvancedAudioTypeName[];

   static const card32 AdvancedAudioFormatID = 0x74660000 | AdvancedAudioTypeID;

   static const cardinal AdvancedAudioMediaInfoPacketsPerSecond = 2;

   static const cardinal AdvancedAudioFramesPerSecond = 35;

   static const cardinal AdvancedAudioFrameSize =
      44100 * 2 * 2 / AdvancedAudioFramesPerSecond;

   static const cardinal AdvancedAudioMaxTransferDelay = 100 * 16; // 100 ms.

   static const cardinal AdvancedAudioMaxQualityLayers = 3;

   static const cardinal AdvancedAudioQualityLevels = AudioQuality::QualityLevels;


   static AudioQuality calculateQualityForLimits(
                          const AudioQualityInterface& userSetting,
                          const AudioQualityInterface& inputQuality,
                          const card64                 totalByteRateLimit,
                          const card64                 byteRateLimitL1,
                          const card64                 byteRateLimitL2,
                          const card64                 byteRateLimitL3,
                          const cardinal               networkQualityDecrement,
                          const cardinal               headerSize,
                          const cardinal               maxPacketSize);


   static cardinal calculateFrameSize(const cardinal inputBytesPerSecond,
                                      const cardinal inputFrameSize);


   static cardinal calculateLayers(const AudioQualityInterface& quality);


   // ====== Packet data ====================================================
   public:
   card32 FormatID;

   card16 SamplingRate;

   card8 Channels;

   card8 Bits;

   card64 Position;

   card64 MaxPosition;

   card8 ErrorCode;

   card8 Flags;

   enum AdvancedAudioFlags {
      AAF_ChannelLeft  = (1 << 0),
      AAF_ChannelRight = (1 << 1),
      AAF_ByteUpper    = (1 << 2),
      AAF_ByteLower    = (1 << 3),
      AAF_MediaInfo    = (1 << 4)
   };

   card16 Fragment;

   char Data[0];
} __attribute__((packed));


#endif