Home    News    Components    Get ViTooKi    Documentation    Community    Developers    @sf.net  

Info

Last update:
12 Feb 2007

Documentation

Doxygen LXR

MetaObject Class Reference

<class description="" goes="" here=""> <short description=""> More...

#include <MetaObject.hpp>

List of all members.

Public Member Functions
	MetaObject (ContainerInfo *stream)
	creates a new meta-object for the given stream.
	MetaObject (const char *configFile)
	creates a new empty meta-object and tries to init from a config file
	~MetaObject ()
	frees memory for all ContainerInfo objects
ContainerInfo *	findMp4Stream (u32 lowerDimX, u32 upperDimX, u32 lowerDimY, u32 upperDimY, u32 lowerBitRate, u32 upperBitRate, bool greyScale, float frameRate, bool *isExactMatch)
	search for a stream with specified properties
bool	addMP4Stream (ContainerInfo *stream)
bool	deleteMP4Stream (ContainerInfo *stream)
	returns true iff the stream is found
const Url *	getUrl () const
bool	saveToConfigFile (const char *cfg)
int	getNumberOfVariations () const
std::list< ContainerInfo * > *	getVariations ()
	returns a pointer to the internal variations.
void	releaseVariationsLock ()
Protected Member Functions
bool	loadFromConfigFile (const char *cfg)
	if this method is called, it will destroy all previously stored ContainerInfo objects and delete the url.
double	calcSimpleQuality (u32 min, u32 max, u32 val)
	calculates quality inside the range min, max for value val
Protected Attributes
list< ContainerInfo * >	variations
Url *	url
VMutex	lockAccess
u32	pendingOutsideUnlock

---

Detailed Description

<class description="" goes="" here=""> <short description="">

Author:

Michael Kropfberger and Peter Schojer

Version:

Id

MetaObject.hpp,v 1.10 2006/01/20 15:37:17 mkropfbe Exp

Definition at line 65 of file MetaObject.hpp.

---

Constructor & Destructor Documentation

MetaObject::MetaObject (  ContainerInfo *  stream  )

creates a new meta-object for the given stream. Parameters: stream  is shallow copied and destroyed with the meta-object Definition at line 60 of file MetaObject.cpp. References ContainerInfo::getUrl(), VMutex::initialize(), ContainerInfo::setMetaObject(), and Url::toString(). { assert(stream); url=NULL; pendingOutsideUnlock=0; lockAccess.initialize("MetaObject-lockAccess"); if(stream) { dprintf_full("MetaObject::MetaObject stream ok\n"); if (stream->getUrl()) { dprintf_full("MetaObject::MetaObject url ok\n"); url=new Url(stream->getUrl()->toString()); } variations.push_back(stream); } stream->setMetaObject(this); };

---

Member Function Documentation

bool MetaObject::addMP4Stream (  ContainerInfo *  stream  )

Parameters: return  returns false if a stream with the same properties already exists, otherwise the video is added to the MetaObject and true is returned Definition at line 242 of file MetaObject.cpp. References ContainerInfo::destroy(), ContainerInfo::getFirstVisualES(), ContainerInfo::getUrl(), Url::isEqual(), VMutex::lock(), VMutex::release(), and ContainerInfo::setMetaObject(). Referenced by CacheManagerLRU::putVideo(). { lockAccess.lock(); list<ContainerInfo*>::iterator varCI; for(varCI=variations.begin(); varCI!=variations.end(); ++varCI) { // search within one variation for a similar ES entry if(stream->getUrl()->isEqual((*varCI)->getUrl())) { // compare quality! VideoESInfo* vIn=stream->getFirstVisualES(); VideoESInfo* v=(*varCI)->getFirstVisualES(); if(v->getWidth()==vIn->getWidth() && v->getAvgBandwidth()==vIn->getAvgBandwidth() && v->getFPS()>=vIn->getFPS()) { // we have same quality stored, delete the inserted one // for simplicity because the other is probably in use stream->destroy(); delete stream;stream=NULL; lockAccess.release(); return false; } } } stream->setMetaObject(this); variations.push_back(stream); lockAccess.release(); return true; };

double MetaObject::calcSimpleQuality (  u32  min, u32  max, u32  val )  [protected]

calculates quality inside the range min, max for value val Parameters: min  specifies the lower border of the range max  specifies the upper border of the range val  specifies a point inside the range return  will be -1 if min  > max,or  will be zero if val  is outside of the range.otherwise a value between 0 and 1 will be returned, which states how close val  is to max  if val  == max  then 1.0 will be returned Definition at line 97 of file MetaObject.cpp. Referenced by findMp4Stream(). { if(min==max) { if(min==val) return 1.0; return 0.0; } if(min>max) return -1.0; if(min<=val && val <=max) return (((double)val)-min)/(max-min); return 0.0; }

ContainerInfo * MetaObject::findMp4Stream (  u32  lowerDimX, u32  upperDimX, u32  lowerDimY, u32  upperDimY, u32  lowerBitRate, u32  upperBitRate, bool  greyScale, float  frameRate, bool *  isExactMatch )

search for a stream with specified properties Parameters: lowerDimX  specifies the minimum width of the video upperDimX  specifies the maximum width of the video lowerDimY  specifies the minimum height of the video lowerDimY  specifies the maximum height of the video lowerBitRate  specifies the minimum bit-rate in bit/sec upperBitRate  specifies the maximum bit-rate in bit/sec greyScale  specifies if the video should have color or not isExactMatch  specifies if an exact match was found or not. An exact match is anything that fits the specified range If you want to exclude some params from the search, set the lower Value to zero and the upper value to the largest int. Note that return  will only return NULL, if no ContainerInfo object is stored. If no exact match is found, the object nearest to the specified parameters is returned and isExactMatch  is set to false. If you do require an exact match, take the returned ContainerInfo and call makeExactMatch. FIXME: support TemporalAdaptation Definition at line 132 of file MetaObject.cpp. References calcSimpleQuality(), ContainerInfo::getESList(), ContainerInfo::getFirstVisualES(), VMutex::lock(), and VMutex::release(). Referenced by ServerSession::setUrl(), and ProxySession::setUrl(). { dprintf_full("MetaObject::findMp4Stream(u32 lowX=%u,u32 uppX=%u,u32 lowY=%u,u32" " upY=%u,u32 lowBitRate=%u kbps, u32 upperBitRate=%u kbps,bool greyScale=%i)\n", lowerDimX,upperDimX,lowerDimY,upperDimY,lowerBitRate/1024,upperBitRate/1024, (int)greyScale); lockAccess.lock(); *isExactMatch=false; ContainerInfo* best=NULL; int maxHits=0; if(variations.empty()) { lockAccess.release(); return NULL; } double bestQuality=0.0, currentQuality=0.0; u32 bestBitRate; list<ContainerInfo*>::iterator li=variations.begin(); while(li!=variations.end()) { // compare VideoESInfo* temp = (*li)->getFirstVisualES(); AudioESInfo* temp2= (*li)->getFirstAudioES(); u32 sysBitRate= (temp2? temp2->getAvgBandwidth():0); sysBitRate+=(temp? temp->getAvgBandwidth():0); int countHits=0; countHits+=(sysBitRate>=lowerBitRate) ? 1 : 0; countHits+=(sysBitRate<=upperBitRate) ? 1 : 0; // problem with network: return the one version with the value // closest to the specified range, make sure this doesn't have a // too big influence in case other misses are encountered --> countHits are used for that! if(lowerBitRate<=upperBitRate) { if(lowerBitRate<=sysBitRate && sysBitRate<=upperBitRate) { currentQuality=1.0+calcSimpleQuality(lowerBitRate,upperBitRate,sysBitRate); } else { // if out of range calc a value between 0..1 stating how many % we are off if(sysBitRate < lowerBitRate && sysBitRate > lowerBitRate/2) { currentQuality=calcSimpleQuality(lowerBitRate/2,lowerBitRate,sysBitRate); } else if(sysBitRate> upperBitRate && sysBitRate < upperBitRate*2) { currentQuality=1.0-calcSimpleQuality(upperBitRate,upperBitRate*2,sysBitRate); } else currentQuality=0.0; } } else currentQuality=0.0; if(temp) { if(lowerDimX<=upperDimX && lowerDimY<upperDimY && upperDimX>32 && upperDimY>32) { countHits+=(temp->getWidth()>=lowerDimX) ? 1 : 0; countHits+=(temp->getHeight()>=lowerDimY) ? 1 : 0; countHits+=(temp->getWidth()<=upperDimX) ? 1 : 0; countHits+=(temp->getHeight()<=upperDimY) ? 1 : 0; currentQuality+=calcSimpleQuality(lowerDimX,upperDimX,temp->getWidth()); currentQuality+=calcSimpleQuality(lowerDimY,upperDimY,temp->getHeight()); } else { /* ignore the incorrectly given dimension */ countHits+=4; } countHits+=(greyScale!=temp->getHasColor()) ? 1 : 0; } else countHits+=5; //dim+greyscale if(frameRate>temp->getFPS()) countHits++; dprintf_full("MetaObject::findMp4Stream checking on width=%u, height=%u, bitRate=%u kbps," " hasColor %i: quality %4.2f hits %i\n", temp->getWidth(),temp->getHeight(),sysBitRate/1024,temp->getHasColor(), currentQuality, countHits); if(countHits == 8) { // a perfect hit maxHits=countHits; *isExactMatch=true; dprintf_full("MetaObject::findMp4Stream found a perfect hit (exact match!)\r\n"); if(currentQuality > bestQuality || currentQuality <= 0.0) { best=*li; bestQuality = currentQuality; bestBitRate = sysBitRate; } } else if ((countHits >= maxHits) && (bestQuality < currentQuality) ) { // new best match best=*li; bestQuality=currentQuality; maxHits=countHits; bestBitRate = sysBitRate; } ++li; } dprintf_full("MetaObject::findMp4Stream has %i hits from 8, quality %4.2f\n",maxHits, bestQuality); lockAccess.release(); if (best) { dprintf_full("MetaObject::findMp4Stream decides on Container with width=%u, height=%u, bitRate=%i kbps firstES id %llu (url %s)\n", best->getFirstVisualES()->getWidth(),best->getFirstVisualES()->getHeight(), bestBitRate/1024, (*best->getESList()->begin())->getStreamId(), (*best->getESList()->begin())->getInput()); return best; } else return NULL; };

std::list< ContainerInfo * > * MetaObject::getVariations (   )

returns a pointer to the internal variations. locks and KEEPS the lock. You must call releaseVariationsLock(), when you are done with the listDefinition at line 396 of file MetaObject.cpp. References VMutex::lock(). { lockAccess.lock(); pendingOutsideUnlock++; return &variations; };

bool MetaObject::loadFromConfigFile (  const char *  cfg  )  [protected]

if this method is called, it will destroy all previously stored ContainerInfo objects and delete the url. Then it will load the cfg file. Recommended use is to call it only from a constructorDefinition at line 354 of file MetaObject.cpp. References ContainerInfo::loadFromCfgFile(), VMutex::lock(), and VMutex::release(). Referenced by MetaObject(). { FILE* fp=fopen(cfg,"rb"); if(!fp) return false; lockAccess.lock(); if(url) { delete url; } list<ContainerInfo*>::iterator start; while(!variations.empty()) { start=variations.begin(); delete (*start); variations.pop_front(); } // everything cleaned up bool retVal=true; char *line = new char[1024]; fgets(line,1024,fp); // first line contains url url=new Url(line); // then read the objects ContainerInfo* info=NULL; //int counter=0; while(!feof(fp)) { fgets(line,1024,fp); info=new ContainerInfo(); if(info->loadFromCfgFile(line)) { variations.push_back(info); } else retVal=false; } fclose(fp); lockAccess.release(); delete [] line; return retVal; };

---

The documentation for this class was generated from the following files:

• MetaObject.hpp
• MetaObject.cpp

© ViTooKi 2003 :: [Lite version] Created with Doxygen