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

Info

Last update:
12 Feb 2007

Documentation

Doxygen LXR

ContainerInfo Class Reference

stores pointers to all available ElemStreams (ESInfos) in this container <short description=""> More...

#include <ContainerInfo.hpp>

List of all members.

Public Types
enum	ContainerType {   UNKNOWN_CONTAINER, AVI, MP4, MATROSKA,   VITOOKI, DVD, SDP, OGG }
Public Member Functions
	ContainerInfo (const char *url, const char *locFile, const ContainerType type)
	creates a video object for the given url, the url will be deep-copied.
	ContainerInfo ()
	creates an empty info object.
	ContainerInfo (QualityInfo &q)
	creates an empty info object.
list< ESInfo * > *	getESList ()
	returns the list of ESes for this object.
ESInfo *	getES (u32 streamId) const
	returns for a given streamid the ESInfo object.
VideoESInfo *	getFirstVisualES ()
	Returns the first visual ES it finds.
u32	getNumberOfVisualStreams () const
	how many visual streams are part of the Container
u32	getNumberOfAudioStreams () const
	how many audio streams are part of the Container
AudioESInfo *	getFirstAudioES ()
	Returns the first visual ES it finds.
ContainerType	getContainerType ()
void	setContainerType (ContainerType ctype)
IO *	getMuxDemuxIO ()
	will be used in conjunction with BufferedIOs created by IOCreator
void	setMuxDemuxIO (IO *demuxio)
	will be used in conjunction with BufferedIOs created by IOCreator
bool	saveToCfgFile (char *indexName)
	serializes the ContainerInfo to a file.
bool	loadFromCfgFile (char *indexName)
	loads an ContainerInfo object from a file.
const Url *	getUrl () const
	returns the url of the video, can return null for demultiplexed videos
void	setUrl (Url *uri)
void	setLocalFile (const char *loclFile)
const char *	getLocalFile () const
void	setIODHandle (u8 *iodHandle, u32 iodHandleSize)
	sets the iod at the MP4Stream, a deep-copy is done! iodHandleSize must be a positive number
const u8 *	getIODHandle (u32 &size) const
	returns a pointer to the IOD, will update size to contain the iodHandleSize
void	addESInfo (ESInfo *esobj)
	adds an ESInfo object to the end of the list of ES's managed by this object
u32	getActSize () const
float	getActQuality () const
u32	getLastRequestTime () const
void	setLastRequestTime (u32 last)
u32	getFileSize () const
	returns either the filesize of the mp4 file or the sum of the sizes of all demuxed streams
u32	getEstimatedNetworkFileSize ()
	returns for a non-cached object, the estimated filesize according to the SDP description
void	setMetaObject (MetaObject *meta)
MetaObject *	getMetaObject ()
bool	hasAudio () const
	checks if the MP4 object has one audio stream.
QualityInfo *	getQualityInfo ()
ContainerInfo *	clone ()
	deep-copies the object
ReferenceCounter *	getUsageCounter ()
bool	destroy ()
	deletes all locally stored files belonging to this object
rtx_group *	getRtxGroup (u32 esId, list< rtx_group * > *rtxInfo) const
Protected Attributes
ContainerType	type
	the format of this container
list< ESInfo * >	esList
IO *	muxDemuxIO
	will be used in conjunction with BufferedIOs created by IOCreator
Url *	url
	the remote url for this object
char *	localFile
	the local cache file.
MetaObject *	metaObj
	points back to the MetaObject
u8 *	iodHandle
	iod is not a stream!, seperate it from ES
u32	iodHandleSize
	the byte-size of the iod
u32	timeScale
	the default timescale of the video in ticks/second
u32	lastAccessTime
	cache specific code
ReferenceCounter *	usageCounter
	usage counter: how many clients are currently accessing this video
QualityInfo	qinfo
	information about the current quality and size of the video
char *	Name
char *	Description
char *	MimeType

---

Detailed Description

stores pointers to all available ElemStreams (ESInfos) in this container <short description="">

Author:

Michael Kropfberger and Peter Schojer

Version:

Id

ContainerInfo.hpp,v 1.21 2006/02/24 08:17:31 mkropfbe Exp

Definition at line 158 of file ContainerInfo.hpp.

---

Constructor & Destructor Documentation

ContainerInfo::ContainerInfo (  const char *  url, const char *  locFile, const ContainerType  type )

creates a video object for the given url, the url will be deep-copied. Always create ContainerInfo objects with the ISOMP4ContainerFile class or use the empty constructor and call loadFromCfgFile afterwards to complete initialization Parameters: type:  is eg. MP4 or DVD Definition at line 75 of file ContainerInfo.cpp. References iodHandle, iodHandleSize, lastAccessTime, localFile, metaObj, muxDemuxIO, type, url, and usageCounter. : qinfo(0,5) { dprintf_small("ContainerInfo:: VOB local: %s URI: %s\n", locFile, uri); type = ctype; muxDemuxIO = NULL; //assert(uri || locFile); if(uri) url = new Url(uri); else url=NULL; localFile=NULL; if(locFile) { setLocalFile(locFile); // correct / } iodHandle = NULL; iodHandleSize = 0; metaObj=NULL; lastAccessTime = 0; usageCounter=new ReferenceCounter(); }

ContainerInfo::ContainerInfo (   )

creates an empty info object. Complete initialization with loadFromCfgFileDefinition at line 101 of file ContainerInfo.cpp. References iodHandle, iodHandleSize, lastAccessTime, localFile, metaObj, muxDemuxIO, url, and usageCounter. Referenced by clone(). : qinfo(0,5) { url = NULL; muxDemuxIO = NULL; metaObj=NULL; localFile = NULL; iodHandle = NULL; iodHandleSize = 0; lastAccessTime = 0; usageCounter=new ReferenceCounter(); esList.clear(); }

ContainerInfo::ContainerInfo (  QualityInfo &  q  )

creates an empty info object. with qualityinfo set. Add ESs manuallyDefinition at line 116 of file ContainerInfo.cpp. References iodHandle, iodHandleSize, lastAccessTime, localFile, metaObj, muxDemuxIO, url, and usageCounter. : qinfo(q) { url = NULL; muxDemuxIO = NULL; iodHandle = NULL; localFile = NULL; iodHandleSize = 0; lastAccessTime = 0; metaObj=NULL; usageCounter=new ReferenceCounter(); }

---

Member Function Documentation

ESInfo * ContainerInfo::getES (  u32  streamId  )  const

returns for a given streamid the ESInfo object. Returns NULL if the streamId was not found. Performance is linear time.Definition at line 704 of file ContainerInfo.cpp. Referenced by Session::setRtxInfoForES(), and ClientSession::setRtxInfoForES(). { list < ESInfo * >::const_iterator li; if (esList.empty()) return NULL; else li = esList.begin(); while (li != esList.end()) { if ((*li)->getStreamId() == streamId) return (*li); ++li; } return NULL; }

list< ESInfo * >* ContainerInfo::getESList (   )  [inline]

returns the list of ESes for this object. Note that the ESes are destroyed when the videoobject is deletedDefinition at line 184 of file ContainerInfo.hpp. Referenced by ContainerDemux::demultiplexAndUpdateIO(), MetaObject::findMp4Stream(), SDP::generate(), and CacheManagerLRU::putVideo(). { return &esList; };

bool ContainerInfo::hasAudio (   )  const

checks if the MP4 object has one audio stream. Returns false if it hasn't Definition at line 719 of file ContainerInfo.cpp. { list < ESInfo * >::const_iterator li = esList.begin(); while (li != esList.end()) { if ((*li)->isAudioStream()) return true; ++li; } return false; }

bool ContainerInfo::loadFromCfgFile (  char *  indexName  )

loads an ContainerInfo object from a file. if sth. goes wrong, all data loaded so far is freed and false is returned. FIXME: update to include qinfo FIXME: fails when space is in fileNameDefinition at line 386 of file ContainerInfo.cpp. References addESInfo(), ESInfo::getNumberOfMediaSamples(), ESInfo::getOrigMediaSize(), iodHandle, iodHandleSize, localFile, qinfo, ESInfo::setFrameStatistic(), Url::toString(), and url. Referenced by MetaObject::loadFromConfigFile(). { FILE *file = fopen(indexName, "rb"); if (!file) return false; char *line = new char[MAX_BUFFER_SIZE]; int versionMagic=0; // get version number line[0] = 0; fgets(line, MAX_BUFFER_SIZE, file); sscanf(line,"%i",&versionMagic); if(versionMagic!=MP4CONF_VERSION) { dprintf_err("Detected old mp4.conf file\n"); fclose(file); delete [] line; return false; } // line contains localFile \r\n line[0] = 0; fgets(line, MAX_BUFFER_SIZE, file); if(localFile) { delete[] localFile; localFile=NULL; } if(strlen(line)>3) { if(strstr(line,"NULL")) { localFile=NULL; } else { localFile=new char[strlen(line)+1]; strcpy(localFile,line); } } dprintf_full("ContainerInfo::loadFromCfgFile: EMPTY Mp4StreamInfo object created\r\n"); //2nd line: URL or NULL line[0] = 0; fgets(line, MAX_BUFFER_SIZE, file); if (strlen(line) < 4) { fclose(file); delete [] line; return false; } if(url) { delete url; } url = new Url(line); if (!url->toString()) { clear(); fclose(file); delete [] line; return false; } // 3rd line: iodHandleSize <space> iodHandle <space> <nrES> <space> \r\n //read iodHandleSize int pos = 0; int ch = 0; bool space = false; while (!space) { ch = fgetc(file); if (ch < 0) { clear(); fclose(file); delete [] line; return false; } line[pos] = (char) ch; if (line[pos] == ' ') space = true; pos++; } // pos contains the number of chars read line[pos] = 0; iodHandleSize = atoi(line); if (iodHandleSize < 0) { dprintf_err("ContainerInfo: illegal iodHandleSize\n"); clear(); fclose(file); delete [] line; return false; } if(iodHandleSize>0) { iodHandle = new u8[iodHandleSize]; iodHandle[0] = 0; } else iodHandle=NULL; if (iodHandle && (iodHandleSize) != fread(iodHandle, 1, iodHandleSize, file)) { dprintf_err("ContainerInfo: Failed to read IOD\n"); clear(); fclose(file); delete [] line; return false; } // now read the number of ES line[0] = 0; fgets(line, MAX_BUFFER_SIZE, file); if (strlen(line) < 4) { dprintf_err("ContainerInfo: failed to read 2nd Line\n"); clear(); fclose(file); delete [] line; return false; } int nrEs = -1; if (1 != sscanf(line, " %i", &nrEs)) { dprintf_err("ContainerInfo: failed to read nrES\n"); clear(); fclose(file); return false; } if (nrEs < 0) { dprintf_err("ContainerInfo: illegal nrES\n"); clear(); fclose(file); delete [] line; return false; } // read the ES entries u32 size = 0; for (int i = 0; i < nrEs; i++) { line[0] = 0; fgets(line, MAX_BUFFER_SIZE, file); if (strlen(line) == 0) { clear(); fclose(file); delete [] line; return false; } ESInfo *entry = parseES(line); if (!entry) { dprintf_err("ContainerInfo: failed to read ES %i\n", i); clear(); fclose(file); delete [] line; return false; } u32 sample=entry->getNumberOfMediaSamples(); if(sample==0) { fgets(line, MAX_BUFFER_SIZE, file); // read NULL string } else { char* data=new char[sample+5]; fgets(data,sample+5,file); if(strcmp(data,"NULL")!=0) { data[sample]='\0'; entry->setFrameStatistic(BitField::fromAsciiString(data)); } delete[] data; } addESInfo(entry); size += entry->getOrigMediaSize(); } qinfo.steps[0]->size = size; fclose(file); delete [] line; return true; }

bool ContainerInfo::saveToCfgFile (  char *  indexName  )

serializes the ContainerInfo to a file. FIXME: update to include qinfo FIXME: fails when space is in fileNameDefinition at line 184 of file ContainerInfo.cpp. References iodHandle, iodHandleSize, localFile, Url::toString(), and url. { // check if the entry is valid if (!url || (iodHandleSize>0 && !iodHandle) ) return false; // either localfile or url must be set if(!localFile && !url) return false; FILE* file=fopen(indexName,"wb"); char *oneLine = new char[4096]; oneLine[0] = 0; u32 len = 0; if (file) { // Format: version magic number // url <space> \r\n // localFile or NULL \r\n // iodHandleSize <space> iodHandle <space> <nrES> <space> \r\n // each ES entry has the following format (one single Line, entries within // line separated by <space>): // streamId handlerType encodedDecoderConfig objectType streamType // bufferSize [<fileName_of_input>||null] \r\n if(url) { sprintf(oneLine, "%i \r\n%s \r\n%s \r\n%i ", MP4CONF_VERSION,(localFile?localFile:"NULL"), url->toString(), iodHandleSize); } else { //FIXME: this is dead code sprintf(oneLine, "%i \r\n%s \r\nNULL \r\n%i ", MP4CONF_VERSION,localFile, iodHandleSize); } len = strlen(oneLine); if (len != fwrite(oneLine,1, len, file)) { fclose(file); #ifndef WINCE ::remove(indexName); #else DeleteFile((LPCTSTR)indexName); #endif delete [] oneLine; return false; } // now write the IOD if (iodHandle && iodHandleSize>0 && (iodHandleSize != fwrite(iodHandle, 1, iodHandleSize,file)) ) { fclose(file); #ifndef WINCE ::remove(indexName); #else DeleteFile((LPCTSTR)indexName); #endif delete [] oneLine; return false; } oneLine[0] = 0; sprintf(oneLine, " %i \r\n", esList.size()); len = strlen(oneLine); if (len != fwrite(oneLine, 1, len, file)) { fclose(file); #ifndef WINCE ::remove(indexName); #else DeleteFile((LPCTSTR)indexName); #endif delete [] oneLine; return false; } // now start to write the ES u32 tid = 0; u32 handlerType = 0; const u8 *decoderConfig = NULL; u32 decConfSize = 0; u32 objectType = 0; u32 streamType = 0; u32 bufferSize = 0; u32 width = 0; u32 height = 0; u32 avg = 0; u32 max = 0; u32 time = 0; u64 dur = 0; u32 size = 0; u32 ticks = 0; char *input = NULL; u32 hasColor= true; u32 isComplete = true; u32 codecId= 0; float quality= 0.0; float aspectRatio=0; u32 gop_size=0; u32 bFrames=0; u32 audioSampleRate=0; u32 numChannels=2; bool hasInput = true; char* stat=NULL; float bframesize=0.0; u32 staticFramePattern=0; list < ESInfo * >::iterator li = esList.begin(); for (int i = 0; i < (int) esList.size(); i++) { tid = (*li)->getStreamId(); streamType = (*li)->getStreamType(); handlerType = (*li)->getHandlerType(); decoderConfig = (*li)->getEncodedDecoderConfig(); decConfSize = strlen((const char *) decoderConfig); objectType = (*li)->getObjectType(); bufferSize = (*li)->getBufferSize(); if(handlerType==MP4VisualHandlerType) { width = ((VideoESInfo*)(*li))->getWidth(); height = ((VideoESInfo*)(*li))->getHeight(); hasColor= ( ((VideoESInfo*)(*li))->getHasColor() ? 1 : 0); aspectRatio= ((VideoESInfo*)(*li))->getAspectRatio(); gop_size=((VideoESInfo*)(*li))->getGOP_size(); bFrames=((VideoESInfo*)(*li))->getNum_B_frames(); bframesize=((VideoESInfo*)(*li))->getAvgBFrameSize(); staticFramePattern=(((VideoESInfo*)(*li))->hasStaticFramePattern()? 1 : 0); } else { width=0; height=0; hasColor=true; } if(handlerType==MP4AudioHandlerType) { audioSampleRate=((AudioESInfo*)(*li))->getSampleRate(); numChannels=((AudioESInfo*)(*li))->getAudioChannels(); } else { audioSampleRate=0; numChannels=0; } avg = (*li)->getAvgBandwidth(); max = (*li)->getMaxBandwidth(); time = (*li)->getMediaTimeScale(); dur = (*li)->getDuration(); size = (*li)->getOrigMediaSize(); ticks = (*li)->getVOPTimeIncrement(); input = (char*) (*li)->getInput(); isComplete = ( (*li)->getCompleteState() ? 1 : 0); codecId= (u32) (*li)->getCodecID(); quality= (*li)->getStreamQuality(); hasInput = true; if (!input) { input = new char[5]; strcpy(input, "NULL"); hasInput = false; } if((*li)->getFrameStatistic() && (*li)->getFrameStatistic()->getSize()>0) { stat=(*li)->getFrameStatistic()->toAsciiString(); } else { stat=new char[5]; strcpy(stat,"NULL"); } dprintf_small("Wrote:%u %u %u %s %u %u %u %s \r\n", tid, handlerType, decConfSize, decoderConfig, objectType, streamType, bufferSize, input); ++li; // increase list iterator // streamId handlerType decConfSize encodedDecoderConfig objectType // streamType bufferSize width height avg max time dur mediasize .... [<fileName_of_input>||null] \r\n oneLine[0] = 0; // dur is 64 bit -> split in two 32 bit valus -> higher 32 bit first sprintf(oneLine," %u %u %u %s %u %u %u %u %u %u %u %u %u %u %u %u %u %u %u %6.6f %6.6f %u %u %f %u %u %u %s \r\n", tid, handlerType, decConfSize, decoderConfig, objectType, streamType, bufferSize, width, height, avg, max, time, (u32) (dur >> 32), (u32) dur, size, ticks, hasColor, isComplete, codecId, quality, aspectRatio, gop_size,bFrames,bframesize,staticFramePattern, audioSampleRate, numChannels,input); len = strlen(oneLine); if (len != fwrite(oneLine, 1, len, file)) { fclose(file); #ifndef WINCE ::remove(indexName); #else DeleteFile((LPCTSTR)indexName); #endif delete [] oneLine; return false; } fprintf(file,"%s \r\n",stat); delete stat; stat=NULL; if (!hasInput) { delete input; input = NULL; } } fclose(file); delete [] oneLine; return true; } else { delete [] oneLine; return false; } }

---

Member Data Documentation

char* ContainerInfo::localFile [protected]

the local cache file. Can be null Definition at line 327 of file ContainerInfo.hpp. Referenced by ContainerInfo(), destroy(), getFileSize(), loadFromCfgFile(), and saveToCfgFile().

---

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

• ContainerInfo.hpp
• ContainerInfo.cpp

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