resourceutilizationpoint.h

Go to the documentation of this file.

// ##########################################################################
// ####                                                                  ####
// ####                   Master Thesis Implementation                   ####
// ####  Management of Layered Variable Bitrate Multimedia Streams over  ####
// ####                 DiffServ with A Priori Knowledge                 ####
// ####                                                                  ####
// #### ================================================================ ####
// ####                                                                  ####
// ####                                                                  ####
// #### Resource Utilization Point                                       ####
// ####                                                                  ####
// ####           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: resourceutilizationpoint.h 1308 2011-12-22 07:43:26Z dreibh $


#ifndef RESOURCEUTILIZATIONPOINT_H
#define RESOURCEUTILIZATIONPOINT_H


#include "tdsystem.h"
#include "rtppacket.h"
#include "bandwidthinfo.h"
#include "trafficclassvalues.h"


class StreamDescription;


struct LayerClassMappingPossibility
{
   cardinal Class;

   cardinal BufferDelay;

   double Cost;

   card64 Bandwidth;
};


struct LayerClassMapping
{
   cardinal Possibilities;

   LayerClassMappingPossibility Possibility[TrafficClassValues::MaxValues];
};


class ResourceUtilizationPoint
{
   // ====== Public data ====================================================
   public:
   card64 Bandwidth;

   double BandwidthCost;

   double Utilization;

   double FrameRate;

   cardinal Layers;


   BandwidthInfo LayerBandwidthInfo[RTPConstants::RTPMaxQualityLayers];

   LayerClassMapping Mapping[RTPConstants::RTPMaxQualityLayers];


   // ====== Operations =====================================================
   void reset();

   static cardinal mergeResourceUtilizationLists(
                      ResourceUtilizationPoint*  destination,
                      ResourceUtilizationPoint** listArray,
                      const cardinal*            listSizeArray,
                      const cardinal             listCount);

   static void sortResourceUtilizationList(
                  ResourceUtilizationPoint* rup,
                  const integer            start,
                  const integer            end);

   static cardinal optimizeResourceUtilizationList(
                      ResourceUtilizationPoint* rup,
                      const cardinal            count);

   static cardinal grahamScanResourceUtilizationList(ResourceUtilizationPoint* rup,
                                                     const cardinal            count);


   // ====== Comparision operators ==========================================
   inline int operator==(const ResourceUtilizationPoint& rup) const;

   inline int operator!=(const ResourceUtilizationPoint& rup) const;


   // ====== Private data ===================================================
   private:
   static inline void swapResourceUtilizationPoints(ResourceUtilizationPoint& a,
                                                    ResourceUtilizationPoint& b);
   static inline integer ccw(const ResourceUtilizationPoint& p0,
                             const ResourceUtilizationPoint& p1,
                             const ResourceUtilizationPoint& p2);
};


std::ostream& operator<<(std::ostream& os, const ResourceUtilizationPoint& rup);


#include "resourceutilizationpoint.icc"


#endif